Application information identifies the software that you use for making payment requests to the Adyen payments platform. Add application info to your payment requests so that we can analyze and troubleshoot payments more efficiently and provide better support.
Requirements
If you have built a Terminal API integration, there are no additional requirements, limitations, or preparations.
Application information fields
Include these fields in the applicationInfo object:
| Field | Description | Required | Example |
|---|---|---|---|
externalPlatform.name |
Your company name or the name of your platform. |  |
Best Store Commerce |
externalPlatform.version |
The software version of the platform. | If your platform has versions. | 1.3 |
externalPlatform.integrator |
Your company name if you built the POS application, or the name of the service partner that built your integration. | |
AAA Systems |
merchantApplication.name |
The name of the POS application or product being used. | |
Best Instore |
merchantApplication.version |
The software version of the application. | If your application has versions. | 2.13.05 |
merchantDevice.os |
The operating system of the device that runs the POS application. | |
iOS |
merchantDevice.osVersion |
The software version of the operating system. | |
16.3 |
Field value requirements
The values you send in the application info fields can:
- Be between up to 40 characters in length.
- Start with a number or letter.
- Contain letters, digits, dashes, underscores, and spaces.
The formatting of the values must be the same in every request.
For example, if the externalPlatform.name is Best Store Commerce, you cannot sometimes specify that value as BestStoreCommerce or BESTSTORECOMMERCE. You must choose one format and stick to it.
Add application info to your request
To add application info to your payment request, you pass data elements in the SaleToAcquirerData field. There are two ways to do that:
- Option 1: as a JSON object converted to a Base64-encoded string.
- Option 2: as form-encoded key-value pairs (using & as a separator).
The format of the SaleToAcquirerData, Base64-encoded or key-value pairs, determines the format of the AdditionalResponse that you receive. To always receive the AdditionalResponse in one of those formats, contact our Support Team.
Combining application info and other data elements
Apart from application info, you can also add other information in the SaleToAcquirerData field. For example, you can add tender options or metadata.
To combine application info and other data elements, see Add information to a payment.