Flow

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.
`document_type*`	String	Owner's personal identification type. Length: 3.
`document*`	String	Owner’s personal identification number. Length: 8-9.
`phone_number*`	String	Owner's cellphone number. Do not include country area code. Do not support special characters. Length: 9.
`email*`	String	Owner's email. Length: 50.
`nationality*`	String	Owner's nationality country code. ISO 3166-1 alpha-2-code. Length: 2.
`birth_date*`	String	Owner's birth date. YYYY-MM-DD. Users must be over 18 years old. Length: 10.
`ip_address*`	String	Owner's IP address. Length: 40.
`terms_and_conditions_accepted*`	Boolean	Account's terms and conditions. Length: 5.
`address*`	Address Object	Owner's address.
`employment*`	Employment Object	Owner's employment information.

Address object

Property	Type	Description
`country*`	String	Owner's country code. ISO 3166-1 alpha-2-code. (PE). Length: 2.
`region*`	String	Owner's address region code. Length: 2.
`state*`	String	Owner's address state code. Length: 3.
`city*`	String	Owner's address city code. Length: 4.
`street*`	String	Owner's address street. Length: 30.
`house_number`	String	Owner's house number (floor, apartment). Length: 20.
`street2`	String	Additional information on street. Length: 100.
`zip_code`	String	Owner's address ZIP code. Length: 5.

Employment object

Property	Type	Description
`occupation_type*`	Integer	Account owner's employment or work activity type. Check occupation type table below.
`company`	String	Employment's name. It is a required field if occupation_type = 1 Length: 32 chr.

Example request

{
  "owner": {
    "first_name": "Sigrid",
    "last_names": "Rempel",
    "birth_date": "2004-07-01",
    "email": "[email protected]",
    "phone_number": "918902827",
    "document": "123456710",
    "expedition_date": null,
    "document_type": "CE",
    "nationality": "PE",
    "ip_address" : "127.0.0.1",
    "employment" : {
        "occupation_type" : 1,
        "company" : "Dlocal"
    },
    "address": {
      "country": "PE",
      "city": "1",
      "state": "1",
      "region": "1",
      "street": "739 Madaline Common"
    },
    "terms_and_conditions_accepted": true
  },
  "account_reference": "92076-105841"
}

{
  "owner": {
    "first_name": "Sigrid",
    "last_names": "Rempel",
    "birth_date": "2004-07-01",
    "email": "[email protected]",
    "phone_number": "918902827",
    "document": "123456710",
    "expedition_date": null,
    "document_type": "CE",
    "nationality": "PE",
    "ip_address" : "127.0.0.1",
    "employment" : {
        "occupation_type" : 1,
        "company" : "Dlocal"
    },
    "address": {
      "country": "PE",
      "city": "1",
      "state": "1",
      "region": "1",
      "street": "739 Madaline Common"
    },
    "terms_and_conditions_accepted": true
  },
  "account_reference": "92076-105841"
},
    "account_id": "ISGA-4-6e74c2ad431d4aa6a1be66bbeb55989f",
    "currency": "PEN",
    "status": "ACTIVE",
    "status_code": "300",
    "status_detail": "The account is active",
    "creation_date": "2021-11-24T15:03:09.518Z",
    "cards": []
}

Document type

Type	Description	Length
DNI	Documento Nacional de Identidad	Numeric 8.
CE	Carné de Extranjería	Numeric 9.

Occupation types

Find the occupation types here:

ID	Description
1	DEPENDENCY RELATIONSHIP
2	SELF-EMPLOYED
3	STUDENT

Peru Location's Catalogue

Download the table in xlsx version.