BANK_ACCOUNT

Generic bank account node for payouts. Used across multiple countries.

BANK_ACCOUNT is a generic destination node for payouts to external bank accounts. It's used when the destination is a standard bank account that doesn't fit a specific rail — for example, Canadian or other country-specific accounts not covered by dedicated rail nodes.

Direction: Pay-out

Required fields

Field
Type
Description

type

string

Must be "BANK_ACCOUNT"

currency

string

Currency of the transfer

bank.accountNumber

string

Recipient's bank account number

bank.bank

string

Bank name or identifier

bank.typeAccount

string

Account type: "CHECKING" or "SAVINGS"

bank.country

string

2-letter ISO country code (e.g., "AR", "CA")

customer

object

Recipient's identity information

Example

{
  "type": "BANK_ACCOUNT",
  "currency": "ARS",
  "bank": {
    "accountNumber": "0000123456789",
    "bank": "BANCO_CMF",
    "typeAccount": "CHECKING",
    "country": "AR"
  },
  "customer": {
    "firstName": "Lucía",
    "lastName": "Fernández",
    "email": "[email protected]",
    "documentType": "DNI",
    "documentNumber": "32123456",
    "country": "AR"
  }
}

Note: For Argentina, prefer CVU. For Colombia, prefer BREB. BANK_ACCOUNT is typically used when no country-specific rail is available.

Schema

The bank-account object

Attributes

Schema representing a bank account, including essential details about the account holder and financial institution.

idstringOptional

Unique identifier for the bank account.

externalIdstringOptional

External reference identifier for integrations.

accountNumberstringRequired

The bank account number.

nicknamestringOptional

A friendly name assigned to the bank account.

bankstringRequired

The name of the bank where the account is held.

currencystringRequired

Specifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.

typeAccountstringOptional

The type of bank account. CHECKING_ACOUNT, SAVINGS

accountHolderstringRequired

The full name of the account holder.

accountHolderDnistringRequired

The national identification number or tax ID of the account holder.

countrystringRequired

Country of operations for the entity, specified using the ISO 3166-1 alpha-3 standard (e.g., CHL, USA, MEX). Go to the countries page for the complete list of supported values.

createdAtstring · date-timeOptional

Timestamp indicating when the account was created.

updatedAtstring · date-timeOptional

Timestamp indicating the last update to the account details.

The bank-account object

Last updated