Account icon

Account structure

Understand account structures to design an integration that suits your business needs.

Before you start building your integration, you need to understand the account structure of Adyen business accounts as well as the general account structure of Adyen for Platforms.

Adyen for Platforms structure

Adyen business accounts are usually used with an Adyen for Platforms integration. With Adyen for Platforms, your merchant accounts are connected to your balance platform. The balance platform is an accounting system that manages the flow of funds within your business.

In your balance platform, you can:

To enable your users to use business accounts, you must create the following resources for them:

  • Account holder: specifies what your user can do in your platform, for example, receive fund transfers to their balance account and payouts to their verified transfer instrument (bank account). An account holder must be linked to your user's balance account and main legal entity.
  • Balance account: holds the funds of your user. All financial activities in your platform, such as paying out to a bank account, happen through balance accounts.

Structure with business accounts

Business accounts allow you to make business-related transfers to third parties using Adyen-issued bank accounts (business accounts). When you start using business accounts, we create the following resource in your balance platform:

  • paymentInstrument (business account): an externally-facing resource for interacting with funds on the associated balance account. Creating a payment instrument generates an account number. Each balance account can have only one payment instrument of type bankAccount.

Here are two examples of a setup:

  • Example 1: an account holder with one balance account linked to a payment instrument of type bankAccount.
  • Example 2: an account holder with two balance accounts, each linked to a respective payment instrument of type bankAccount.