KYC information requirement
Explore the detailed information requirements for the different types of User accounts.
Requirements could be different depending on the entity type and country.
Entities types
| Entity type | Description |
|---|---|
| Company | A legal entity or business organization registered to engage in commercial activities. It is identified by their legal name, business registration details, and relevant tax identification numbers. |
| Individual | A natural person who is acting on their own behalf. It is identified by their personal details, including their legal name, identification documents, and other relevant identification numbers. |
Request information detail
The onboarding information contains multiple components to take into account.
| Information | Description | Company | Individual |
|---|---|---|---|
| Basic account information | The basic account information includes email, account name, merchant type, notification URL, and operating country of the users. External ID should be the ID you assigned to the users in your system, it can help you link the account with your system. The external ID should be unique in each Platform account. | Required | Required |
| Company information | The company information is for both, Individuals and Companies. Depending on the entity type and country, it has different requirements. | Required | Some fields are required. |
| Legal representative | The legal representative is an individual who is authorized to act on behalf of the company and holds the authority to sign for all company operational activities. | Required | - |
| UBOs | A UBO or Ultimate Beneficial Owner is an individual who ultimately owns or controls the company. The definition of who constitutes a UBO may differ between jurisdictions, but generally, a UBO is defined as an individual who owns a minimum of 10-25% (dependent on the jurisdiction) of capital or voting rights in the underlying entity. | Required | - |
| Settings | These settings can be customized per User account. If left empty, the configuration of user accounts will align with the definitions set for the platform account. | Required | Required |
Reponse detail
Important items we will include in the response:
| Fields | Description |
|---|---|
| Account ID | It's the unique ID in the dLocal system, make sure you save it in your system. All the following actions and queries should be based on this. |
| Status | It's the status code, message, and details. Please refer to Account status for detailed information. |
| UBO ID | It's the unique UBO ID in the dLocal system, make sure you save it/them in your system. It will be used to match the UBOs and the uploaded documents' belongings later. For companies with multiple UBOs, we will get back to you with the ubo_id fields. |
Code samples
Company
{
"platform_type": "MERCHANTNAME",
"account_name": "Sub Merchnat Company Name",
"account_email": "[email protected]",
"account_country": "BR",
"account_external_reference": "2352362346",
"notification_url": "https://marketplace.com/notifications",
"company_information": {
"tax_id": "27327331561",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"website": "www.website.com",
"registered_name": "company name S.A.",
"date_of_incorporation": "2020-05-01",
"email": "[email protected]",
"annual_sales_in_usd": "10000.00",
"industry_code": 100,
"phone": "+5493426123789",
"is_so": false,
"legal_address": {
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234"
},
"legal_representative": {
"tax_id": "27327331561",
"name":"Jone Smith",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"nationality": "BR",
"date_of_birth": "1990-04-25",
"phone": "+5493426123789",
"email": "[email protected]",
"is_pep": false,
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234"
},
"ubos": [{
"tax_id": "27327331561",
"name":"Jone Smith",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"nationality": "BR",
"date_of_birth": "1990-04-25",
"phone": "+5493426123789",
"email": "[email protected]",
"is_pep": false,
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234",
"ownership_percentage": 15.5
}]
},
"settings": {
"pricing_level": "type_1",
"settlement_period": 7,
}
}
{
"account_id": "d907f733-5e17-4470-b963-c2ac2c11a440",
"status": "APPROVED",
"status_code": 200,
"status_detail": "approved",
"creation_date": "2021-07-12T12:07:08-00:00",
"platform_type": "MERCHANTNAME",
"account_name": "Sub Merchnat Company Name",
"account_email": "[email protected]",
"account_country": "BR",
"account_external_reference": "2352362346",
"notification_url": "https://marketplace.com/notifications",
"company_information": {
"tax_id": "27327331561",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"website": "www.website.com",
"registered_name": "company name S.A.",
"date_of_incorporation": "2020-05-01",
"email": "[email protected]",
"annual_sales_in_usd": "10000.00",
"industry_code": 100,
"phone": "+5493426123789",
"is_so": false,
"legal_address": {
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234"
},
"legal_representative": {
"tax_id": "27327331561",
"name":"Jone Smith",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"nationality": "BR",
"date_of_birth": "1990-04-25",
"phone": "+5493426123789",
"email": "[email protected]",
"is_pep": false,
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234"
},
"ubos": [{
"tax_id": "27327331561",
"name":"Jone Smith",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"nationality": "BR",
"date_of_birth": "1990-04-25",
"phone": "+5493426123789",
"email": "[email protected]",
"is_pep": false,
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234",
"ownership_percentage": 15.5,
"ubos_id": "123456"
}]
},
"settings": {
"pricing_level": "type_1",
"settlement_period": 7,
}
}
Individual
{
"platform_type": "MERCHANTNAME",
"account_name": "Sub Merchnat Company Name",
"account_email": "[email protected]",
"account_country": "BR",
"account_external_reference": "2352362346",
"notification_url": "https://marketplace.com/notifications",
"company_information": {
"tax_id": "27327331561",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"website": "www.website.com",
"registered_name": "company name S.A.",
"email": "[email protected]",
"annual_sales_in_usd": "10000.00",
"industry_code": 100,
"phone": "+5493426123789",
"is_so": false,
"is_pep": false,
"legal_address": {
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234"
},
},
"settings": {
"pricing_level": "type_1",
"settlement_period": 7,
}
}
{
"account_id": "d907f733-5e17-4470-b963-c2ac2c11a440",
"status": "APPROVED",
"status_code": 200,
"status_detail": "approved",
"creation_date": "2021-07-12T12:07:08-00:00",
"platform_type": "MERCHANTNAME",
"account_name": "Sub Merchnat Company Name",
"account_email": "[email protected]",
"account_country": "BR",
"account_external_reference": "2352362346",
"notification_url": "https://marketplace.com/notifications",
"company_information": {
"tax_id": "27327331561",
"document_type": "DNI",
"document_number": "32733156",
"document_expedition_date": "2012-06-28",
"website": "www.website.com",
"registered_name": "company name S.A.",
"email": "[email protected]",
"annual_sales_in_usd": "10000.00",
"industry_code": 100,
"phone": "+5493426123789",
"is_so": false,
"is_pep": false,
"legal_address": {
"country": "UY",
"city": "Montevideo",
"zip_code": "11300",
"address": "Dr. Luis Bonavita 1234"
},
},
"settings": {
"pricing_level": "type_1",
"settlement_period": 7,
}
}
Updated 7 months ago