Flow

📘
To create a card, the account must be activated.

Mandatory parameters

Owner object

Property	Type	Description
first_name	String	Owner's first name. Length: 50.
last_names	String	Owner's complete last names. Length: 50.
birth_date	String	Owner's birth date. YYYY-MM-DD. Users must be over 18 years old. Length: 10.
email	String	Owner's email. Length: 64.
phone_number	String	Owner's cellphone number. (Area code + phone number). Length: 10.
document	String	Owner’s personal identification number. Length: 20.
document_type	String	Owner's personal identification type. Length: 3.
expedition_date	String	Owner'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.
gender	Char	M or F. Length: 1.
marital_status	Char	Check the marital status table below for more details. Length: 1.
ip_address	String	Owner's IP Address. Colombian IP is only allowed. Length: 40.
terms_and_conditions_accepted	Boolean	Account's terms and conditions. Length: 5.
data_management_accepted	Boolean	Account's data management. Length: 5.
address	Address Object	Owner's address.

Address object

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

Property	Type	Description
country	String	Owner's country code. ISO 3166-1 alpha-2-code. (CO). Length: 2.
city	String	Owner's address city code. Length: 5.
state	String	Owner's address state code. Length: 3.
street	String	Owner's address street. Length: 200.

Device fingerprint

Find more details of the fields on Device information.

Property	Type	Description
hdm_data	String	Device's fingerprint codified.
payload	String	Device'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

Type	Description	Length
CC	Cédula de ciudadanía	Between 6 to 10

Marital status

Status	Description
S	Single
M	Married
W	Widowed
D	Divorced

Device information

The following parameters are required to get device information:

Property	Type	Description
`hdm_data`	String	Device's fingerprint codified.
`payload`	String	Device'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>

Colombia

Flow

📘

Mandatory parameters

Owner object

Address object

Device fingerprint

Example Request

Document type

Marital status

Device information

Web

App

Address information

States, Cities, and Zip code Catalogue