After you create account holders, you need to create a balance account resource to hold their funds. The balance account is to which funds from payments are settled and from which funds are paid out.
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:
- You have API credentials for the Configuration API.
- You have created account holders.
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 id AH00000000000000000000001.
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.
To add funds to your new balance account, you can also top up the account from another balance account or from a verified transfer instrument.