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
| Field | Value |
|---|---|
| type | SPEI |
| accountNumber | 18 Digit Account Number |
| accountType | CLABE |
Brazil
| Field | Value |
|---|---|
| type | PIX |
| accountNumber | 11 Digit Account Number |
| accountType | CPF |
Argentina
| Field | Value |
|---|---|
| type | COELSA |
| accountNumber | 22 Digit Account Number |
| accountType | CVU | CBU |
In the case of Alias being used for account type:
| Field | Description | Rules |
|---|---|---|
| **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
| Field | Value |
|---|---|
| type | ACH |
| accountNumber | 10 or 11 Digit Account Number |
| accountType | AHORRO | NEQUI |
| accountName | Bancamia |
China/HK
| Field | Value | Description |
|---|---|---|
| CustomerID | String | UUID |
| type | BANK_CN | Account type (BANK_CN) |
| fiatAccountFields | Object | Bank account details |
| accountNumber | String | Account number |
| accountType | String | Account Type |
| bankStreet | String | Bank Address |
| bankCity | String | Bank City |
| bankState | String | Bank State |
| bankPostalCode | String | Postal Code |
| networkIdentifier | String | SWIFT Code or Bank identifier |
| accountName | String | Account Name (Bank holding the account) |
USA
| Field | Value | Description |
|---|---|---|
| CustomerID | String | UUID |
| type | BANK_CN | Account type (BANK_CN) |
| fiatAccountFields | Object | Bank account details |
| accountNumber | String | Account number |
| accountType | String | Account Type |
| bankStreet | String | Bank Address |
| bankCity | String | Bank City |
| bankState | String | Bank State |
| bankPostalCode | String | Postal Code |
Updated about 22 hours ago
