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 payment request.
By default, these fees are deducted from your liable balance account. However, you can also book them directly to a 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 by transferring funds between balance accounts. You can charge the following fees directly to your user:
- Scheme Fees
- Acquirer Markup
- Blend Commission
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 transaction fees to your user
When splitting a payment, include an additional split item for the transaction fees.
When adding a new split item, always include this in the total number of split items specified in the
For this split item, specify:
Key Description Example
The type of split. Set this to PaymentFee. split.item3.type=PaymentFee
Account that will be charged the transaction fees. This is the
balanceAccountIdof one of your user's balance accounts.You cannot charge the transaction fees to multiple balance accounts.
Your reference for the transaction fees, reflected in the Balance Platform Accounting Report. split.item3.reference=reference_PaymentFee
Your description for the transaction fees, reflected in the Balance Platform Accounting Report. split.item3.description=description_PaymentFee
You do not need to specify the
split.item[ITEM_NUMBER].amountfield, since the transaction fees are not known when creating the payment request.
For example, let's split a payment of EUR 620.00 into three parts:
- EUR 600.00 to be booked to your user's first balance account as the sale amount.
- The transaction fees to be booked against your user's first balance account. This will be deducted from the sale amount.
- EUR 20.00 to be booked to your liable account as your platform's commission.
In this case, set
split.nrOfItems to 3 and
split.totalAmount to 62000.
If the payment is successful:
- Approved is shown on the terminal display.
- You receive a payment response with:
POIData.POITransactionID.TransactionID: transaction identifier for the payment in the format
tenderReference.pspReference. For example, oLkO0012498220087000.981517998282382C.
PaymentResponse.Response.AdditionalResponse: additional transaction data. Its format corresponds to the format of the
SaleToAcquirerDatain the payment request: a Base64-encoded JSON object or form-encoded key-value pairs.
PaymentReceipt: object with data you can use to generate a receipt.