Adyen-for-platform icon

Split payments automatically

Split payments automatically when processing through stores.

If you process your user's transactions through stores, you can configure the store to automatically apply your billing logic. For example, you can deduct your platform's commission and the transaction fees, or choose how to book potential chargebacks.

This means that you don't need to send split instructions in every payment, capture, refund, or chargeback request.

For Adyen to automatically apply the split instructions, you need to:

  1. Create a split configuration profile that contains the conditions that determine whether to split a payment, and the instructions on how to split the payment.
    You can create and manage your split configuration profiles and rules in your Customer Area, or using the Management API.
  2. Link the profile to your user's store when you create or update the store.

By default, all transaction amounts and fees are booked to your platform's liable balance account, which can make reconciliation harder for you platform and users. We recommend that you either create a split configuration profiles, or send the split instructions with every payment, capture, and refund request.

Split configuration profiles

A split configuration profile contains at least one rule. A rule consists of conditions and instructions on how to split transactions. If a transaction meets all conditions of the rule, the split instructions are applied.

If a profile contains multiple rules that apply to the transaction, we use the split instructions from the rule that is the highest in the rule hierarchy.

Conditions

The conditions define if a transaction is split according to the split instructions. If a transaction meets all of the conditions of the rule, then the split instructions are applied.

Condition Required Description
Currency -white_check_mark- Defines whether the rule applies to a specific currency, or all currencies.
Payment method -white_check_mark- Defines whether the rule applies to a specific payment method, or all payment methods associated with the store.
Funding source Defines whether the rule applies to only credit cards, debit cards, or both.
Shopper interaction -white_check_mark- Defines whether the rule applies to a specific sales channel, or all channels.

Split instructions

The split instructions determine how a transaction is split: the amounts booked to your liable balance account and to your user's balance accounts, and how they appear in the webhooks and reports.

Split instruction Required Description
Commission -white_check_mark- Defines the amount to book to your platform's liable balance account as a commission fee for payments. It can be a fixed amount (specified in minor units), a percentage (specified in basis points), or both.
Transaction fees -white_check_mark- Defines where to book the transaction fees. The fees can be booked either to your liable balance account or your user's balance account, together or separately.
Additional commission Defines whether an additional commission for payments is booked to your user's balance account.
Refund Defines where to to book the refund amount.
Refund cost allocation Defines where to book the fees associated with refunds.
Chargeback Defines where to book the chargeback amount.
Chargeback cost allocation Defines where to book the fees associated with chargebacks.
Remainder Defines where to book the leftover amount (after currency conversion).
Surcharge Defines where to book surcharges.
Tip Defines where to book tips.

When a transaction meets all conditions of the rule, Adyen applies the corresponding split instructions.

We recommend that you always include a catch-all rule (set all conditions to ANY) in your profile, because if none of the rules apply to the transaction, then all funds are booked to your liable balance account.

Adyen evaluates all transactions processed through the store, based on the rules in the store's split configuration profile. In you need to split a specific transaction differently, you can send transaction-specific split instructions in the payment, capture, or refund request. Any split instruction that you send in a request overrides the automatic splits.

Rule hierarchy

If a split configuration profile has multiple rules, and more than one rule applies to the transaction, Adyen applies the rule with the highest priority condition. The conditions are prioritized based on the following hierarchy:

  1. Currency
  2. Payment method
  3. Funding source
  4. Shopper interaction

Example

Here are two example scenarios based on the following split rules:

Rule Currency Payment method Funding source Shopper interaction Commission
1 EUR Any Any Any EUR 3.00 + 1%
2 Any Any Any Ecommerce USD 2.50 + 1%
3 EUR Visa Any Any EUR 2.00 + 1%
4 EUR Any Any Ecommerce EUR 1.40 + 1%
5 EUR Any credit Any EUR 1.50 + 1%

Scenario 1: Ecommerce payment in EUR using American Express

  • Rule 3 doesn't apply, because the payment method is different.
  • Out of the rules that do apply, rules 1, 4, and 5 have a higher priority than rule 2 because of the currency (EUR).
  • Rule 5 has a higher priority than rules 1 and 4, because of the funding source (credit).

Adyen applies rule 5 to split the transaction, and sends EUR 1.50 + 1% to your liable balance account.

Scenario 2: Ecommerce payment in EUR using Visa

  • All rules apply.
  • Because of the specific currency (EUR), rules 1, 3, 4, and 5 have a higher priority than rule 2 (Any).
  • Because of the specific payment method (Visa) rule 3 has a higher priority than rules 1, 4, and 5 (Any).

Adyen applies rule 3 to split the transaction, and sends EUR 2.00 + 1% to your liable balance account.

Next steps