Additional settings

Receive additional shopper and transaction information in Standard notifications.


You can optionally receive more information about a shopper or transaction in your Standard notifications. When you enable an additional setting, you will receive the information as additionalData.

To configure which additional information you will receive:

  1. In your Customer Area, go to Account > Server Communication.
  2. Next to Standard Notification, click Edit & Test.
  3. Under Additional Settings, toggle which additional information you want to receive in your notifications.
  4. Click Save Configuration.

The additional settings you can toggle are described below.

Setting Description Fields included in additionalData
Add Acquirer Result

Receive Adyen's standardized mapping of the acquirer results for AVS and CVC checks.

  • referred
  • authCode
  • cvcResult
  • avsResult
Add Raw Acquirer Result

Receive the raw acquirer results for AVS and CVC checks.

  • acquirerCode
  • cvcResultRaw
  • avsResultRaw
  • refusalReasonRaw
HMAC Key (HEX Encoded)

Use this to generate a new HMAC key for your notifications. For more information on HMAC signatures, see Signing notifications with HMAC.

  • hmacSignatureKey
Include ARN Receive the Acquirer Reference Number. This can be used for reconciliation if Adyen Acquiring is not used for settlement.
  • arn
Include Acquirer Error Details Receive the details of errors sent by the Acquirer.
  • acquirerErrorCode
Include Acquirer Reference Receive the Acquirer Reference. This can be used for reconciliation when Adyen Acquiring is used for settlement.
  • acquirerReference
Include Alias Info Receive the alias of the shopper's credit card number.
  • alias
  • aliasType
Include Authorised Amount (dynamic zero auth) Receive the value of the authorisation amount of a Zero-value auth.
  • authorisedAmountValue
  • authorisedAmountCurrency
Include Bank Account Details Receive details of the shopper's bank account.
  • bankName
  • bankAccountNumber
  • bankLocationId
  • bic
  • countryCode
  • iban
  • ownerName
Include Capture Delay Hours Receive the number of hours remaining until the payment will be captured.
  • captureDelayHours
Include Card Bin Receive the Bank Identification Number of a credit card.
  • cardBin
Include Detailed Card Bin Information for Zero Auth Transactions

Receive information about zero value authorisations.

  • cardBin – The Bank Identification Number of a credit card
  • cardIssuingCurrency – The currency in which the card is issued, if available
  • cardIssuingBank – The issuing bank
  • cardPaymentMethod – The card payment method (for example, Visa or Mastercard)
  • cardIssuingCountry – The issuing country
  • fundingSourceInformation about the funding type of the card
Include Card Holder Receive the name of the cardholder.
  • cardHolderName
Include card info for recurring contract notifications Receive the card information that is used to create a recurring contract.
  • cardSummary
  • cardBin
  • expiryDate
  • cardHolderName
  • fundingSource
Receive information about co-branded cards.
  • coBrandedWith
Include Delivery Address

Receive the delivery address details of the shopper that were passed in the payment request. 

  • deliveryAddress.street
  • deliveryAddress.houseNumberOrName
  • deliveryAddress.city
  • deliveryAddress.postalCode
  • deliveryAddress.stateOrProvince
  • deliveryAddress.country
Include Device Type and Browser Information Receive information about the type of device and browser used by the shopper.
  • deviceType
  • browserCode
Include Extra Costs Receive information about additional costs that have been charged. This only applies to Dragonpay payments.
  • extraCostsValue
  • extraCostsCurrency
Include Funding Source

Receive additional information about the funding type when a card payment is made.

  • fundingSource

    Possible values:

    • CHARGE
    • CREDIT
    • DEBIT
    • PREPAID
    • DEFFERED_DEBIT
    • PREPAID_RELOADABLE
    • PREPAID_NONRELOADABLE
Include Installments info Receive the installment value for Mercado Pago payments.
  • installments.value
Include Issuer Country Receive the country where the card was issued. This is formatted in the ISO-3166 alpha-2 standard.
  • issuerCountry
Include Metadata in payment notification for 3D Secure payments (notifications are not sent from Pal)

Receive the metadata that you sent sent in the payment request for the 3D Secure payment.

Enabling this may cause a slight delay receiving notifications.

 
Include notes in manual review notifications Receive the notes added during manual review.
  • manualReviewNotes
Include the originalReference for CHARGEBACK_REVERSED notifications Receive the pspReference value assigned to the original payment to CHARGEBACK_REVERSED notifications.

no extra fields

Include PayPal Details

Receive the PayPal details of the shopper.

  • paypalEmail – The email address of the shopper's PayPal account
  • paypalPayerId – The shopper's PayPal Payer ID
  • paypalPayerStatus – Whether the shopper's account has been Verified by PayPal
  • paypalAddressStatus – Whether the shopper's address has been Confirmed by PayPal
  • paypalProtectionEligibility – Whether the payment is eligible for PayPal Seller Protection
  • paypalPayerResidenceCountryThe shopper's country of residence
