Transaction fees refer to the costs you incur on a transaction in your platform, that are not known at the time of payment. They are calculated by Adyen after we receive the /payments or /sessions request. Transaction fees include:
- Interchange
- Scheme Fees
- Acquirer Markup
- Blend Commission
By default, all of these fees are deducted from your liable balance account. However, you can also book them directly to a single balance account of your user. This is useful if you want to pass on the transaction fees to your user directly, instead of settling this later via a transfer of funds.
Processing fees and discounts due to tiered pricing structures cannot be booked directly to the user’s balance account since these are aggregated amounts (inclusive of refused and cancelled transactions) and cannot be allocated to individual payments.
Book the fees to your user
To pass transaction fees on to your user, submit a POST /payments or POST /sessions request with an additional split item in the splits array, specifying the following fields:
Parameter | Required | Description |
---|---|---|
account | ![]() |
The unique identifier of the balance account from which all of the transaction fees must be deducted. You cannot split these fees between multiple balance accounts. |
reference | ![]() |
Your reference for the fees to help you reconcile your balances later. |
description | ![]() |
Your description for the fees to help you reconcile your balances later. |
type | ![]() |
The type of split. Set this to PaymentFee. |
We recommend to always include a split item for the transaction fees in your payment or capture request, even if you book the fees against your liable balance account. That way, you can reconcile the fees per transaction using the Balance Platform Accounting Report.
For example, a split payment of USD 400.00 can be split into 3 parts:
- USD 396.00 is the sale amount (booked to the user’s balance account: BA00000000000000000000001)
- USD 4.00 is your platform’s commission (booked to your liable balance account).
- The transaction fees are booked against the user's balance account (BA00000000000000000000001). This will be deducted from the sale amount.
The transaction fees are calculated automatically, so even if you provide an amount
for this split item, it will be disregarded. Once the calculations are done, an an internal transfer request is triggered to deduct these fees from the specified balance account. The transfer request includes the type of fee, the currency and the amount charged. You can find a breakdown of the fees on the Payment details page of the transaction in the Customer Area, and in the Balance Platform Accounting Report.