To use their balance account, the account holder must have the capabilities to use it.
In most cases, one balance account for an account holder is sufficient, but there are some scenarios when you might need to create multiple balance accounts. For example, if an account holder has different businesses and would like to keep funds and accounting history separate for each line.
Before you begin
Make sure that:
Create a balance account
All of the account holder's transactions such as payouts and settled payments are processed against their balance account.
To create a balance account, make a POST /balanceAccounts request specifying the accountHolderId to be associated with the balance account. In your request, you can also include a human-readable description to help you differentiate between multiple balance accounts under one account holder.
Include the parameter defaultCurrencyCode to define the default three-character ISO currency code of the balance account, which by default is EUR. Once you create a balance account, you can no longer change its default currency code.
This example shows how you can create a balance account for an account holder with
The response returns the balanceAccount resource, identified by its unique
id. The response also includes the balances array that contains information about the account's funds. By default, the first balance account that you create for an account holder is assigned as their primary balance account. To change their primary balance account, you can update the account holder.
After you create a balance account, the account holder can start using the balance account to process payments and payouts if they have the required capabilities. You can get updates about whether the account holder has the required capabilities to process payments and payouts.
The processed funds are available in the user's balance account after settlement. By default, new balance accounts have a pass-through settlement model. With this model, the funds are settled after the Adyen receives them from the payment schemes. You can configure sales day settlement if you want a more predictable cash flow.