---
title: "SaleToAcquirerData"
url: "https://docs.adyen.com/point-of-sale/add-data/sale-to-acquirer-data"
source_url: "https://docs.adyen.com/point-of-sale/add-data/sale-to-acquirer-data.md"
canonical: "https://docs.adyen.com/point-of-sale/add-data/sale-to-acquirer-data"
last_modified: "2026-05-24T12:54:31+02:00"
language: "en"
---

# SaleToAcquirerData

[View source](/point-of-sale/add-data/sale-to-acquirer-data.md)

The examples on this page illustrate the structure of many of the data elements that you can pass in the `SaleToAcquirerData` field of your Terminal API payment request.

## Requirements

Before you begin, take into account the following requirements.

| Requirement          | Description                                                                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Integration type** | A [Terminal API](/point-of-sale/basic-tapi-integration/) integration with payment terminals or with a [Mobile solution](/point-of-sale/ipp-mobile). |
| **Setup steps**      | Before you begin, [select the data you want to receive in the additional response](/point-of-sale/add-data#receive-additional-data).                |

## SaleToAcquirerData sample collection

Be aware that the list of `additionalData` elements is long and growing, so we cannot mention all of them here. See for example the [Additional data in our API Explorer](https://docs.adyen.com/api-explorer/#/Payment/latest/authorise__reqParam_additionalData). Many of these elements also apply to point-of-sale payments.

### Tab: JSON object

For instructions, see [Option 1: Pass data elements as Base-64 encoded JSON](/point-of-sale/add-data#base64-json).

```json
{
    "applicationInfo": {
        "externalPlatform": {
            "name": "COMPANY_NAME_OR_PLATFORM_NAME",
            "version": "1.3",
            "integrator": "COMPANY_THAT_BUILT_INTEGRATION_OR_POS_APP"
        },
        "merchantApplication": {
            "name": "NAME_OF_POS_APPLICATION",
            "version": "2.13.05"
        },
        "merchantDevice": {
            "os": "OS_OF_DEVICE_THAT_RUNS_POS_APPLICATION",
            "osVersion": "16.3"
        }
    },
    "metadata": {
        "someMetaDataKey1": "YOUR_VALUE",
        "someMetaDataKey2": "YOUR_VALUE"
    },
    "recurringProcessingModel": "Subscription",
    "recurringDetailName": "YOUR_VALUE",
    "recurringTokenService": "YOUR_VALUE",
    "shopperEmail": "S.Hopper@example.com",
    "shopperReference": "YOUR_UNIQUE_SHOPPER_ID",
    "shopperStatement": "YOUR_PAYMENT_DESCRIPTION",
    "store": "YOUR_STORE_REFERENCE",
    "tenderOption": "ReceiptHandler,AskGratuity",
    "additionalData": {
        "authorisationType": "PreAuth",
        "lodging.customerServiceTollFreeNumber": "1800433999",
        "lodging.checkInDate": "20200219",
        "lodging.checkOutDate": "20200222",
        "lodging.folioNumber": "13579111315",
        "lodging.propertyPhoneNumber": "1800433999",
        "lodging.room1.rate": "15000",
        "lodging.room1.tax": "1000",
        "lodging.room1.numberOfNights": "3",
        "lodging.fireSafetyActIndicator": "Y",
        "lodging.totalRoomTax": "2000",
        "split.api": "1",
        "split.nrOfItems": "2",
        "split.totalAmount": "62000",
        "split.currencyCode": "EUR",
        "split.item1.amount": "60000",
        "split.item1.type": "BalanceAccount",
        "split.item1.account": "BA00000000000000000000001",
        "split.item1.reference": "TestPayment",
        "split.item1.description": "TestDescription",
        "split.item2.amount": "2000",
        "split.item2.type": "Commission",
        "split.item2.reference": "TestCommission",
        "surchargeFee": "VALUE_IN_MINOR_UNITS",
        "taxfree.indicator": false,
        "travelEntertainmentAuthData.market": "H",
        "travelEntertainmentAuthData.duration": "3",
        "manualCapture": "false"
    }
}
```

### Tab: Key-value pairs

For instructions, see [Option 2: Pass data elements as key-value pairs](/point-of-sale/add-data#key-value-pairs).

```raw
applicationInfo.externalPlatform.name=COMPANY_NAME_OR_PLATFORM_NAME
applicationInfo.externalPlatform.version=1.3
applicationInfo.externalPlatform.integrator=COMPANY_THAT_BUILT_INTEGRATION_OR_POS_APP
applicationInfo.merchantApplication.name=NAME_OF_POS_APPLICATION
applicationInfo.merchantApplication.version=2.13.05
applicationInfo.merchantDevice.os=OS_OF_DEVICE_THAT_RUNS_POS_APPLICATION
applicationInfo.merchantDevice.osVersion=16.3
metadata.someMetaDataKey1=YOUR_VALUE
metadata.someMetaDataKey2=YOUR_VALUE
recurringProcessingModel=Subscription
recurringDetailName=YOUR_VALUE
recurringTokenService=YOUR_VALUE
shopperEmail=S.Hopper@example.com
shopperReference=YOUR_UNIQUE_SHOPPER_ID
shopperStatement=YOUR_PAYMENT_DESCRIPTION
store=YOUR_STORE_REFERENCE
taxfree.indicator=false
tenderOption=ReceiptHandler,AskGratuity
split.api=1
split.nrOfItems=2
split.totalAmount=62000
split.currencyCode=EUR
split.item1.amount=60000
split.item1.type=BalanceAccount
split.item1.account=BA00000000000000000000001
split.item1.reference=TestPayment
split.item1.description=TestDescription
split.item2.amount=2000
split.item2.type=Commission
split.item2.reference=TestCommission
additionalData.authorisationType=PreAuth
additionalData.lodging.customerServiceTollFreeNumber=1800433999
additionalData.lodging.checkInDate=20200219
additionalData.lodging.checkOutDate=20200222
additionalData.lodging.folioNumber=13579111315
additionalData.lodging.propertyPhoneNumber=1800433999
additionalData.lodging.room1.rate=15000
additionalData.lodging.room1.tax=1000
additionalData.lodging.room1.numberOfNights=3
additionalData.lodging.fireSafetyActIndicator=Y
additionalData.lodging.totalRoomTax=2000
additionalData.travelEntertainmentAuthData.market=H
additionalData.travelEntertainmentAuthData.duration=3
additionalData.manualCapture=false
```

## See also

* [Add information to a payment](/point-of-sale/add-data)
* [Pass tender options](/point-of-sale/add-data/tender-options)
* [Additional data in our API Explorer](https://docs.adyen.com/api-explorer/Payment/latest/overview)