Colombia

See all the information for the creation of an account for Colombia.

Flow

Flow for creation of Colombian ​accounts.Flow for creation of Colombian ​accounts.

Flow for creation of Colombian ​accounts.

📘

To create a card, the account must be activated.

Mandatory parameters

Owner object

PropertyTypeDescription
first_nameStringOwner's first name.

Length: 50.
last_namesStringOwner's complete last names.

Length: 50.
birth_dateStringOwner's birth date. YYYY-MM-DD. Users must be over 18 years old.

Length: 10.
emailStringOwner's email.

Length: 64.
phone_numberStringOwner's cellphone number. (Area code + phone number).

Length: 10.
documentStringOwner’s personal identification number.

Length: 20.
document_typeStringOwner's personal identification type.

Length: 3.
expedition_dateStringOwner's personal identification expedition date. YYYY-MM-DD.

Note that for tests in Sandbox mode, the birth_date and the expedition_date must be +18 years old apart.

Length: 10.
genderCharM or F.

Length: 1.
marital_statusCharCheck the marital status table below for more details.

Length: 1.
ip_addressStringOwner's IP Address. Colombian IP is only allowed.

Length: 40.
terms_and_conditions_acceptedBooleanAccount's terms and conditions.

Length: 5.
data_management_acceptedBooleanAccount's data management.

Length: 5.
addressAddress ObjectOwner's address.

Address object

Find more details of the city and state fields on Address Information.

PropertyTypeDescription
countryStringOwner's country code. ISO 3166-1 alpha-2-code. (CO).

Length: 2.
cityStringOwner's address city code.

Length: 5.
stateStringOwner's address state code.

Length: 3.
streetStringOwner's address street.

Length: 200.

Device fingerprint

Find more details of the fields on Device information.

PropertyTypeDescription
hdm_dataStringDevice's fingerprint codified.
payloadStringDevice's fingerprint.

Example Request

{
    "account_reference": "AZM4TCR3R0",
    "owner": {
        "first_name": "Juan",
        "last_names": "Perez",
        "birth_date": "1965-06-17",
        "email": "[email protected]",
        "phone_number": "4680719930",
        "document": "5292831488",
        "address": {
            "country": "CO",
            "city": "1",
            "state": "1",
            "street": "Carrera 74 KwJErq"
        },
        "marital_status": "S",
        "gender": "M",
        "document_type": "CC",
        "data_management_accepted": true,
        "terms_and_conditions_accepted": true,
        "expedition_date": "2021-06-15",
        "ip_address": "123.198.222.231"
    },
    "description": "dLocal Wallet for LHQsiIQg kBhSrwsd",
    "payload": ".Ga44j1eJNlY5BSo9z4[...]ofjb75PaK4Vpjt3Q9cUVlOrXTA",
    "hdm_data": "rO0ABXNyACdjb20u[...]dGhlNDEuY29tbW9ucy5"
}
{
    "account_reference": "AZM4TCR3R0",
    "description": "dLocal Wallet for LHQsiIQg kBhSrwsd",
    "owner": {
        "first_name": "Jose",
        "last_names": "Perez",
        "birth_date": "1965-06-17",
        "email": "[email protected]",
        "phone_number": "4680719930",
        "document": "5292831488",
        "expedition_date": "2021-06-15",
        "address": {
            "country": "CO",
            "city": "1",
            "state": "1",
            "street": "Carrera 74 KwJErq",
            "street2": "Carrera 74 kIMBde",
            "house_number": "52",
            "zip_code": "05001000",
            "neighbourhood": "Casa"
        },
        "marital_status": "S",
        "gender": "M",
        "birth_place": "Colombia",
        "nationality": "Colombian",
        "document_type": "CC",
        "ip_address": "123.198.222.231",
        "terms_and_conditions_accepted": true,
        "data_management_accepted": true
    },
    "account_id": "ISGA-4-647052b175dd4033986512788bcbbd9d",
    "currency": "COP",
    "status": "WAITING_FOR_OTP_EMAIL",
    "status_code": "201",
    "status_detail": "OTP EMAIL is required.",
    "creation_date": "2021-11-23T18:48:10.811Z",
    "cards": []
}

Document type

TypeDescriptionLength
CCCédula de ciudadaníaBetween 6 to 10

Marital status

StatusDescription
SSingle
MMarried
WWidowed
DDivorced

Device information

The following parameters are required to get device information:

PropertyTypeDescription
hdm_dataStringDevice's fingerprint codified.
payloadStringDevice's fingerprint.

Web

Add the following script on the website:

<html>
  <head>
      <script src="/static/scripts/cx_disp.js"></script>
  </head>
  <body class="dl" onload="cx.initiate(null)">
      <form id="form">
        <input type="hidden" name="user_conutils" id="user_conutils" value="" />
        <input type="hidden" name="user_conutils2" id="user_conutils2" value="" />
      </form>
  </body>
</html>

Download script

App

Use the following SDK to get mobile device information.

Download SDK

Address information

States, Cities, and Zip code Catalogue

Download the table in xlsx version.