---
title: "Additional settings"
description: "Receive additional shopper and transaction information in standard webhooks."
url: "https://docs.adyen.com/development-resources/webhooks/webhook-types/additional-settings"
source_url: "https://docs.adyen.com/development-resources/webhooks/webhook-types/additional-settings.md"
canonical: "https://docs.adyen.com/development-resources/webhooks/webhook-types/additional-settings"
last_modified: "2025-10-09T13:37:00+02:00"
language: "en"
---

# Additional settings

Receive additional shopper and transaction information in standard webhooks.

[View source](/development-resources/webhooks/webhook-types/additional-settings.md)

You can optionally receive more information about a transaction in your standard webhooks. You receive this information as `additionalData` included in the [webhook](#example).

To enable receiving this additional information:

1. In your [Customer Area](https://ca-test.adyen.com/), go to **Developers** >  **Webhooks**.
2. From the list of webhooks, select the one to configure.
3. Select **Edit webhook** or the edit icon **.
4. Some webhooks have optional additional settings. If available, under **Additional Settings**, select the checkboxes for the additional information to include in the webhook.
5. Select **Save configuration**.

You can receive the following information:

| Setting                                                                                        | Description                                                                                                                                                                                                                                                                                                                     | Fields included in `additionalData`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |   |
| Add Acquirer Result                                                                            | Receive Adyen's standardized mapping of the acquirer results for [AVS](/risk-management/avs-checks) and [CVC](/get-started-with-adyen/adyen-glossary/#card-security-code-cvc-cvv-cid) checks.                                                                                                                                   | * `referred`

* `authCode`

* `cvcResult`

* `avsResult`                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Add Payment Account Reference                                                                  | Receive the [Payment Account Reference (PAR)](/point-of-sale/card-acquisition/insights#gather-data-yourself) 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**. | - `PaymentAccountReference`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Add Raw Acquirer Result                                                                        | Receive the raw acquirer results for [AVS](/risk-management/configure-manual-risk/standard-risk-rules#consistency-rules) and [CVC](/get-started-with-adyen/adyen-glossary/#card-security-code-cvc-cvv-cid) checks.                                                                                                              | * `acquirerCode`

* `cvcResultRaw`

* `avsResultRaw`

* `refusalReasonRaw`                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| HMAC Key (HEX Encoded)                                                                         | Use this to generate a new HMAC key for your webhook events. For more information on HMAC signatures, see [Verify HMAC signatures](/development-resources/webhooks/secure-webhooks/verify-hmac-signatures) .                                                                                                                    | - `hmacSignatureKey`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Include ARN                                                                                    | Receive the [Acquirer Reference Number](https://help.adyen.com/knowledge/payments/payment-basics/where-can-i-find-the-acquirer-reference-number-arn/) (ARN) . This can be used for reconciliation if Adyen Acquiring **is** **not** used for settlement. The ARN is only returned in CAPTURE and REFUND webhook events.         | * `arn`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Include Acquirer Error Details                                                                 | Receive the details of errors sent by the [Acquirer](/get-started-with-adyen/adyen-glossary/#acquirer-or-acquiring-bank) .                                                                                                                                                                                                      | - `acquirerErrorCode`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Include Acquirer Reference                                                                     | Receive the [Acquirer Reference](https://help.adyen.com/knowledge/payments/payment-basics/where-can-i-find-the-acquirer-reference-number-arn/) . This can be used for reconciliation when Adyen Acquiring is used for settlement.                                                                                               | * `acquirerReference`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Include Alias Info                                                                             | Receive the [alias](https://docs.adyen.com/api-explorer/#/Recurring/v30/listRecurringDetails__resParam_details-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](/get-started-with-adyen/adyen-glossary/#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](/get-started-with-adyen/adyen-glossary/#bank-identification-number-bin) of a credit card.                                                                                                                                                                                              | - `cardBin`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Include detailed Card Bin information                                                          | Receive information about card transactions, including [zero value authorisations](/get-started-with-adyen/adyen-glossary/#zero-value-auth).                                                                                                                                                                                    | * `cardBin` – The [Bank Identification Number](/get-started-with-adyen/adyen-glossary/#bank-identification-number-bin) 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/region
* `fundingSource` – Information about the funding type of the card
* `isCardCommercial` – Whether the card is a commercial card |
| Include Card Holder                                                                            | Receive the name of the [cardholder](/get-started-with-adyen/adyen-glossary/#cardholder) .                                                                                                                                                                                                                                      | - `cardHolderName`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Include card info for recurring contract webhook events                                        | Receive the card information that is used to create a recurring contract.                                                                                                                                                                                                                                                       | * `cardSummary`

* `cardBin`

* `expiryDate`

* `cardHolderName`

* `fundingSource`                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Include the co-brand card information                                                          | Receive information about co-badged cards.                                                                                                                                                                                                                                                                                      | - `coBrandedWith`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Include the bin and summary information for network tokens in the case of tokenized payments.  | Receive the BIN of the network token and the last four digits of the network token.                                                                                                                                                                                                                                             | * `networkToken.tokenSummary`

* `networkToken.bin`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Include contactless wallet token information                                                   | 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** > **Additional data**.                                                                                                   | - `tokenTxVariant`

- `untokenisedCardSummary`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|                                                                                                |                                                                                                                                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 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:

  * **CHARGED**

  * **CREDIT**

  * **DEBIT**

  * **PREPAID**

  * **DEFFERED\_DEBIT**

  * **PREPAID\_RELOADABLE**

  * **PREPAID\_NONRELOADABLE**                                                                                                                                                                                                                                                                                                                                          |
| Include Installments info                                                                      | Receive the installment value for Mercado Pago payments and Klarna Pay Over Time.                                                                                                                                                                                                                                               | * `installments.value`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Include Issuer country/region                                                                  | Receive the country/region where the card was issued. Format: the two-letter [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. Exception: **QZ** (Kosovo).                                                                                                                                   | - `issuerCountry`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Include Metadata in payment webhook for 3D Secure payments (webhooks are not sent from Pal)    | Receive the metadata that you sent in the payment request for the [3D Secure](/online-payments/3d-secure/redirect-3ds2) payment.Enabling this may cause a slight delay receiving webhooks.                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Include notes in manual review webhooks                                                        | Receive the notes added during [manual review](/risk-management/case-management) .                                                                                                                                                                                                                                              | * `manualReviewNotes`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Include the originalReference for CHARGEBACK\_REVERSED webhook events                          | For [CHARGEBACK\_REVERSED](/development-resources/webhooks/webhook-types#event-codes) webhook events, receive the `pspReference` of the original payment.                                                                                                                                                                       | 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
- `paypalPayerResidenceCountry` – The shopper's country/region of residence                                                               |
| Include PayULatam Details                                                                      | Receive the traceability code and the authorization code of the sale. This only applies if PayULatam Acquiring is used for settlement.                                                                                                                                                                                          | * `payULatamTrazabilityCode`

* `authCode`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Include POS Details                                                                            | 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](/point-of-sale/offline-payment).                                                                                                 | - `tenderReference`

- `terminalId`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Include POS TerminalInfo                                                                       | Receive the POIID of the payment terminal that processed the payment.                                                                                                                                                                                                                                                           | * `terminalId`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Include Raw 3D Secure Details Result                                                           | Receive the [3D Secure](/online-payments/3d-secure/redirect-3ds2) authentication result.                                                                                                                                                                                                                                        | - `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](/online-payments/classic-integrations/classic-api-integration/3d-secure-authentication/raw-3d-secure-responses) from the card issuer.                                                                                                                                         | * `threeDOfferedResponse` The raw enrollment result from the 3D Secure directory services of the card schemes.

* `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](/online-payments/account-updater/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 cardholder 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](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/payments__reqParam_additionalData-AdditionalDataRisk-riskdata-deliveryMethod) .                                                | - `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](/risk-management/create-and-use-risk-profiles) .                                                                                                                                  | * `riskProfile`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Include Shopper Country/region                                                                 | Receive the country/region of the shopper, as passed in the payment request. Format: the two-letter [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. Exception: \*\*QZ\*\* (Kosovo). 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 webhook 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](/development-resources/paymentmethodvariant).                                                                                                                                                                                | - `paymentMethodVariant`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Include 3D Secure Result                                                                       | Receive information about [3D Secure](/online-payments/3d-secure/redirect-3ds2) .                                                                                                                                                                                                                                               | * `threeDOffered` – Whether 3D Secure was triggered 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 additional data fields you enable appear in the `additionalData` object of the webhook. The specific fields depend on which settings you select.

The following example shows a standard webhook with **Include capture delay hours** and **Include Alias Info** enabled.

```json
{
   "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":"YOUR_MERCHANT_ACCOUNT",
            "operations":[
               "CANCEL",
               "CAPTURE",
               "REFUND"
            ],
            "merchantReference":"YourMerchantReference1",
            "paymentMethod":"visa",
            "reason":"58747:1111:12/2012",
            "success":"true"
         }
      }
   ]
}
```
