Chargeback events
If a payment is reversed by a customer of your user, and the issuer has started a dispute process, Adyen withdraws the disputed funds from your platform's liable balance account. This transaction is called a chargeback.
You can either accept the chargeback on behalf of your user, or ask them to supply defense documents and upload them to Adyen.
If the chargeback is defended successfully, or the customer repays the funds, Adyen transfers the funds back to your platform's liable balance account. This transaction is called a chargeback reversal.
If the issuing bank declines the material submitted during defense of the original chargeback, the disputed amount is deducted from your platform's liable balance account again. This transaction is called a second chargeback.
This means that during the dispute process, the entire disputed amount is debited (chargeback or second chargeback) or credited (chargeback reversal) to your platform's liable balance account.
You can change this behavior by booking the disputed amount to any of the balance accounts in your platform, or even splitting it between the accounts.
Chargeback logic options
You can choose between three different ways to handle potential chargeback events:
- Book the full disputed amount to your platform's liable balance account.
- Book the full disputed amount to one of your user's balance accounts.
- Book different amounts to different balance accounts, according to the split ratio defined in the
splits
array of your /payments or /sessions request.
You can define the chargeback logic on two levels:
- Balance platform level: Set a default logic to handle all chargeback events. Contact our Support Team to configure a default logic on balance platform level.
- Payment level: Set a logic for each payment. The chargeback event handling logic you set at payment level overrides any default logic set at balance platform level.
If you decide to set the chargeback logic on a payment level, you can do so in your payment or capture request. The chargeback logic sent in a capture request overrides the logic you specified in your payment request.
Configure the chargeback logic on payment level
To configure the logic for a potential chargeback, include the platformChargebackLogic
object in the body of your POST /payments, /sessions, or /payments/{paymentPspReference}/captures request.
Depending on which logic you choose, send different parameters and values in the platformChargebackLogic
object:
Parameter | Required | Description |
---|---|---|
behavior |
![]() |
The method of handling potential chargebacks. Possible values:
|
targetAccount |
Required if behavior is deductFromOneBalanceAccount |
The ID of the balance account to which the disputed amount is booked. |
costAllocationAccount |
The ID of the balance account to which you want to book the fees incurred by the chargeback. |
Examples
Select one of the tabs below to view an example payment request for each of the three chargeback logic types.
Reports
In the Balance Platform Accounting Report, the chargeback fee type is indicated before the transfer description, which matches the description of the original payment.