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: 32 chr.
`second_name`	String	Owner's second name. Length: 32 chr.
`last_names`	String	Owner's first last names. Length: 32 chr.
`second_last_name`	String	Owner's second last name. Length: 32 chr.
`birth_date`	String	Owner's birth date. YYYY-MM-DD. Users must be over 18 years old. Length: 10 chr.
`birth_place`	String	Owner's birth place. Length: 100 chr.
`email`	String	Owner's email. Length: 64 chr.
`phone_number`	String	Owner's cellphone number. Include DDD. Eg: Length: 7 chr.
`document`	String	Owner’s personal identification number. Eg. (XX@@-XXXX-XXXXXX) Length: 16 chr.
`document_type`	String	Owner's personal identification type. Length: 3 chr.
`nationality`	String	Owner's nationality. Owner's country code. ISO 3166-1 alpha-2-code. Length: 2 chr.
`gender`	Char	M or F. Length: 1 chr.
`marital_status`	Char	Check the marital status table below for more details. Length: 1 chr.
`occupation`	String	Account owner's employment or work activity. Check the occupation table below for more details. Length: 4 chr.
`pep`	Boolean	Politically exposed person. Length: 5 chr.
`pep_description`	String	Description of politically exposed person. Current position; start date (YYYY-MM-DD). Length: 100 chr.
`terms_and_conditions_accepted`	Boolean	Account's terms and conditions. Length: 5 chr.
`address`	Address Object	Owner's address.
`employment`	Employment Object	Owner's employment information.

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. (PA). Length: 2.
`state`	String	Owner's address state code. Length: 3 chars.
`city`	String	Owner's address city code. Length: 3 chars.
`neighborhood`	String	Owner's address neighborhood. Length: 3 chars.
`street`	String	Owner's address street. Length: 32.
`street2`	String	Additional information on street. Length: 225.
`house_number`	String	Owner's house number (floor, apartment). Length: 32.
`zip_code`	String	Owner's address ZIP code. Length: 20.
`street_references`	String	Additional address description/information. Length: 255.

Employment object

Property	Type	Description
`company`	String	Employment's name.
`start_date`	String	Date at witch the owner started to work "YYYY-MM-DD"
`occupation`	String	Owner's occupation code. Length: 3 chars.
`occupation_type`	String	Account owner's employment or work activity type. Check occupation type table below. Length: 2 chr.
`phone_number`	String	Employment's cellphone number. Include DDD. Length: 20 chars.
`salary`	Salary's object
`amount`	Number	Salary's monthly amount. Max. 2 decimal number.
`currency`	String	Salary's currency. ISO 4217. Length: 3 chars.
`address`	Address's object
`country`	String	Employment's country code. ISO 3166-1 alpha-2-code. (PA). Length: 2.
`state`	String	Employment's address state code. Length: 3 chars.
`city`	String	Employment's address city code. Length: 3 chars.
`neighborhood`	String	Employment's address neighborhood code. Length: 3 chars.
`street`	String	Employment's address street. Length: 32 chars.
`street2`	String	Employment's address description/information. Length: 255 chars.
`number`	String	Employment's address number (floor, apartment). Length: 32 chars.

Configuration object

Property	Type	Description
`credit_limit`	Number	Credit monthly amount. Max. 2 decimal numbers.

Example request

{
    "account_reference": "zKgXOYnEXI",
    "owner":
    {
        "first_name": "Juan",
        "last_names": "Perez",
        "second_name": "Optional",
        "second_last_name": "Optional",
        "birth_date": "1981-04-28",
        "email": "[email protected]",
        "phone_number": "1131223392",
        "document_type": "CI",
        "document": "30994029",
        "marital_status": "S",
        "gender": "M",
        "birth_place": "PA",
        "nationality": "PA",
        "terms_and_conditions_accepted": true,
        "pep": false,
        "pep_description": "description",
        "occupation": "146",
        "address":
        {
            "country": "PA",
            "state": "{{State ID}}",
            "city": "{{City ID}}",
            "neighborhood": "{{Neighborhood ID}}",
            "street": "Ciudad del Cabo rGtUbY",
            "street2": "Street FVGHiI",
            "house_number": "278",
            "zip_code": "01010",
            "street_references": "String"
        },
        "employment":
        {
            "company": "String",
            "start_date": "YYYY-MM-DD",
            "occupation_type": "2",
            "occupation": "146",
            "phone_number": "Optional",
            "salary":
            {
                "amount": 0,
                "currency": "USD"
            },
            "address":
            {
                "country": "PA",
                "state": "{{State ID}}",
                "city": "{{City ID}}",
                "neighborhood": "{{Neighborhood ID}}",
                "street": "",
                "street2": "",
                "number": ""
            }
        }
    },
    "configuration":
    {
        "credit_limit": 0
    },
    "description": "description",
}

{
    "account_reference": "zKgXOYnEXI",
    "description": "dLocal Wallet for LDbCpdFr xzVJMKlu",
   
    "owner":
    {
        "first_name": "Juan",
        "last_names": "Perez",
        "second_name": "Optional",
        "second_last_name": "Optional",
        "birth_date": "1981-04-28",
        "email": "[email protected]",
        "phone_number": "1131223392",
        "document_type": "CI",
        "document": "30994029",
        "marital_status": "S",
        "gender": "M",
        "birth_place": "PA",
        "nationality": "PA",
        "terms_and_conditions_accepted": true,
        "pep": false,
        "pep_description": "description",
        "occupation": "146",
        "address":
        {
            "country": "PA",
            "state": "{{State ID}}",
            "city": "{{City ID}}",
            "neighborhood": "{{Neighborhood ID}}",
            "street": "Ciudad del Cabo rGtUbY",
            "street2": "Street FVGHiI",
            "house_number": "278",
            "zip_code": "01010",
            "street_references": "String"
        },
        "employment":
        {
            "company": "String",
            "start_date": "YYYY-MM-DD",
            "occupation_type": "2",
            "occupation": "146",
            "phone_number": "Optional",
            "salary":
            {
                "amount": 0,
                "currency": "USD"
            },
            "address":
            {
                "country": "PA",
                "state": "{{State ID}}",
                "city": "{{City ID}}",
                "neighborhood": "{{Neighborhood ID}}",
                "street": "",
                "street2": "",
                "number": ""
            }
        }
    },
    "configuration":
    {
        "credit_limit": 0
    },
    "account_id": "ISGA-4-6e74c2ad431d4aa6a1be66bbeb55989f",
    "currency": "USD",
    "status": "WAITING_FOR_IMAGES",
    "status_code": "200",
    "status_detail": "Images are required.",
    "creation_date": "2022-05-24T15:03:09.518Z",
    "cards": []
}

Document type

Type	Description	Length
CI	CÉDULA DE IDENTIDAD.	6 - 9

Marital status

Status	Description
S	Single
M	Married
W	Widowed
D	Divorced

Occupations

To find the occupations ID, download the table on .csv version.

Occupation types

Find the occupation types here:

ID	Description
1	DEPENDENCY RELATIONSHIP
2	RETIRED
3	PUBLIC SERVANT
4	SELF-EMPLOYED

Address information

Download the table in xlsx version.

States, Cities & Neighborhoods

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