🇨🇷 Costa Rica

Costa Rica onboarding has jurisdiction-specific identity requirements that should be validated early in integration.


Exchange profile

FieldValue
ExchangeCOSTA_RICA
Main fiat currencyCRC
Typical local railsBank transfer

Identity rules (legalId)

In Costa Rica, supported legal IDs are:

  • CI / CJ
  • DIMEX

Accepted formats:

  • CI: /^[1-9]{1}-?\d{4}-?\d{4}$/
  • CJ: /^[1-9]{1}-?\d{3}-?\d{6}$/
  • DIMEX: /^[1-2]\d{10,11}$/

Documentation requirements

Identity images are required according to onboarding/limit controls.

Use Upload Identity Image for signed upload URLs.


Payload guidance

Validate at least:

  • legalId
  • exchange: "COSTA_RICA"
  • name, surname, sex
  • birthDate, phoneNumber, nationality, maritalStatus
  • address.street

Request example

{
  "externalId": "onboardingApiCryptoCRC",
  "email": "[email protected]",
  "legalId": "1-1234-5678",
  "type": "INDIVIDUAL",
  "exchange": "COSTA_RICA",
  "personalData": {
    "name": "JOHN",
    "surname": "DOE",
    "sex": "M",
    "work": "SERVICIOS RELACIONADOS CON LA SALUD HUMANA N.C.P.",
    "birthDate": "1990-01-01",
    "isPep": false,
    "isFacta": false,
    "isFep": false,
    "phoneNumber": "50688881234",
    "nationality": "Costa Rica",
    "maritalStatus": "Soltero",
    "address": {
      "street": "AVENIDA CENTRAL",
      "postalCode": "10101",
      "locality": "SAN JOSE",
      "province": "SAN JOSE",
      "numeration": "120",
      "floor": "-",
      "apartment": ""
    }
  },
  "banking": {
    "accounts": [
      {
        "cbu": "15201001234567890",
        "currency": "CRC",
        "description": "Cta CRC",
        "bank": {
          "code": "152"
        },
        "accountType": "SAVINGS"
      }
    ]
  }
}

Example entrypoint

Then use missing-data and onboarding-task endpoints to complete remaining requirements before operating.


Did this page help you?