Bank account

Rail overview

Use BANK_ACCOUNT as a generic payout destination when a country-specific rail is not available or the recipient is represented by account and routing details.

The payment leaves the Conomy account after capture and continues through provider processing until the bank confirms receipt or failure.

Region Multi-country

Currency Rail currency

Direction Pay-out

Model External bank account

Prefer country-native rails such as CVU, BREB, SPEI, ACH, SEPA, or PIX when they are available because they provide better validation and reconciliation data.

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": "lucia@example.com",
    "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.

Object

idstring

Unique identifier for the bank account.

externalIdstring

External reference identifier for integrations.

accountNumberstringrequired

The bank account number.

nicknamestring

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.

typeAccountstring

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

Timestamp indicating when the account was created.

updatedAtstring

Timestamp indicating the last update to the account details.