Account Details

An account_detail object represents all account numbers related to a specific bank account. Often bank accounts will only have a single number but having multiple is more common outside the United States. For example in some countries, the IBAN is used for international routing but domestic payments will use a separate unformatted account number. Modern Treasury allows you to provide both account numbers and our software will choose the correct one in all cases.


Attribute

Description

account_number_safe string

The last four digits of the account number for the bank account.

account_number
string

Bank account numbers are sensitive information and are not included in API responses by default. Modern Treasury advises using the account_number_safe field instead. Learn more about changing your settings here.

account_number_type
string

One of the below account_number_type values.

Use other if the bank account number is in a generic format.

live_mode
boolean

This field will be true if this object was created with a production API key or false if created with a test API key.


Here are the Account Number Types we support at MT. Make sure you're using the right account_number_type based on the locations of the both accounts and what's needed by the payment_type.

account_number_type

Country

Format

au_number

Australia

12-15 digits
First 3 - Bank Code
Next 3 - Branch Code
Last 6-9 - Account Number

clabe

Mexico

18 digits
First 3 - Bank Code
Next 3 - Branch Code
Next 11 - Account number
Last 1 - Control Digit

hk_number

Hong Kong

XXXXXX-YYY
X is the base account number
5-6 digits long
Y is the account suffix
1-3 digits long

Note: Only use this when you have a suffix,
otherwise use other

iban

Any (IBAN)

Upto 34 letters depending on country
First 2 - ISO 2 letter country code
Next 2 - Check Digits
Rest - Basic Bank Account Number
(BBAN)

id_number

Indonesia

6-16 Digits

nz_number

New Zealand

15-16 Digits
(Combined Routing&Account Number)
First 2 - Bank Code
Next 4 - Branch Code
Next 7 - Account Number
Rest - Account Number Suffix

other

Any (Generic)

Only Digits

pan

Any (Cards)

12-19 Digits
Generally 16 Digits

sg_number

Singapore

6-34 Digits

wallet_address

Any (Wallet)

Wallet Provider Specific Format

{
  "id": "f3552822-38f5-4dd5-aa10-a5a2fce00ed6",
  "object": "account_detail",
  "account_number_safe": "0934",
  "account_number_type": "other",
  "live_mode": true,
  "created_at": "2019-11-09T00:11:07Z",
  "updated_at": "2019-11-09T00:11:07Z"
}