Split payments

If you are acquiring payments with Adyen, you can also fund balance accounts by splitting the payment amount in any number of ways and booking it to any number of balance accounts.

Make a split payment

To make a split payment:

1. Make a POST /payments request, specifying the splits array.

   For each split object in the array, specify the following fields:

   Parameter	Required	Description
   type		Set to BalanceAccount.
   account		The unique identifier of the balance account where you want to send the funds to.
   amount		The amount to be sent to the balance account.
   reference		Your unique identifier for the split.

   Check that the balance account IDs in your request are correct. The API only validates the format of the split instructions. See validating split instructions.

   For example, you can split a USD 150.00 payment such that:

   • USD 3.00 goes to your liable balance account as commission.
   • USD 147.00 goes to your user's balance account with id BAA1B2C3D4E5F6G7H8I9J0.

   The response informs you if the payment was successful.

2. To know if the split has been settled to the balance account in the request, keep track of webhooks. You can also make GET /balanceAccounts/{id} request.

Validating split instructions

Adyen front-end systems only validate the format of the split instructions, and not the statuses of the balance accounts. This means that payments may succeed, but splits are not applied if the balance account specified in the request does not exist or is linked to an account holder with a closed status. When this happens, the full amount is sent to your platform's liable balance account.

To correct balances, you can transfer funds between balance accounts.