Process online payments

Before your users can start accepting payments from their customers, you need to build an Adyen online payments integration and a checkout UI, and configure the payment methods for the merchant accounts or stores in your platform.

To make sure that the pay-in, settlement, and payout processes run smoothly, you must book the incoming funds and fees to the correct balance accounts. This means that in each individual payment, capture, and refund request that you send on behalf of your users, you have to include information on how to split the funds between your user's balance accounts and your platform's liable balance account.

In your requests, you can include specific instructions on booking:

• Payments for the goods or services in the payment or capture request
• Refunds
• Fees incurred by transactions
• Chargebacks and related fees
• Leftover amount after currency conversion

Your platform's commission is always booked to your liable balance account.

Requirements

To process online payments for your users, you must:

• Ensure that your server can receive and accept webhooks.
• Have API credentials for the Checkout API.

Splitting transactions

Transactions processed through Adyen must be split between the balance accounts in your platform: your liable balance account and your users' balance accounts.

You can split funds into any number of balance accounts in your platform. For example, when a customer pays, you can split the funds into multiple parts:

• The sale amount, which goes to your user's balance account.
• Your platform's commission, which goes to your platform's liable account.
• The transaction fees, which can be charged to your user's balance account.
• The remainder after currency conversion, which can be booked to your user's balance account.

You must send the split instructions with every payment, capture, or refund request. If you do not provide any split information, the whole transaction is booked to your platform's liable balance account, including all associated fees.

Split types

When you split a transaction between multiple balance accounts, each split serves a different purpose. For example, a part of the transaction goes to your liable balance account as your platform's commission, and a part goes to your user's balance account as the sale amount.

When you send an API request for a transaction, you must define split instructions for each split of the full transaction amount. In each set of split instructions, you must use the type field to define the purpose of that split.

Certain split types also require you to define other values in the split instructions. For example, when you want to book the split amount to your user's balance account (type is BalanceAccount), you must specify the ID of that balance account using the account parameter.

The following table shows the possible split type values you can send in your request, and whether you must send another parameter (account, amount, or reference) in the split instruction.