Include PayULatam Details

Receive the trazability Code and the authorization Code of the sale. This only applies if PayULatam Acquiring is used for settlement.

  • payULatamTrazabilityCode
  • authCode
Include POS TerminalInfo Receive information about the POS terminal that processed the payment.
  • terminalId
Include Raw 3D Secure Details Result

Receive the 3D Secure authentication result. For more information about these fields, refer to ThreeDSecureData API reference.

  • xid– The transaction ID of the 3D Secure session. The value is Base64-encoded and is returned for transactions with a directoryResponse of N or Y.
  • cavv – The Cardholder Authentication Verification Value (CAVV) for the 3D Secure authentication session, as a Base64-encoded 20-byte array.
  • eci – The electronic commerce indicator (ECI). 
  • cavvAlgorithm – The CAVV algorithm used.
Include Raw 3D Secure Result Receive the raw 3D Secure authentication result from the card issuer.
  • threeDOfferedResponse
    A Boolean value indicating whether 3D Secure
    was offered for this payment.
  • threeDAuthenticatedResponse
    Possible values:
    • Y - Full Authentication.
    • N - No Authentication.
    • U - Authentication requests sent but is unable to be completed.
    • A - Authentication request sent successfully but the cardholder could not be authenticated.
Include Real Time Account Updater status

Receive the status of the Real Time Account Updater response.

  • realtimeAccountUpdaterStatus
    Possible values:
    • NoChange - The card details have not changed.
    • CardChanged - The card number has changed.
    • CardExpiryChanged - The card expiry has changed.
    • CloseAccount - The card has closed.
    • ContactCardAccountHolder - The card details have changed. Contact the card holder for the updated details.
Include the acquirer, acquirer account, raw response and response code of the (retry) attempts Receive information about the retries that Adyen is making.
  • retry.attemptN.acquirer
  • retry.attemptN.acquirerAccount
  • retry.attemptN.responseCode
  • retry.attemptN.rawResponse

Above, N is the sequence number of the retry attempt.

Include Risk Data

Receive the risk data that you submitted using additionalData. For more information on these fields, refer to Risk data fields.

  • riskdata
Include Risk Profile Receive information on the Risk Profile applied to the transaction. For more information on Risk Profiles, see Create and use risk profiles.
  • riskProfile
Include Shopper Country Receive the country of the shopper, as passed in the payment request. This is formatted using the ISO-3166 alpha-2 standard.
  • shopperCountry
Include Shopper Details Receive the details of the shopper you submitted using additionalData.
  • shopperEmail
  • shopperReference
  • shopperIp
  • shopperName
  • shopperStatement
  • shopperLocale
  • shopperTelephone
  • shopperSocialSecurityNumber
Include Shopper Interaction

Receive information on sales channel that processed the payment.

  • shopperInteraction
    Possible values:

    • Ecommerce
    • ContAuth
    • POS
    • Moto
Include SOAP Security Header Enable this if your notifications server requires a SOAP security header.

no extra fields

Include Store Receive the name of the store that submitted the payment.
  • store
Include Subvariant Receive the variant of the payment method used. For more information, see Payment Method Variant.
  • paymentMethodVariant
Include 3D Secure Result

Receive information about 3D Secure.

  • threeDOffered – Whether 3D Secure was offered for the payment.
  • threeDAuthenticated – Whether 3D Secure authentication was completed for the payment.
  • liabilityShift – Whether a liability shift was offered for the payment
Include Account Validation Flag

Receive information about whether the authorisation was made to validate the card, or to charge it.

  • accountValidation
    Possible values:

    • true – The authorisation was made to validate the card.
    • false – The authorisation was made to charge the card.
Include Avs Data/ Billing address Receive the shopper's billing address.
  • billingAddress.street
  • billingAddress.houseNumberOrName
  • billingAddress.city
  • billingAddress.postalCode
  • billingAddress.stateOrProvince
  • billingAddress.country

Example

The following example shows a Standard notification with Include capture delay hours and Include Alias Info enabled.

{
   "live":"false",
   "notificationItems":[
      {
         "NotificationRequestItem":{
            "additionalData":{
               "captureDelayHours":"72",
               "alias":"B181677540714335"
            },
            "amount":{
               "value":500,
               "currency":"EUR"
            },
            "pspReference":"9313547924770610",
            "eventCode":"AUTHORISATION",
            "eventDate":"2018-01-01T01:02:01.111+02:00",
            "merchantAccountCode":"TestMerchant",
            "operations":[
               "CANCEL",
               "CAPTURE",
               "REFUND"
            ],
            "merchantReference":"YourMerchantReference1",
            "paymentMethod":"visa",
            "reason":"58747:1111:12/2012",
            "success":"true"
         }
      }
   ]
}