🇨🇴 Colombia

Colombia onboarding has jurisdiction-specific identity and documentation requirements that should be validated early in integration.


Exchange profile

FieldValue
ExchangeCOLOMBIA
Main fiat currencyCOP
Typical local railsBank transfer and BRE-B contexts

Identity rules (legalId)

In Colombia, supported legal IDs are:

  • NUIP
  • CC
  • PPT

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, legalIdType
  • exchange: "COLOMBIA"
  • name, surname, sex
  • birthDate, phoneNumber, nationality, maritalStatus
  • address.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.


Did this page help you?