Flow

📘
To create a card, the account could be in PENDING status and it will activate when the card creation process is completed.

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. Length: 20.
document	String	Owner’s personal identification number. Length: 20.
document_type	String	Owner's personal identification type. Length: 3.
nationality	String	Owner's nationality. Owner's country code. ISO 3166-1 alpha-2-code. Length: 2.
gender	Char	M or F. Length: 1.
marital_status	Char	Check the marital status table below for more details. Length: 1.
tax_identifier	String	Owner's Tax Identifier (RFC). Length: 20.
terms_and_conditions_accepted	Boolean	Account's terms and conditions. Length: 5.
address	Address Object	Owner's address.

Address object

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

Property	Type	Description
country	String	Owner's country code. ISO 3166-1 alpha-2-code. (MX). 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.
zip_code	String	Owner's address ZIP code. Length: 20.

Example request

{
    "account_reference": "eKNDoyhdAf",
    "owner": {
        "first_name": "Juan",
        "last_names": "Perez",
        "birth_date": "1942-04-23",
        "email": "[email protected]",
        "phone_number": "108357877062",
        "document": "12345678A",
        "address": {
            "country": "MX",
            "city": "101",
            "state": "101",
            "street": "Av. 16 de Septiembre kGlQOn",
            "street2": "Av. 16 de Septiembre oLSBYp",
            "house_number": "82",
            "zip_code": "06000",
            "neighbourhood": "Casa"
        },
        "marital_status": "S",
        "gender": "M",
        "birth_place": "Mexico",
        "nationality": "MX",
        "tax_identifier": "LOMP8206281HO",
        "terms_and_conditions_accepted": true,
        "document_type": "PAS"
    },
    "description": "dLocal Wallet for xTljEUpi VyjGEdsX",
}

{
    "account_reference": "eKNDoyhdAe",
    "description": "dLocal Wallet for xTljEUpi VyjGEdsX",
    "owner": {
        "first_name": "Juan",
        "last_names": "Perez",
        "birth_date": "1942-04-23",
        "email": "[email protected]",
        "phone_number": "108357871062",
        "document": "12345678A",
        "address": {
            "country": "MX",
            "city": "101",
            "state": "101",
            "street": "Av. 16 de Septiembre kGlQOn",
            "zip_code": "06000"
        },
        "marital_status": "S",
        "gender": "M",
        "birth_place": "Mexico",
        "nationality": "MX",
        "tax_identifier": "LOMP8206281HO",
        "terms_and_conditions_accepted": true,
        "document_type": "PAS"
    },
    "account_id": "ISGA-4-de3a5198d26f4a7582cb12ff82e8ae99",
    "currency": "MXN",
    "status": "PENDING",
    "status_code": "101",
    "status_detail": "The account is pending.",
    "creation_date": "2021-11-24T13:54:19.432Z",
    "cards": []
}

Document type

Type	Description	Length
IFE	Credencial Instituto Federal Electoral	Between 1 to 17
INE	Instituto Nacional Electoral	Between 1 to 17
PAS	Pasaporte	Between 1 to 9

Marital status

Status	Description
S	Single
M	Married
W	Widowed
D	Divorced

Address information

States

Download the table in xlsx version.

Code	Name
1	TAMAULIPAS
2	TLAXCALA
3	VERACRUZ
4	YUCATAN
5	ZACATECAS
6	BAJA CALIFORNIA NORTE
7	AGUASCALIENTES
8	BAJA CALIFORNIA SUR
9	CAMPECHE
10	CHIAPAS
11	CHIHUAHUA
12	COAHUILA
13	COLIMA
14	DISTRITO FEDERAL
15	DURANGO
16	ESTADO DE MEXICO
17	GUANAJUATO
18	GUERRERO
19	HIDALGO
20	JALISCO
21	MICHOACAN
22	MORELOS
23	NAYARIT
24	NUEVO LEON
25	OAXACA
26	PUEBLA
27	QUERETARO
28	QUINTANA ROO
29	SAN LUIS POTOSI
30	SINALOA
31	SONORA
32	TABASCO

Cities

To find the City's ID, download the table on xlsx version.