Entity bank accounts
Learn how to manage the bank accounts of entities.
Overview
Entities that represent the customers of Monite partners can have their bank account information associated with them. These bank accounts can be set as default for payment in different currencies.
Add a bank account to an entity
To add a bank account to an entity, call POST /bank_accounts
and provide the bank account details. All bank accounts require the country
and currency
.
In most cases, bank accounts must be located in the country where the currency is the official currency. For example:
- USD can only be chosen for bank accounts in the US.
- GBP can only be chosen for bank accounts in the UK (including Gibraltar).
- EUR can only be chosen for bank accounts in the EU, Liechtenstein, Norway, Switzerland, and UK (including Gibraltar).
Other required fields in bank accounts depend on the currency:
EUR accounts | GBP accounts | USD accounts | Other currencies |
---|---|---|---|
iban |
|
| One of:
|
Sample request:
EUR bank account
GBP bank account
USD bank account
The successful response returns the unique id
assigned to the added bank account, along with other details:
Set the default bank account
Once the bank accounts are added to the entity, set a default bank account for each currency by calling POST /bank_accounts/{bank_account_id}/make_default
:
The default entity bank account is set for each currency. Only one default bank account per currency is allowed.
If a new bank account is added to a currency with no default bank account set, the newly added bank account is automatically set as the default for that currency.
List all bank accounts
To get information about all bank accounts associated with the specified entity, call GET /bank_accounts
.
Retrieve a bank account
To get information about a specific bank account associated with the specified entity, call GET /bank_accounts/{entity_bank_account_id}
.
Edit a bank account
You can update the account_holder_name
and display_name
of existing entity bank accounts. To do this, call PATCH /bank_accounts/{entity_bank_account_id}
and provide the new values.
To update other bank account details (for example, iban
), you will need to delete the existing bank account and create a new one instead.
The account_holder_name
of existing GBP and USD bank accounts cannot be changed to an empty string since it is a required field.
Delete a bank account
To delete an existing bank account from the list of bank accounts associated with the specified entity, call DELETE /bank_accounts/{entity_bank_account_id}
.