🇨🇴 Colombia
Colombia onboarding has jurisdiction-specific identity and documentation requirements that should be validated early in integration.
Exchange profile
| Field | Value |
|---|---|
| Exchange | COLOMBIA |
| Main fiat currency | COP |
| Typical local rails | Bank transfer and BRE-B contexts |
Identity rules (legalId)
legalId)In Colombia, supported legal IDs are:
NUIPCCPPT
Accepted formats:
- NUIP:
/^\d{10}$/ - CC:
/^\d{6,10}$/ - PPT:
/^[A-Za-z0-9]{6,15}$/
Documentation requirements
Identity images are required according to onboarding/limit controls.
Use Upload Identity Image for signed upload URLs.
Payload guidance
For Colombia, these fields should be treated as required in practical onboarding flows:
legalId,legalIdTypeexchange: "COLOMBIA"name,surname,sexbirthDate,phoneNumber,nationality,maritalStatusaddress.street
Request example
{
"externalId": "user-COL",
"email": "[email protected]",
"legalId": "31250162",
"type": "INDIVIDUAL",
"exchange": "COLOMBIA",
"personalData": {
"name": "JAVIER",
"surname": "NAVAS",
"sex": "M",
"work": "SERVICIOS RELACIONADOS CON LA SALUD HUMANA N.C.P.",
"birthDate": "1990-01-01",
"isPep": false,
"isFacta": false,
"isFep": false,
"phoneNumber": "511110442880",
"nationality": "Colombia",
"maritalStatus": "Soltero",
"address": {
"street": "Cra 93#129c-91",
"postalCode": "",
"locality": "Bogota",
"province": "Bogota",
"numeration": "1",
"floor": "-",
"apartment": ""
}
},
"banking": {
"accounts": [
{
"cbu": "24091034803",
"currency": "COP",
"description": "Cta COP"
}
]
}
}Virtual accounts
Colombia supports virtual accounts in COP over BRE-B rails. Once the user is ACTIVE, assign one with:
{
"userAnyId": "100009793",
"asset": "COP",
"externalId": "user-acc-cop-001"
}Foreign legalIdNationality is allowed. See POST /wallet/v1/user-actions/assign-virtual-account.
Deposit address
Each user can get a permanent deposit address for ramps: an individualized Bre-B key, assigned only to that user but not held in their name. Assign it once the user is ACTIVE; deposits the user sends to it are credited to their balance. The key can be issued after the call returns; in that case the response has no address yet and it becomes available on the user once issued.
{
"userAnyId": "100009793",
"asset": "COP",
"externalId": "user-dep-cop-001"
}See POST /crypto/v2/user-actions/assign-deposit-address.
Example entrypoint
Then use missing-data and onboarding-task endpoints to complete remaining requirements before operating.
Updated 27 days ago