Card schemes require you to send certain data points with each transaction. These data points must refer to your user, who is considered the Merchant of Record when a transaction is facilitated by your platform.
Requirements
| Requirement | Description | |
|---|---|---|
| Integration type | You must have an Adyen online payments integration and a checkout UI. | |
| API credentials | You must have credentials for the Checkout API. |
Send user data points with a transaction
During the /sessions or /payments authorization for each transaction, card schemes require data points that specify the following information about your user:
- Unique identifier: You must assign a unique identifier to each of your users.
- Name: You must provide an accurate name for the user that is present on the shopper's statement. For Mastercard, this includes an aggregator prefix.
- Location: You must provide the user's location as the location of the transaction.
Required parameters
You must send additionalData parameters with the /sessions or /payments authorization request. For cancellations, captures, and refunds, Adyen automatically populates your user's details from the initial payment.
Submit your request using AdditionalDataSubMerchant parameters.
The [subSellerNr] is always 1. Submit all additionalData parameters as:
additionalData.subMerchant.subSeller1.[parameter]
Before going live, confirm with your Adyen contact that the paymentFacilitatorIds, aggregatorPrefix and amexCapnSubmitterId are configured for your platform.
Here is an example of a split payment request facilitated on behalf of your user:
As a payment facilitator, most payment methods allow you to facilitate ecommerce payments using an aggregated MID (your platform's scheme account), instead of requiring a MID per user.
Shopper statement
When shoppers check their bank statements, they need to be able to easily identify the charges they see. The text that describes charges is known as a transaction description, statement descriptor, shopper statement, or billing descriptor. If shoppers do not recognize a transaction by its description:
- There is a higher chance your shopper issues a chargeback.
- You can get a fine from the relevant card scheme related to your chargeback rate.
To prevent these issues, ensure that your transaction description contains your brand or the (chain) merchant name that is most recognizable to the cardholder (as required by the card schemes), and optionally customize your transaction description.
If you are not using stores in your platform, you must configure the transaction description that appears on the shopper statement. Depending on this configuration, you can additionally provide a transaction-specific shopperStatement in your payment request. For more information, see Transaction description.