How can I split payments between different accounts?

Green warning sign with exclamation mark.

Do you have the right user role?

Please check whether you have the following user role:

  • Manage Split Configuration Settings

Split payments between different accounts

With the split payments features you can split funds as many times as you need. It helps you to split custom payments, captures, or refunds between any number of accounts in your platform, including your liable account.

Tip: Marketplaces can customize the payment split to suit their business model and account for operational costs.

Tip: In the payment request, a platform can provide split information. Based on the split.type and split.reference, a split.item is booked.

Split types

Split types
Explanation
Split reference

Default
Can be used as required by the platform’s use case, and are provided for the ease of record keeping.
Not required

PaymentFee
Can be used as required by the platform’s use case, and are provided for the ease of record keeping.
Not required

VAT
Can be used as required by the platform’s use case, and are provided for the ease of record keeping.
Not required

Commision
Can be used as required by the platform’s use case, and are provided for the ease of record keeping.
Not required

MarketPlace
Allows the platform to direct the funds to a specific account (including their own liable account).

A unique split.reference is required.


BalanceAccount

Used for an AfP setup on Adyen’s balance platform instead of VIAS.



It’s required to provide the Balance account instead of the account.

If every split.item in a payment has an unique reference each split.item will be booked as PendingCredit-Credited under the transaction overview of your account holder.

If the split.reference is missing or not unique for split.types (Default, PaymentFee, VAT and Commission) the split.item will not be visible as PendingCredit-Credited. Instead the split.item will be booked to your default liable account, and included as part of the TransferBalance record type in your Marketplace Payments Accounting Report.

Tip: For further information to execute a split payment request, please refer to our documentation.

Failed split payment

A split payment can fail to reach the intended account due to two reasons:

  • The account provided in the split payment doesn’t exist. Make sure you have received an ACCOUNT_CREATED notification before attempting a split payment to it.
  • No split data was provided in the payment request.

 

In both scenarios the funds will be sent to your liable account, which you can then correct using fund transfers. You learn more about validating split information in our documentation.

Let's practice

Learn more on this topic and practice what you’ve learned.

Go to your Customer Area
Stylized illustration of a customer support representative with headset.

Do you need additional help?

Contact our support team

Send us the details of your issue by adding images or screenshots.

Submit a request