Adding a Bank Account

How to register FIAT accounts by Country

Once a customer has completed the KYC requirements in the contextual country, the next step is to attach a payment method.

To add the customer's FIAT bank account, simply call the Create Payment Method endpoint.

To view a list of the required fields to add a payment method, use the List Payment Methods Requirements endpoint.

Best Practices

Always ensure the customer has completed KYC/KYB verification before adding a payment method.

Use the List Payment Method Requirements endpoint to dynamically retrieve required fields by country.

Validate bank account formats before submitting requests to reduce errors.

Store payment method identifiers securely, as they will be required when initiating transactions.

Mexico

FieldValue
typeSPEI
accountNumber18 Digit Account Number
accountTypeCLABE

Brazil

FieldValue
typePIX
accountNumber11 Digit Account Number
accountTypeCPF

Argentina

FieldValue
typeCOELSA
accountNumber22 Digit Account Number
accountTypeCVU | CBU

In the case of Alias being used for account type:

FieldDescriptionRules
**Alias **Unique identifier for the virtual account.Allowed characters in account number: letters (a–z, A–Z), numbers (0–9), hyphen (-), and dot (.) Length: 6 to 20 characters Must be unique across the system

⚠️ Note: The alias can only be modified once every 24 hours.

Colombia

FieldValue
typeACH
accountNumber10 or 11 Digit Account Number
accountTypeAHORRO | NEQUI
accountNameBancamia

China/HK

FieldValueDescription
CustomerIDStringUUID
typeBANK_CNAccount type (BANK_CN)
fiatAccountFieldsObjectBank account details
accountNumberStringAccount number
accountTypeStringAccount Type
bankStreetStringBank Address
bankCityStringBank City
bankStateStringBank State
bankPostalCodeStringPostal Code
networkIdentifierStringSWIFT Code or Bank identifier
accountNameStringAccount Name (Bank holding the account)

USA

FieldValueDescription
CustomerIDStringUUID
typeBANK_CNAccount type (BANK_CN)
fiatAccountFieldsObjectBank account details
accountNumberStringAccount number
accountTypeStringAccount Type
bankStreetStringBank Address
bankCityStringBank City
bankStateStringBank State
bankPostalCodeStringPostal Code