Adyen-for-platform icon

Split chargebacks

Learn how to handle the disputed amount during a chargeback.

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 -white_check_mark- The method of handling potential chargebacks.
Possible values:
  • deductFromLiableAccount: deducts the full amount from your platform's liable balance account.
  • deductFromOneBalanceAccount: deducts the full amount from the balance account specified in targetAccount.
  • deductAccordingToSplitRatio: deducts the funds according to the split ratio defined in the splits array.
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.

If you changed the default chargeback logic for your platform, you can still choose to book the disputed amount from your liable account for an individual payment.

To book the full disputed amount to your liable balance account for a potential chargeback event, specify the following parameters in the platformChargebackLogic object of your POST /payments, /sessions, or /payments/{paymentPspReference}/captures request.

Parameter Required Description
behavior -white_check_mark- The method of handling chargebacks. Set this to deductFromOneBalanceAccount.
costAllocationAccount The ID of the balance account to which the chargeback fees are booked. By default, this is your liable balance account.

Here is an example of a full payment request, where a potential chargeback will be booked to your platform's liable balance account.

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.

See also