Create an Adyen business account

When you create an Adyen business account for your users, you generate an IBAN linked to their balance account. Your users can give the IBAN to third parties so they can receive business-related payments or fund transfers.

Before you begin

Before you can create business accounts for your users, follow the requirements for business accounts.

Make sure that your users have:

• A legal entity and business line, containing information required for verification checks.
• An account holder and a balance account.
• Already completed the verification checks for business accounts and already has the issueBankAccount capability.

Create a business account payment instrument

When the business account-related capabilities are allowed for the account holder, you can proceed with creating a payment instrument. These are resources that account holders can use externally to transact with their balance account, such as a business account. Creating a business account payment instrument generates an IBAN.

To create a business account payment instrument, make a POST /paymentInstruments call specifying:

Parameter name	Required	Description
balanceAccountId		The ID returned when you created the balance account. All financial transactions, such as receiving and sending funds, will be processed in this balance account.
issuingCountryCode		The two-letter country code where the business account is issued. We currently only support countries in the EU. The currency of the specified country must match the currency of the balance account.
type		Set to bankAccount.
description		Your description for the business account, which you can use to store useful information for your staff.
reference		Your reference for the business account, which you can map to your internal systems.

Here is how you create a business account number for a business account issued in the Netherlands.

curl https://balanceplatform-api-test.adyen.com/bcl/v2/paymentInstruments \
-H "X-API-Key: YOUR_API_KEY" \
-H "content-type: application/json" \
-X POST  \
-d '{
    "type": "bankAccount",
    "description": "{hint:Your human-readable description for the business account}S.Hopper - Bank account{/hint}",
    "balanceAccountId": "BA1234123412341234",
    "issuingCountryCode": "NL"
}'

The response returns the paymentInstrument resource, identified by its unique id. You also receive the iban which the account holder can use when sending funds to their business account.

{
    "balanceAccountId": "BA1234123412341234",
    "issuingCountryCode": "NL",
    "status": "Active",
    "type": "bankAccount",
    "bankAccount": {
      "iban": "NL20ADYB2017000035"
    },
    "id": "PI322LJ223222B5DJS7CD9LWL"
}