---
title: "additional_data_struct"
url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/additional_data_struct"
source_url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/additional_data_struct.md"
canonical: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/additional_data_struct"
last_modified: "2026-05-23T12:56:20+02:00"
language: "en"
---

# additional\_data\_struct

[View source](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/additional_data_struct.md)

## Transaction data:

| Field                    | Description                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------------------- |
| `PosEntryMode`           | POS entry mode (ICC/MSR/MKE/CLESS\_CHIP/CLESS\_SWIPE).                                        |
| `merchantReference`      | Merchant reference of this transaction.                                                       |
| `txdate`                 | Transaction date, like (14-8-2018).                                                           |
| `txtime`                 | Transaction time, like (09:37:21).                                                            |
| `iso8601TxDate`          | ISO timestamp, like (2018-08-14T09:37:27.0000000+0000).This field returns time in GMT format. |
| `transactionType`        | Transaction type.                                                                             |
| `posOriginalAmountValue` | Original transaction amount.                                                                  |
| `posAuthAmountCurrency`  | Transaction currency (like: EUR).                                                             |
| `posAuthAmountValue`     | Transaction amount (like: 100, which is EUR 1.00).                                            |

## Customer Data:

| Field         | Description                                             |
| ------------- | ------------------------------------------------------- |
| `alias`       | Unique PCI safe card alias.                             |
| `loyaltyData` | Loyalty data as retrieved from merchant loyalty system. |

## Digital Customer Recognition data:

| `Field`            | Description                                                                                                                                  |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `shopperReference` | Shopper reference. Minimum length three characters. Do not include personally identifiable information (PII), such as name or email address. |
| `shopperEmail`     | Shopper email.                                                                                                                               |

## Card Data (including date check for tax free eligibility):

| Field                      | Description                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------- |
| `AID`                      | Full AID, like (A000000004101002).                                                  |
| `posEntryMode`             | POS entry mode (like ICC).                                                          |
| `applicationLabel`         | Application label.                                                                  |
| `applicationPreferredName` | Application preferred name.                                                         |
| `cardEffectiveYear`        | Effective year (format: YYYY).                                                      |
| `cardEffectiveMonth`       | Effective month (format: MM).                                                       |
| `cardBin`                  | First six digits of a card number.                                                  |
| `cardSummary`              | Last 4 digits of a card number.                                                     |
| `cardIssueNumber`          | Card issue number.                                                                  |
| `tid`                      | Terminal id at the acquirer.                                                        |
| `cardHolderName`           | Cardholder name.                                                                    |
| `cardIssuerCountryId`      | Card issuer ISO 3166 country code (like 840).                                       |
| `paymentMethod`            | The scheme of the payment method used, e.g. Visa, Mastercard etc.                   |
| `paymentMethodVariant`     | The type or sub-brand of payment method used, e.g. Visa Debit, Visa Corporate, etc. |
| `expiryMonth`              | Expiry month, like (02).                                                            |
| `expiryYear`               | Expiry year, like (2028).                                                           |
| `error_message`            | Textual message that might give additional information in case of failure.          |

## DCC Returned Details

| Fields                          | Description                                                              |
| ------------------------------- | ------------------------------------------------------------------------ |
| `dcc.markup`                    | The markup percentage (for example, 300 = 3%).                           |
| `dcc.commissionfee`             | The commission fee in minor units (for example, 0. Not used currently.). |
| `dcc.exchangerate`              | The exchange rate (for example, 16178 = 1.6178).                         |
| `dcc.converted.amount.value`    | The amount after conversion (for example, minor units).                  |
| `dcc.converted.amount.currency` | The currency after conversion (For example, USD).                        |
| `dcc.org.amount.value`          | The original amount in minor units.                                      |
| `dcc.org.amount.currency`       | The original currency (for example, EUR).                                |
| `dcc.source`                    | The exchange rate source.                                                |

## Signature Data

| Field                         | Description                                |
| ----------------------------- | ------------------------------------------ |
| `signature.retries.available` | Number of signature retries available.     |
| `signature.mimetype`          | Mime type of the image (like "image/bmp"). |
| `signature.data`              | Base64 encoded image.                      |