Account details

Learn about account details in Mambu Payments

Account details are used in multiple Mambu Payments objects, including:

AttributeDescription
instrument_type
string
Describes whether the account represents a traditionnal bank account, or other instruments like a wallet.

One of bank_account, wallet
Optional, defaults to bank_account
account_number
string
The IBAN or account number. If an IBAN, Mambu Payments verifies the validity of the IBAN, but does not verify that the IBAN exists or belongs to the account holder.

Only avaible if instrument_type: bank_account
account_number_format
string
The format of the account number. When set, it must match account_number unless the format is other or tokenized. One of iban, uk_account_number, us_account_number, other, or tokenized.

Only avaible if instrument_type: bank_account
bank_code
string
The BIC / Swift code, sort code, or routing number, depending on the country and bank. Only upper case letters allowed.

Only avaible if instrument_type: bank_account
bank_code_format
string
The format of the bank code. When set, it must match bank_code unless the format is other or tokenized. One of bic, uk_sorting_code, us_aba_routing_number, other, or tokenized.

Only avaible if instrument_type: bank_account
bank_name
string
The name of the bank.

Only avaible if instrument_type: bank_account
bank_address
object
The address of the bank, as an address object.

Only avaible if instrument_type: bank_account
wallet
object
Object that describes the wallet, with fields:
  • id: string
  • provider: string
Example:
{"id": "john_doe", "provider": "paypal"}

Only avaible if instrument_type: bank_account
holder_name
string
The name of the company or individual holding the account.
holder_name_details
object
Object required by specific providers to pass the holder's name, with fields:
  • first_name
  • last_name
holder_address
object
The account holder address, as an address object.
holder_type
string
Describes if the owner is an individual or a legal entity.
One of individual, legal_entity
organization_identification
object
The account organization identification, as an organization_identification object. organization_identification and private_identification are mutually exclusive.
private_identification
object
The account private identification, as a private identification object. organization_identification and private_identification are mutually exclusive.