Skip to main content
POST
/
payout
/
recipients
/
{id}
/
accounts
Add a bank account to a beneficiary
curl --request POST \
  --url http://localhost:4000/v1/payout/recipients/{id}/accounts \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "usd",
  "bank_name": "Chase Bank",
  "routing_number": "021000021",
  "account_number": "9900000003",
  "checking_or_savings": "checking",
  "clabe": "032180000118359719",
  "legal_name": "Juan García López",
  "rfc": "GARL850101XXX",
  "iban": "DE89370400440532013000",
  "bic": "COBADEFFXXX",
  "sort_code": "123456",
  "br_code": "00020126580014br.gov.bcb.pix",
  "tax_id": "12345678901",
  "country": "MX"
}
'

Path Parameters

​
id
string
required

Body

application/json
​
currency
enum<string>
required

Currency for this bank account

Available options:
usd,
mxn,
eur,
gbp,
brl
Example:

"usd"

​
bank_name
string

Bank name

Example:

"Chase Bank"

​
routing_number
string

Bank routing number (required for US accounts)

Example:

"021000021"

​
account_number
string

Bank account number (required for US and GB accounts)

Example:

"9900000003"

​
checking_or_savings
enum<string>

Account type (US accounts only)

Available options:
checking,
savings
Example:

"checking"

​
clabe
string

CLABE interbank number (required for MX accounts, 18 digits)

Example:

"032180000118359719"

​
legal_name
string

Legal name of the account holder (MX accounts)

Example:

"Juan García López"

​
rfc
string

RFC tax identifier (MX accounts)

Example:

"GARL850101XXX"

​
iban
string

IBAN (required for EUR accounts)

Example:

"DE89370400440532013000"

​
bic
string

BIC/SWIFT code (EUR accounts)

Example:

"COBADEFFXXX"

​
sort_code
string

Sort code (required for GB accounts, 6 digits)

Example:

"123456"

​
br_code
string

BR code / PIX key (required for BRL accounts)

Example:

"00020126580014br.gov.bcb.pix"

​
tax_id
string

Tax ID (CPF/CNPJ for BRL accounts)

Example:

"12345678901"

​
country
string

Country code for the bank account (ISO 2-letter)

Example:

"MX"

Response

Bank account added