{"title":"Additional settings","category":"default","creationDate":1760009820,"content":"

You can optionally receive more information about a transaction in your standard webhooks. You receive this information as additionalData<\/code> included in the webhook<\/a>.<\/p>\n

To enable receiving this additional information:<\/p>\n

    \n
  1. In your Customer Area<\/a>, go to Developers<\/strong>\u00a0>\u00a0 Webhooks<\/strong>.<\/li>\n
  2. From the list of webhooks, select the one to configure.<\/li>\n
  3. Select Edit webhook<\/strong> or the edit icon <\/i>.<\/li>\n
  4. Some webhooks have optional additional settings. If available, under Additional Settings<\/strong>, select the checkboxes for the additional information to include in the webhook.<\/li>\n
  5. Select Save configuration<\/strong>.<\/li>\n<\/ol>\n

    You can receive the following information:<\/p>\n\n \n \n \n \n <\/colgroup>\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n <\/tr>\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
    Setting<\/th>\n Description<\/th>\n \n Fields included in\n additionalData<\/code>\n <\/th>\n <\/tr>\n <\/thead>\n
    \n

    Add Acquirer Result<\/p>\n<\/td>\n

    		\n

    \n Receive Adyen's standardized mapping of the acquirer results for\n AVS<\/a>\n and\n CVC<\/a>\n checks.\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n

      referred<\/code><\/p>\n<\/li>\n

    • \n

      authCode<\/code><\/p>\n<\/li>\n

    • \n

      cvcResult<\/code><\/p>\n<\/li>\n

    • \n

      avsResult<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Add Payment Account Reference<\/p>\n<\/td>\n

    		\n

    \n Receive the Payment Account Reference (PAR)<\/a> to link transactions from the same account across wallets like visa-applepay<\/code> and visa<\/code>.

    		\n
      \n
    • \n

      PaymentAccountReference<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Add Raw Acquirer Result<\/p>\n<\/td>\n

    		\n

    \n Receive the raw acquirer results for\n AVS<\/a>\n and\n CVC<\/a>\n checks.\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n

      acquirerCode<\/code><\/p>\n<\/li>\n

    • \n

      cvcResultRaw<\/code><\/p>\n<\/li>\n

    • \n

      avsResultRaw<\/code><\/p>\n<\/li>\n

    • \n

      refusalReasonRaw<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    HMAC Key (HEX Encoded)<\/p>\n<\/td>\n

    		\n

    \n Use this to generate a new HMAC key for your webhook events. For more information on HMAC signatures, see\n Verify HMAC signatures<\/a>\n .\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n

      hmacSignatureKey<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include ARN<\/p>\n<\/td>\n

    		\n Receive the\n Acquirer Reference Number<\/a> (ARN)\n . This can be used for reconciliation if Adyen Acquiring\n is<\/strong>\n not<\/strong>\n used for settlement. The ARN is only returned in CAPTURE and REFUND webhook events.\n <\/td>\n \n
      \n
    • \n

      arn<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Acquirer Error Details<\/p>\n<\/td>\n

    		\n Receive the details of errors sent by the\n Acquirer<\/a>\n .\n <\/td>\n \n
      \n
    • \n

      acquirerErrorCode<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Acquirer Reference<\/p>\n<\/td>\n

    		\n Receive the\n Acquirer Reference<\/a>\n . This can be used for reconciliation when Adyen Acquiring is used for settlement.\n <\/td>\n \n
      \n
    • \n

      acquirerReference<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Alias Info<\/p>\n<\/td>\n

    		\n Receive the\n alias<\/a>\n of the shopper's credit card number.\n <\/td>\n \n
      \n
    • \n

      alias<\/code><\/p>\n<\/li>\n

    • \n

      aliasType<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Authorised Amount (dynamic zero auth)<\/p>\n<\/td>\n

    		\n Receive the value of the authorisation amount of a\n Zero-value auth<\/a>\n .\n <\/td>\n \n
      \n
    • \n

      authorisedAmountValue<\/code><\/p>\n<\/li>\n

    • \n

      authorisedAmountCurrency<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Bank Account Details<\/p>\n<\/td>\n

    		\n

    Receive details of the shopper's bank account.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      bankName<\/code><\/p>\n<\/li>\n

    • \n

      bankAccountNumber<\/code><\/p>\n<\/li>\n

    • \n

      bankLocationId<\/code><\/p>\n<\/li>\n

    • \n

      bic<\/code><\/p>\n<\/li>\n

    • \n

      countryCode<\/code><\/p>\n<\/li>\n

    • \n

      iban<\/code><\/p>\n<\/li>\n

    • \n

      ownerName<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Capture Delay Hours<\/p>\n<\/td>\n

    		\n

    Receive the number of hours remaining until the payment will be captured.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      captureDelayHours<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Card Bin<\/p>\n<\/td>\n

    		\n Receive the\n Bank Identification Number<\/a>\n of a credit card.\n <\/td>\n \n
      \n
    • \n

      cardBin<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include detailed Card Bin information<\/p>\n<\/td>\n

    		\n

    \n Receive information about card transactions, including\n zero value authorisations<\/a>.\n <\/p>\n <\/td>\n

    		\n
    \n

    Include Card Holder<\/p>\n<\/td>\n

    		\n Receive the name of the\n cardholder<\/a>\n .\n <\/td>\n \n
      \n
    • \n

      cardHolderName<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include card info for recurring contract webhook events<\/p>\n<\/td>\n

    		\n

    Receive the card information that is used to create a recurring contract.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      cardSummary<\/code><\/p>\n<\/li>\n

    • \n

      cardBin<\/code><\/p>\n<\/li>\n

    • \n

      expiryDate<\/code><\/p>\n<\/li>\n

    • \n

      cardHolderName<\/code><\/p>\n<\/li>\n

    • \n

      fundingSource<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include the co-brand card information<\/p>\n<\/td>\n

    		\n

    Receive information about co-badged cards.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      coBrandedWith<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include the bin and summary information for network tokens in the case of tokenized payments.<\/p>\n<\/td>\n

    		\n

    Receive the BIN of the network token and the last four digits of the network token.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      networkToken.tokenSummary<\/code><\/p>\n<\/li>\n

    • \n

      networkToken.bin<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td><\/tr>\n

    \n

    Include contactless wallet token information<\/p>\n<\/td>\n

    		\n

    Receive information about the digital wallet used, as well as the untokenised card summary.

    To receive the token variant for point-of-sale transactions, this must also be enabled under Developers<\/b> > Additional data<\/b>.<\/div><\/div><\/p>\n<\/td>\n
    		\n
      \n
    • \n

      tokenTxVariant<\/code><\/p>\n<\/li>\n

    • \n

      untokenisedCardSummary<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Delivery Address<\/p>\n<\/td>\n

    		\n

    Receive the delivery address details of the shopper that were passed in the payment request. <\/p>\n<\/td>\n

    		\n
      \n
    • \n

      deliveryAddress.street<\/code><\/p>\n<\/li>\n

    • \n

      deliveryAddress.houseNumberOrName<\/code><\/p>\n<\/li>\n

    • \n

      deliveryAddress.city<\/code><\/p>\n<\/li>\n

    • \n

      deliveryAddress.postalCode<\/code><\/p>\n<\/li>\n

    • \n

      deliveryAddress.stateOrProvince<\/code><\/p>\n<\/li>\n

    • \n

      deliveryAddress.country<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Device Type and Browser Information <\/a><\/p>\n<\/td>\n

    		\n

    Receive information about the type of device and browser used by the shopper.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      deviceType<\/code><\/p>\n<\/li>\n

    • \n

      browserCode<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Extra Costs<\/p>\n<\/td>\n

    		\n

    Receive information about additional costs that have been charged. This only applies to Dragonpay payments.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      extraCostsValue<\/code><\/p>\n<\/li>\n

    • \n

      extraCostsCurrency<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Funding Source<\/p>\n<\/td>\n

    		\n

    Receive additional information about the funding type when a card payment is made.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      \n fundingSource<\/code>\n
      \n <\/p>\n

      Possible values:<\/p>\n

        \n
      • \n

        CHARGED<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        CREDIT<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        DEBIT<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        PREPAID<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        DEFFERED_DEBIT<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        PREPAID_RELOADABLE<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        PREPAID_NONRELOADABLE<\/strong><\/span><\/p>\n<\/li>\n <\/ul>\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Installments info<\/p>\n<\/td>\n

    		\n

    Receive the installment value for Mercado Pago payments and Klarna Pay Over Time.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      installments.value<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Issuer country\/region<\/p>\n<\/td>\n

    		\n

    Receive the country\/region where the card was issued.
    Format: the two-letter ISO-3166-1 alpha-2<\/a> country code. Exception: QZ<\/strong> (Kosovo).<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      issuerCountry<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Metadata in payment webhook for 3D Secure payments (webhooks are not sent from Pal)<\/p>\n<\/td>\n

    		\n

    \n Receive the metadata that you sent in the payment request for the\n 3D Secure<\/a>\n payment.\n <\/p>\n

    		\n\n<\/td>\n <\/tr>\n
    \n

    Include notes in manual review webhooks<\/p>\n<\/td>\n

    		\n Receive the notes added during\n manual review<\/a>\n .\n <\/td>\n \n
      \n
    • \n

      manualReviewNotes<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include the originalReference for CHARGEBACK_REVERSED webhook events<\/p>\n<\/td>\n

    		\n For\n CHARGEBACK_REVERSED<\/a>\n webhook events, receive the\n pspReference<\/code>\n of the original payment.\n <\/td>\n \n

    no extra fields<\/p>\n<\/td>\n <\/tr>\n

    \n

    Include PayPal Details<\/p>\n<\/td>\n

    		\n

    Receive the PayPal details of the shopper.<\/p>\n<\/td>\n

    		\n
      \n
    • \n paypalEmail<\/code>\n \u2013 The email address of the shopper's PayPal account\n <\/li>\n
    • \n paypalPayerId<\/code>\n \u2013 The shopper's PayPal Payer ID\n <\/li>\n
    • \n paypalPayerStatus<\/code>\n \u2013 Whether the shopper's account has been Verified by PayPal\n <\/li>\n
    • \n paypalAddressStatus<\/code>\n \u2013 Whether the shopper's address has been Confirmed by PayPal\n <\/li>\n
    • \n paypalProtectionEligibility<\/code>\n \u2013 Whether the payment is eligible for PayPal Seller Protection\n <\/li>\n
    • \n paypalPayerResidenceCountry<\/code>\n \u2013 The shopper's country\/region of residence\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n
    \n

    Include PayULatam Details<\/p>\n<\/td>\n

    		\n

    Receive the traceability code and the authorization code of the sale. This only applies if PayULatam Acquiring is used for settlement.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      payULatamTrazabilityCode<\/code><\/p>\n<\/li>\n

    • \n

      authCode<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include POS Details<\/p>\n<\/td>\n

    		\n

    Receive the tender reference of the transaction, and the POIID of the payment terminal that processed the payment. This information is useful for reconciling and refunding offline payments<\/a>.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      tenderReference<\/code><\/p>\n<\/li>\n

    • \n

      terminalId<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include POS TerminalInfo<\/p>\n<\/td>\n

    		\n

    Receive the POIID of the payment terminal that processed the payment.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      terminalId<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Raw 3D Secure Details Result<\/p>\n<\/td>\n

    		\n

    \n Receive the\n 3D Secure<\/a>\n authentication result.\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n xid<\/code>\n \u2013 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.\n <\/li>\n
    • \n cavv<\/code>\n \u2013 The Cardholder Authentication Verification Value (CAVV) for the 3D Secure authentication session, as a Base64-encoded 20-byte array.\n <\/li>\n
    • \n eci<\/code>\n \u2013 The electronic commerce indicator (ECI).\n <\/li>\n
    • \n cavvAlgorithm<\/code>\n \u2013 The CAVV algorithm used.\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n
    \n

    Include Raw 3D Secure Result<\/p>\n<\/td>\n

    		\n Receive the\n raw 3D Secure authentication result<\/a>\n from the card issuer.\n <\/td>\n \n
      \n
    • \n threeDOfferedResponse<\/code>\n
      \n The raw enrollment result from the 3D Secure directory services of the card schemes.\n <\/li>\n
    • \n threeDAuthenticatedResponse<\/code>\n
      \n Possible values:\n
        \n
      • \n Y<\/strong><\/span>\n - Full Authentication.\n <\/li>\n
      • \n N<\/strong><\/span>\n - No Authentication.\n <\/li>\n
      • \n U<\/strong><\/span>\n - Authentication requests sent but is unable to be completed.\n <\/li>\n
      • \n A<\/strong><\/span>\n - Authentication request sent successfully but the cardholder could not be authenticated.\n <\/li>\n <\/ul>\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n
    \n

    Include Real Time Account Updater status<\/p>\n<\/td>\n

    		\n

    \n Receive the status of the\n Real Time Account Updater<\/a>\n response.\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n realtimeAccountUpdaterStatus<\/code>\n
      \n Possible values:\n
      \n
        \n
      • \n NoChange<\/strong><\/span>\n - The card details have not changed.\n <\/li>\n
      • \n CardChanged<\/strong><\/span>\n - The card number has changed.\n <\/li>\n
      • \n CardExpiryChanged<\/strong><\/span>\n - The card expiry has changed.\n <\/li>\n
      • \n CloseAccount<\/strong><\/span>\n - The card has closed.\n <\/li>\n
      • \n ContactCardAccountHolder<\/strong><\/span>\n - The card details have changed. Contact the cardholder for the updated details.\n <\/li>\n <\/ul>\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n
    \n

    Include the acquirer, acquirer account, raw response and response code of the (retry) attempts<\/p>\n<\/td>\n

    		\n

    Receive information about the retries that Adyen is making.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      retry.attemptN.acquirer<\/code><\/p>\n<\/li>\n

    • \n

      retry.attemptN.acquirerAccount<\/code><\/p>\n<\/li>\n

    • \n

      retry.attemptN.responseCode<\/code><\/p>\n<\/li>\n

    • \n

      retry.attemptN.rawResponse<\/code><\/p>\n<\/li>\n <\/ul>\n

      \n Above,\n N<\/code>\n is the sequence number of the retry attempt.\n <\/p>\n <\/td>\n <\/tr>\n

    \n

    Include Risk Data<\/p>\n<\/td>\n

    		\n

    \n Receive the risk data that you submitted using\n additionalData<\/code>\n . For more information on these fields, refer to\n Risk data fields<\/a>\n .\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n

      riskdata<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Risk Profile<\/p>\n<\/td>\n

    		\n Receive information on the Risk Profile applied to the transaction. For more information on Risk Profiles, see\n Create and use risk profiles<\/a>\n .\n <\/td>\n \n
      \n
    • \n

      riskProfile<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Shopper Country\/region<\/p>\n<\/td>\n

    		\n Receive the country\/region of the shopper, as passed in the payment request.
    Format: the two-letter ISO-3166-1 alpha-2<\/a> country code. Exception: **QZ** (Kosovo).\n standard.\n <\/td>\n     		\n
      \n
    • \n

      shopperCountry<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Shopper Details<\/p>\n<\/td>\n

    		\n Receive the details of the shopper you submitted using\n additionalData<\/code>\n .\n <\/td>\n \n
      \n
    • \n

      shopperEmail<\/code><\/p>\n<\/li>\n

    • \n

      shopperReference<\/code><\/p>\n<\/li>\n

    • \n

      shopperIp<\/code><\/p>\n<\/li>\n

    • \n

      shopperName<\/code><\/p>\n<\/li>\n

    • \n

      shopperStatement<\/code><\/p>\n<\/li>\n

    • \n

      shopperLocale<\/code><\/p>\n<\/li>\n

    • \n

      shopperTelephone<\/code><\/p>\n<\/li>\n

    • \n

      shopperSocialSecurityNumber<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Shopper Interaction<\/p>\n<\/td>\n

    		\n

    Receive information on sales channel that processed the payment.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      \n shopperInteraction<\/code>\n
      \n Possible values:\n <\/p>\n

        \n
      • \n

        Ecommerce<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        ContAuth<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        POS<\/strong><\/span><\/p>\n<\/li>\n

      • \n

        Moto<\/strong><\/span><\/p>\n<\/li>\n <\/ul>\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include SOAP Security Header<\/p>\n<\/td>\n

    		\n

    Enable this if your webhook server requires a SOAP security header.<\/p>\n<\/td>\n

    		\n

    no extra fields<\/p>\n<\/td>\n <\/tr>\n

    \n

    Include Store<\/p>\n<\/td>\n

    		\n

    Receive the name of the store that submitted the payment.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      store<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include Subvariant<\/p>\n<\/td>\n

    		\n Receive the variant of the payment method used. For more information, see\n Payment Method Variant<\/a>.\n <\/td>\n \n
      \n
    • \n

      paymentMethodVariant<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

    \n

    Include 3D Secure Result<\/p>\n<\/td>\n

    		\n

    \n Receive information about\n 3D Secure<\/a>\n .\n <\/p>\n <\/td>\n

    		\n
      \n
    • \n threeDOffered<\/code>\n \u2013 Whether 3D Secure was triggered for the payment.\n <\/li>\n
    • \n threeDAuthenticated<\/code>\n \u2013 Whether 3D Secure authentication was completed for the payment.\n <\/li>\n
    • \n liabilityShift<\/code>\n \u2013 Whether a liability shift was offered for the payment\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n
    \n

    Include Account Validation Flag<\/p>\n<\/td>\n

    		\n

    Receive information about whether the authorisation was made to validate the card, or to charge it.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      \n accountValidation<\/code>\n
      \n Possible values:\n <\/p>\n

        \n
      • \n true<\/strong><\/span>\n \u2013 The authorisation was made to validate the card.\n <\/li>\n
      • \n false<\/strong><\/span>\n \u2013 The authorisation was made to charge the card.\n <\/li>\n <\/ul>\n <\/li>\n <\/ul>\n <\/td>\n <\/tr>\n
    \n

    Include Avs Data\/ Billing address<\/p>\n<\/td>\n

    		\n

    Receive the shopper's billing address.<\/p>\n<\/td>\n

    		\n
      \n
    • \n

      billingAddress.street<\/code><\/p>\n<\/li>\n

    • \n

      billingAddress.houseNumberOrName<\/code><\/p>\n<\/li>\n

    • \n

      billingAddress.city<\/code><\/p>\n<\/li>\n

    • \n

      billingAddress.postalCode<\/code><\/p>\n<\/li>\n

    • \n

      billingAddress.stateOrProvince<\/code><\/p>\n<\/li>\n

    • \n

      billingAddress.country<\/code><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n <\/tbody>\n<\/table>\n

      Example<\/h3>\n

      The additional data fields you enable appear in the additionalData<\/code> object of the webhook. The specific fields depend on which settings you select.<\/p>\n

      The following example shows a standard webhook with Include capture delay hours<\/strong> and Include Alias Info<\/strong> enabled.<\/p>\n

      {\n   \"live\":\"false\",\n   \"notificationItems\":[\n      {\n         \"NotificationRequestItem\":{\n            \"additionalData\":{\n               \"captureDelayHours\":\"72\",\n               \"alias\":\"B181677540714335\"\n            },\n            \"amount\":{\n               \"value\":500,\n               \"currency\":\"EUR\"\n            },\n            \"pspReference\":\"9313547924770610\",\n            \"eventCode\":\"AUTHORISATION\",\n            \"eventDate\":\"2018-01-01T01:02:01.111+02:00\",\n            \"merchantAccountCode\":\"YOUR_MERCHANT_ACCOUNT\",\n            \"operations\":[\n               \"CANCEL\",\n               \"CAPTURE\",\n               \"REFUND\"\n            ],\n            \"merchantReference\":\"YourMerchantReference1\",\n            \"paymentMethod\":\"visa\",\n            \"reason\":\"58747:1111:12\/2012\",\n            \"success\":\"true\"\n         }\n      }\n   ]\n}<\/code><\/pre>","url":"https:\/\/docs.adyen.com\/development-resources\/webhooks\/webhook-types\/additional-settings","articleFields":{"description":"Receive additional shopper and transaction information in standard webhooks.","id":"36183971","type":"page","_expandable":{"operations":""},"status":"current","last_edit_on":"09-10-2025 13:37","feedback_component":true,"filters_component":false,"decision_tree":"[]","page_id":"3f16b179-cbec-4510-9070-c8c307dd9b45"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/webhooks\/webhook-types\/additional-settings","title":"Additional settings","content":"You can optionally receive more information about a transaction in your standard webhooks. You receive this information as additionalData included in the webhook.\nTo enable receiving this additional information:\n\nIn your Customer Area, go to Developers\u00a0>\u00a0 Webhooks.\nFrom the list of webhooks, select the one to configure.\nSelect Edit webhook or the edit icon .\nSome webhooks have optional additional settings. If available, under Additional Settings, select the checkboxes for the additional information to include in the webhook.\nSelect Save configuration.\n\nYou can receive the following information:\n\n   \n      \n      \n      \n   \n   \n      \n         Setting\n         Description\n         \n            Fields included in\n            additionalData\n         \n      \n   \n   \n      \n         \nAdd Acquirer Result\n\n         \n            \n               Receive Adyen's standardized mapping of the acquirer results for\n               AVS\n               and\n               CVC\n               checks.\n            \n         \n         \n            \n               \nreferred\n\n               \nauthCode\n\n               \ncvcResult\n\n               \navsResult\n\n            \n         \n      \n       \n         \nAdd Payment Account Reference\n\n         \n            \n               Receive the Payment Account Reference (PAR) to link transactions from the same account across wallets like visa-applepay and visa.To receive the PAR for point-of-sale transactions, this must also be enabled under Developers > Additional data.\n            \n         \n         \n            \n               \nPaymentAccountReference\n\n            \n         \n      \n      \n         \nAdd Raw Acquirer Result\n\n         \n            \n               Receive the raw acquirer results for\n               AVS\n               and\n               CVC\n               checks.\n            \n         \n         \n            \n               \nacquirerCode\n\n               \ncvcResultRaw\n\n               \navsResultRaw\n\n               \nrefusalReasonRaw\n\n            \n         \n      \n      \n         \nHMAC Key (HEX Encoded)\n\n         \n            \n               Use this to generate a new HMAC key for your webhook events. For more information on HMAC signatures, see\n               Verify HMAC signatures\n               .\n            \n         \n         \n            \n               \nhmacSignatureKey\n\n            \n         \n      \n      \n         \nInclude ARN\n\n         \n            Receive the\n            Acquirer Reference Number (ARN)\n            . This can be used for reconciliation if Adyen Acquiring\n            is\n            not\n            used for settlement. The ARN is only returned in CAPTURE and REFUND webhook events.\n         \n         \n            \n               \narn\n\n            \n         \n      \n      \n         \nInclude Acquirer Error Details\n\n         \n            Receive the details of errors sent by the\n            Acquirer\n            .\n         \n         \n            \n               \nacquirerErrorCode\n\n            \n         \n      \n      \n         \nInclude Acquirer Reference\n\n         \n            Receive the\n            Acquirer Reference\n            . This can be used for reconciliation when Adyen Acquiring is used for settlement.\n         \n         \n            \n               \nacquirerReference\n\n            \n         \n      \n      \n         \nInclude Alias Info\n\n         \n            Receive the\n            alias\n            of the shopper's credit card number.\n         \n         \n            \n               \nalias\n\n               \naliasType\n\n            \n         \n      \n      \n         \nInclude Authorised Amount (dynamic zero auth)\n\n         \n            Receive the value of the authorisation amount of a\n            Zero-value auth\n            .\n         \n         \n            \n               \nauthorisedAmountValue\n\n               \nauthorisedAmountCurrency\n\n            \n         \n      \n      \n         \nInclude Bank Account Details\n\n         \nReceive details of the shopper's bank account.\n\n         \n            \n               \nbankName\n\n               \nbankAccountNumber\n\n               \nbankLocationId\n\n               \nbic\n\n               \ncountryCode\n\n               \niban\n\n               \nownerName\n\n            \n         \n      \n      \n         \nInclude Capture Delay Hours\n\n         \nReceive the number of hours remaining until the payment will be captured.\n\n         \n            \n               \ncaptureDelayHours\n\n            \n         \n      \n      \n         \nInclude Card Bin\n\n         \n            Receive the\n            Bank Identification Number\n             of a credit card.\n         \n         \n            \n               \ncardBin\n\n            \n         \n      \n      \n         \nInclude detailed Card Bin information\n\n         \n            \n               Receive information about card transactions, including\n               zero value authorisations.\n            \n         \n         \n            \n               \n                  cardBin\n                  \u2013 The\n                  Bank Identification Number\n                  of a credit card\n               \n               \n                  cardIssuingCurrency\n                  \u2013 The currency in which the card is issued, if available\n               \n               \n                  cardIssuingBank\n                  \u2013 The issuing bank\n               \n               \n                  cardPaymentMethod\n                  \u2013 The card payment method (for example, Visa or Mastercard)\n               \n               \n                  cardIssuingCountry\n                  \u2013 The issuing country\/region\n               \n               \n                  fundingSource\n                  \u2013 Information about the funding type of the card\n               \n               \n                  isCardCommercial\n                  \u2013 Whether the card is a commercial card\n               \n            \n         \n      \n      \n         \nInclude Card Holder\n\n         \n            Receive the name of the\n            cardholder\n            .\n         \n         \n            \n               \ncardHolderName\n\n            \n         \n      \n      \n         \nInclude card info for recurring contract webhook events\n\n         \nReceive the card information that is used to create a recurring contract.\n\n         \n            \n               \ncardSummary\n\n               \ncardBin\n\n               \nexpiryDate\n\n               \ncardHolderName\n\n               \nfundingSource\n\n            \n         \n      \n      \n         \nInclude the co-brand card information\n\n         \nReceive information about co-badged cards.\n\n         \n            \n               \ncoBrandedWith\n\n            \n         \n      \n      \n         \nInclude the bin and summary information for network tokens in the case of tokenized payments.\n\n         \nReceive the BIN of the network token and the last four digits of the network token.\n\n         \n            \n               \nnetworkToken.tokenSummary\n\n               \nnetworkToken.bin\n\n            \n      \n      \n         \nInclude contactless wallet token information\n\n         \nReceive information about the digital wallet used, as well as the untokenised card summary.To receive the token variant for point-of-sale transactions, this must also be enabled under Developers > Additional data.\n\n         \n            \n               \ntokenTxVariant\n\n               \nuntokenisedCardSummary\n\n            \n         \n      \n      \n      \n         \nInclude Delivery Address\n\n         \nReceive the delivery address details of the shopper that were passed in the payment request. \n\n         \n            \n               \ndeliveryAddress.street\n\n               \ndeliveryAddress.houseNumberOrName\n\n               \ndeliveryAddress.city\n\n               \ndeliveryAddress.postalCode\n\n               \ndeliveryAddress.stateOrProvince\n\n               \ndeliveryAddress.country\n\n            \n         \n      \n      \n         \nInclude Device Type and Browser Information \n\n         \nReceive information about the type of device and browser used by the shopper.\n\n         \n            \n               \ndeviceType\n\n               \nbrowserCode\n\n            \n         \n      \n      \n         \nInclude Extra Costs\n\n         \nReceive information about additional costs that have been charged. This only applies to Dragonpay payments.\n\n         \n            \n               \nextraCostsValue\n\n               \nextraCostsCurrency\n\n            \n         \n      \n      \n         \nInclude Funding Source\n\n         \nReceive additional information about the funding type when a card payment is made.\n\n         \n            \n               \n                  \n                     fundingSource\n                     \n                  \n                  Possible values:\n                  \n                     \nCHARGED\n\n                     \nCREDIT\n\n                     \nDEBIT\n\n                     \nPREPAID\n\n                     \nDEFFERED_DEBIT\n\n                     \nPREPAID_RELOADABLE\n\n                     \nPREPAID_NONRELOADABLE\n\n                  \n               \n            \n         \n      \n      \n         \nInclude Installments info\n\n         \nReceive the installment value for Mercado Pago payments and Klarna Pay Over Time.\n\n         \n            \n               \ninstallments.value\n\n            \n         \n      \n      \n         \nInclude Issuer country\/region\n\n         \nReceive the country\/region where the card was issued. Format: the two-letter ISO-3166-1 alpha-2 country code. Exception: QZ (Kosovo).\n\n         \n            \n               \nissuerCountry\n\n            \n         \n      \n      \n         \nInclude Metadata in payment webhook for 3D Secure payments (webhooks are not sent from Pal)\n\n         \n            \n               Receive the metadata that you sent in the payment request for the\n               3D Secure\n               payment.\n            \n            \n            Enabling this may cause a slight delay receiving webhooks.\n            \n         \n         \n\n\n      \n      \n         \nInclude notes in manual review webhooks\n\n         \n            Receive the notes added during\n            manual review\n            .\n         \n         \n            \n               \nmanualReviewNotes\n\n            \n         \n      \n      \n         \nInclude the originalReference for CHARGEBACK_REVERSED webhook events\n\n         \n            For\n            CHARGEBACK_REVERSED\n            webhook events, receive the\n            pspReference\n            of the original payment.\n         \n         \nno extra fields\n\n      \n      \n         \nInclude PayPal Details\n\n         \nReceive the PayPal details of the shopper.\n\n         \n            \n               \n                  paypalEmail\n                  \u2013 The email address of the shopper's PayPal account\n               \n               \n                  paypalPayerId\n                  \u2013 The shopper's PayPal Payer ID\n               \n               \n                  paypalPayerStatus\n                  \u2013 Whether the shopper's account has been Verified by PayPal\n               \n               \n                  paypalAddressStatus\n                  \u2013 Whether the shopper's address has been Confirmed by PayPal\n               \n               \n                  paypalProtectionEligibility\n                  \u2013 Whether the payment is eligible for PayPal Seller Protection\n               \n               \n                  paypalPayerResidenceCountry\n                  \u2013 The shopper's country\/region of residence\n               \n            \n         \n      \n      \n         \nInclude PayULatam Details\n\n         \nReceive the traceability code and the authorization code of the sale. This only applies if PayULatam Acquiring is used for settlement.\n\n         \n            \n               \npayULatamTrazabilityCode\n\n               \nauthCode\n\n            \n         \n      \n      \n         \nInclude POS Details\n\n         \nReceive the tender reference of the transaction, and the POIID of the payment terminal that processed the payment. This information is useful for reconciling and refunding offline payments.\n\n         \n            \n              \ntenderReference\n\n              \nterminalId\n\n            \n         \n      \n      \n         \nInclude POS TerminalInfo\n\n         \nReceive the POIID of the payment terminal that processed the payment.\n\n         \n            \n               \nterminalId\n\n            \n         \n      \n      \n         \nInclude Raw 3D Secure Details Result\n\n         \n            \n               Receive the\n               3D Secure\n               authentication result.\n            \n         \n         \n            \n               \n                  xid\n                  \u2013 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.\n               \n               \n                  cavv\n                  \u2013 The Cardholder Authentication Verification Value (CAVV) for the 3D Secure authentication session, as a Base64-encoded 20-byte array.\n               \n               \n                  eci\n                  \u2013 The electronic commerce indicator (ECI).\n               \n               \n                  cavvAlgorithm\n                  \u2013 The CAVV algorithm used.\n               \n            \n         \n      \n      \n         \nInclude Raw 3D Secure Result\n\n         \n            Receive the\n            raw 3D Secure authentication result\n            from the card issuer.\n         \n         \n            \n               \n                  threeDOfferedResponse\n                  \n                  The raw enrollment result from the 3D Secure directory services of the card schemes.\n               \n               \n                  threeDAuthenticatedResponse\n                  \n                  Possible values:\n                  \n                     \n                        Y\n                        - Full Authentication.\n                     \n                     \n                        N\n                        - No Authentication.\n                     \n                     \n                        U\n                        - Authentication requests sent but is unable to be completed.\n                     \n                     \n                        A\n                        - Authentication request sent successfully but the cardholder could not be authenticated.\n                     \n                  \n               \n            \n         \n      \n      \n         \nInclude Real Time Account Updater status\n\n         \n            \n               Receive the status of the\n               Real Time Account Updater\n               response.\n            \n         \n         \n            \n               \n                  realtimeAccountUpdaterStatus\n                  \n                  Possible values:\n                  \n                  \n                     \n                        NoChange\n                        - The card details have not changed.\n                     \n                     \n                        CardChanged\n                        - The card number has changed.\n                     \n                     \n                        CardExpiryChanged\n                        - The card expiry has changed.\n                     \n                     \n                        CloseAccount\n                        - The card has closed.\n                     \n                     \n                        ContactCardAccountHolder\n                        - The card details have changed. Contact the cardholder for the updated details.\n                     \n                  \n               \n            \n         \n      \n      \n         \nInclude the acquirer, acquirer account, raw response and response code of the (retry) attempts\n\n         \nReceive information about the retries that Adyen is making.\n\n         \n            \n               \nretry.attemptN.acquirer\n\n               \nretry.attemptN.acquirerAccount\n\n               \nretry.attemptN.responseCode\n\n               \nretry.attemptN.rawResponse\n\n            \n            \n               Above,\n               N\n               is the sequence number of the retry attempt.\n            \n         \n      \n      \n         \nInclude Risk Data\n\n         \n            \n               Receive the risk data that you submitted using\n               additionalData\n               . For more information on these fields, refer to\n               Risk data fields\n               .\n            \n         \n         \n            \n               \nriskdata\n\n            \n         \n      \n      \n         \nInclude Risk Profile\n\n         \n            Receive information on the Risk Profile applied to the transaction. For more information on Risk Profiles, see\n            Create and use risk profiles\n            .\n         \n         \n            \n               \nriskProfile\n\n            \n         \n      \n      \n         \nInclude Shopper Country\/region\n\n         \n            Receive the country\/region of the shopper, as passed in the payment request. Format: the two-letter ISO-3166-1 alpha-2 country code. Exception: **QZ** (Kosovo).\n            standard.\n         \n         \n            \n               \nshopperCountry\n\n            \n         \n      \n      \n         \nInclude Shopper Details\n\n         \n            Receive the details of the shopper you submitted using\n            additionalData\n            .\n         \n         \n            \n               \nshopperEmail\n\n               \nshopperReference\n\n               \nshopperIp\n\n               \nshopperName\n\n               \nshopperStatement\n\n               \nshopperLocale\n\n               \nshopperTelephone\n\n               \nshopperSocialSecurityNumber\n\n            \n         \n      \n      \n         \nInclude Shopper Interaction\n\n         \nReceive information on sales channel that processed the payment.\n\n         \n            \n               \n                  \n                     shopperInteraction\n                     \n                     Possible values:\n                  \n                  \n                     \nEcommerce\n\n                     \nContAuth\n\n                     \nPOS\n\n                     \nMoto\n\n                  \n               \n            \n         \n      \n      \n         \nInclude SOAP Security Header\n\n         \nEnable this if your webhook server requires a SOAP security header.\n\n         \nno extra fields\n\n      \n      \n         \nInclude Store\n\n         \nReceive the name of the store that submitted the payment.\n\n         \n            \n               \nstore\n\n            \n         \n      \n      \n         \nInclude Subvariant\n\n         \n            Receive the variant of the payment method used. For more information, see\n            Payment Method Variant.\n         \n         \n            \n               \npaymentMethodVariant\n\n            \n         \n      \n      \n         \nInclude 3D Secure Result\n\n         \n            \n               Receive information about\n               3D Secure\n               .\n            \n         \n         \n            \n               \n                  threeDOffered\n                  \u2013 Whether 3D Secure was triggered for the payment.\n               \n               \n                  threeDAuthenticated\n                  \u2013 Whether 3D Secure authentication was completed for the payment.\n               \n               \n                  liabilityShift\n                  \u2013 Whether a liability shift was offered for the payment\n               \n            \n         \n      \n      \n         \nInclude Account Validation Flag\n\n         \nReceive information about whether the authorisation was made to validate the card, or to charge it.\n\n         \n            \n               \n                  \n                     accountValidation\n                     \n                     Possible values:\n                  \n                  \n                     \n                        true\n                        \u2013 The authorisation was made to validate the card.\n                     \n                     \n                        false\n                        \u2013 The authorisation was made to charge the card.\n                     \n                  \n               \n            \n         \n      \n      \n         \nInclude Avs Data\/ Billing address\n\n         \nReceive the shopper's billing address.\n\n         \n            \n               \nbillingAddress.street\n\n               \nbillingAddress.houseNumberOrName\n\n               \nbillingAddress.city\n\n               \nbillingAddress.postalCode\n\n               \nbillingAddress.stateOrProvince\n\n               \nbillingAddress.country\n\n            \n         \n      \n   \n\nExample\nThe additional data fields you enable appear in the additionalData object of the webhook. The specific fields depend on which settings you select.\nThe following example shows a standard webhook with Include capture delay hours and Include Alias Info enabled.\n{\n   \"live\":\"false\",\n   \"notificationItems\":[\n      {\n         \"NotificationRequestItem\":{\n            \"additionalData\":{\n               \"captureDelayHours\":\"72\",\n               \"alias\":\"B181677540714335\"\n            },\n            \"amount\":{\n               \"value\":500,\n               \"currency\":\"EUR\"\n            },\n            \"pspReference\":\"9313547924770610\",\n            \"eventCode\":\"AUTHORISATION\",\n            \"eventDate\":\"2018-01-01T01:02:01.111+02:00\",\n            \"merchantAccountCode\":\"YOUR_MERCHANT_ACCOUNT\",\n            \"operations\":[\n               \"CANCEL\",\n               \"CAPTURE\",\n               \"REFUND\"\n            ],\n            \"merchantReference\":\"YourMerchantReference1\",\n            \"paymentMethod\":\"visa\",\n            \"reason\":\"58747:1111:12\/2012\",\n            \"success\":\"true\"\n         }\n      }\n   ]\n}","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Webhooks","lvl3":"Webhook structure and types","lvl4":"Additional settings"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/development-resources","lvl2":"https:\/\/docs.adyen.com\/development-resources\/webhooks","lvl3":"https:\/\/docs.adyen.com\/development-resources\/webhooks\/webhook-types","lvl4":"\/development-resources\/webhooks\/webhook-types\/additional-settings"},"levels":5,"category":"Development Resources","category_color":"green","tags":["Additional","settings"]}}