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 do not need to send split instructions for every payment, capture, refund, or chargeback.

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 (split logic).
    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 your platform and users. We recommend that you either create split configuration profiles, or send the split instructions with every payment-related request. You can also override a profile, when necessary, by specifying split instructions in your individual payment requests.

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, we book the funds and fees to the balance account that you specify when you link the profile to a store.

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 the conditions of the rule, then the split instructions are applied.

Condition Required Description
Currency Defines whether the rule applies to a specific currency, or all currencies.
Payment method Defines whether the rule applies to a specific payment method, or all payment methods associated with the store. You can define different rules for payment method variants as well.
Funding source Defines whether the rule applies to a specific type of card, or all card types.
Shopper interaction Defines whether the rule applies to a specific sales channel, or all channels.

Split logic

The split logic is a set of instructions that determine how we split a transaction: the amounts we book to your liable balance account and to your user's balance account, and how they appear in the webhooks and reports.

Split instruction Required Description
Commission Defines the amount to book to your liable balance account as your platform's commission on the transaction. It can be a fixed amount (specified in minor units), a percentage (specified in basis points), or both.
Transaction fees Defines where to book the transaction fees. We can book the fees either to your liable balance account or your user's balance account, together or separately.
Additional commission Defines whether we book an additional commission to your user's balance account.
Refund Defines where 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 logic.

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 by default.

Adyen evaluates all transactions processed through the store, based on the rules in the store's split configuration profile. In case 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 split.

Rule hierarchy

If a split configuration profile has multiple rules, and more than one rule applies to the transaction, Adyen determines which rule to apply based on priority and granularity.

The priority of rules is:

  1. Currency
  2. Payment method or payment method variant, like visa or visasignature
  3. Funding source
  4. Shopper interaction

The granularity of a rule refers to how specific the rule is, for example:

  • Whether the rule is for one currency in particular or for any currency.
  • Whether the rule is for Visa payments with a payment method variant of visasignature, or for Visa payments in general with a payment method variant of visa.

Within each priority, a rule that is more granular (more specific) takes precedence over a general rule.

Examples

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 visasignature 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 and 4 don't apply, because the payment method is different.
  • Out of the rules that do apply, rules 1 and 5 have a higher priority than rule 2 because of the currency (EUR).
  • Rule 5 has a higher priority than rule 1 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 a Visa debit card

  • Rule 4 doesn't apply, because the payment method variant is different.
  • Because of the specific currency (EUR), rules 1, 3, 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 and 5 (Any).

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

Scenario 3: Ecommerce payment in EUR using a Visa Signature card

  • 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 variant (visasignature), rule 4 has a higher priority than rules 1 and 5 (Any), and rule 3 (visa).

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

Commission

With each payment you accept on behalf of your users, you can charge them a commission. A commission can either be a fixed amount (fixed fee), a percentage of the payment amount (variable fee), or both.

By default, the variable fee is calculated as a percentage of the total payment amount, which includes the tip and the surcharge paid by the customer. However, if you do not want to charge a commission on the tip and/or surcharge, you can exclude these from the commission calculation.

To configure your preferred commission calculation logic, reach out to our Support Team. Choose between the following options:

  • Include the tip and the surcharge in the commission calculation (default).
  • Only include the tip in the commission calculation.
  • Only include the surcharge in the commission calculation.
  • Exclude the tip and the surcharge from the commission calculation.

This means that we calculate all variable Commission and Additional commission fees defined in your split configuration profiles according to your chosen commission calculation logic.

Example commission calculation

Consider the following example, where the customer buys goods worth USD 100.00 from your user. You charge both a fixed and a variable fee on the payment as your platform's commission.

Price Tip Surcharge Payment amount Fixed fee Variable fee
USD 100.00 USD 10.00 USD 1.00 USD 111.00 USD 5.00 5% of the payment amount

The following table shows how we calculate the variable fee based on the logic you choose, and the total amount that is booked to your user. For each of these cases, the total amount paid by the customer is USD 111.00.

Commission logic Amount on which you charge a commission Fixed fee Variable fee Commission Amount booked to user
Include tip and surcharge USD 111.00 USD 5.00 USD 5.55 USD 10.55 USD 100.45
Tip only USD 110.00 USD 5.00 USD 5.50 USD 10.50 USD 100.50
Surcharge only USD 101.00 USD 5.00 USD 5.05 USD 10.05 USD 100.95
Exclude tip and surcharge USD 100.00 USD 5.00 USD 5.00 USD 10.00 USD 101.00

Captures

When you capture a payment that meets all the conditions of an automatic split rule, we book the funds according to the split logic of that rule. If the capture amount differs from the original authorization amount, we recalculate the split amounts, and apply the split instructions to the captured amount.

Next steps