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,
	}
}