Sign in

v1

latestOpenAPI 3.1.02026-07-245361280.3 KB
Onboard accounts

Create an account

Creates a new account.

post/v2/accounts

Request body

OR

Example request

{
  "platform_type": "MERCHANTNAME",
  "tax_category": "company",
  "account_name": "Account Company Name",
  "account_email": "account@email.com",
  "account_country": "UY",
  "notification_url": "https://marketplace.com/notifications",
  "consents": [
    {
      "type": "DATA_COLLECTION",
      "name": "John Doe",
      "accepted": true
    }
  ],
  "company_information": {
    "document_type": "DNI",
    "document_expedition_date": "2012-06-28",
    "website": "www.website.com",
    "registered_name": "Company Name S.A.",
    "date_of_incoporation": "2020-05-01",
    "email": "compliance@email.com",
    "ip_address": "127.0.0.1",
    "legal_address": {
      "country": "UY",
      "city": "Montevideo",
      "address": "Dr. Luis Bonavita 1234"
    },
    "legal_representative": {
      "document_type": "DNI",
      "document_expedition_date": "2012-06-28",
      "name": "Name",
      "nationality": "UY",
      "date_of_birth": "1990-04-25",
      "email": "legalrepresentative@email.com",
      "country": "UY",
      "city": "Montevideo",
      "address": "Dr. Luis Bonavita 1234"
    },
    "ubos": [
      {
        "document_type": "DNI",
        "document_expedition_date": "2012-06-28",
        "name": "Jose Lopez",
        "nationality": "UY",
        "country": "UY",
        "city": "Montevideo",
        "address": "Dr. Luis Bonavita 1234",
        "date_of_birth": "1990-04-25",
        "email": "legalrepresentative@email.com",
        "ownership_percentage": 15.5
      }
    ]
  },
  "settings": {
    "pricing_level": "type_1",
    "settlement_period": 7,
    "installments_responsible": "merchant",
    "settlements": [
      {
        "config_delay_days": 7,
        "country_code": "AR",
        "payment_method_type": "CARD",
        "payment_method_id": "VD"
      }
    ]
  }
}

Response

OK

account_idstring

User’s dLocal account ID.

account_external_referencestring byte

ID given by the merchant in their system.

statusstring

Account status. <br><br> See details.

status_codenumber

Account status code. <br><br> See details.

status_detailstring

Account status detail.

creation_datestring date

Account creation’s timestamp. ISO-8601 - Notification’s timestamp (YYYY-MM-DDTHH:mm:ss.SSSSZ).

ubo_idstring

UBOs ID created at dLocal. When uploading documents, this field is required to identify the document’s UBO.

Example response

{
  "account_id": "d907f733-5e17-4470-b963-f2ac2c11a440",
  "status": "APPROVED",
  "status_code": 200,
  "status_detail": "approved",
  "creation_date": "2021-07-12T12:07:08-00:00",
  "consents": [
    {
      "type": "DATA_COLLECTION",
      "name": "John Doe",
      "accepted": true,
      "updated_date": "2021-07-12T12:07:08-00:00"
    }
  ]
}