HomeGuidesAPI ReferenceStatus Page
Guides

Create payout through dLocal Dashboard

Learn how to create a payout through the Merchant Dashboard.

Suggest Edits

Creating payouts from the dashboard is easy and flexible.

Payouts section

In the Payouts section, you will find all the information related to the payouts you send to your local sellers and partners.

You can follow up on the status of each payout, seeing everything that happens from the moment you create a payout to the time the deposit is made in local currency directly to the recipient’s local bank account.


2270

Merchant Dashboard Payouts section


To see the Payouts section, one must get in contact with a Technical Account Manager first.

Main options

There are two main options for this, depending on whether you would like to create Payouts individually (Single Payout) or all together within a single operation (Batch Payout). Also, there is a way to create on-hold payouts.

Read on to get familiar with the three different options to create payouts or start right away with the downloadable Batch Payouts templates by country.


Create a Single Payout

The Single Payout form can be accessed from within any of the list views in the Payouts tab, by clicking on the "+Single Payout" button.

You will then need to select a destination country, which will determine the fields you will need to fill in to ensure the payout is correctly made.

In this full view, the fields marked with a red asterisk are required for processing payouts in the chosen country. The other fields can still be used to provide additional information about the payment that may be helpful in ensuring the payment is correctly received.

📘

Country requirements

Whenever you choose a country, the fields will change depending on the required fields of that particular route.

Create a Batch Payouts

Payouts can also be created in a batch process that involves uploading a CSV input file with the required fields. This upload can be started by clicking on the "+Batch Payout" button and then choosing a destination country for the payout.

‌

This will then display the list of required fields for the uploaded file:

To successfully upload the document make sure the format is CSV. You must complete all the mandatory columns corresponding to the country you are sending the payouts. Mandatory fields will slightly vary depending on the country. If an input line is missing any of the mandatory values, the payout for that line will not be processed.

Fields description

NameDescriptionFormatExample
external_idPayout's identification (at the Merchant Dashboard).String (100 chars max)payout1234
countryPayout's identification (at the Merchant Dashboard).String (2 chars)BR
amountPayout's amount (in the currency entered in the field currency).Number (2 decimals)100
currencyPayout's currency. Each country accepts USD and local currency.String (3 chars)BRL
document_idBeneficiary's personal identification number.String (100 chars max)53033315550
beneficiary_nameBeneficiary's name or company.String (100 chars max)Thiago
beneficiary_lastnameBeneficiary's surname.String (100 chars max)Gabriel
bank_codeBeneficiary's bank code. See bank codes mapping in dLocal payouts documentation.Integer33
bank_branchBeneficiary's bank branch number.String (45 chars max)2234
bank_accountBeneficiary's bank account number.String (45 chars max)01426454-3
account_typeThe type of the account. C for checking accounts, S for savings accounts, M for Maestra accounts (only Peru).String (1 char)C
bank_nameBeneficiary's bank name.String (40 chars max)Banco Santander Brasil S.A.
notification_urlTo be provided if the notification URL is different from the notification URL defined by default. See more about notifications in dLocal payouts documentation.String (100 chars max)https://merchanturl.com/payouts
emailEmail of the beneficiary.String (100 chars max)[email protected]
document_typeBeneficiary's personal identification type.String (10 chars max)CPF
phonePhone number of the beneficiary.String (20 chars max)5580003499
addressAddress of the beneficiary.String (200 chars max)Servidao B-1 1106
postal_codePostal code of the beneficiary.String (20 chars max)27275-595
birthdateBeneficiary's birth date.String - YYYYMMDD19800113
on_holdHold the payout and set it to process later through the Merchant Dashboard.Boolean (0 or 1)1
cityCity of the beneficiary.String (100 chars max)Rio de Janeiro
extra_infoExtra info of the beneficiary in JSON format.String (500 chars max)

Downloadable templates

The first column of the Batch Payouts Templates corresponds to an external ID, this field must be completed with a new random alphanumeric ID. Please make sure you have not used the same ID before.

CountryRequired fieldsBatch payouts template
Argentina- external id
- country
- amount
- currency
- document id
- beneficiary name
- beneficiary last name
- bank account		Batch Payouts - Argentina.csv
Bangladesh- external id
- country
- amount
- currency
- beneficiary name
- beneficiary last name
- bank branch
- bank account
- phone		Batch Payouts - Bangladesh.csv
Bolivia- external id
- country
- amount
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- document type		Batch Payouts - Bolivia.csv
Chileexternal id
- country
- amount
- currency
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- document type		Batch Payouts - Chile.csv
China- external id
- country
- amount
- currency
- document id
- beneficiary name
- bank branch
- bank account
- phone		Batch Payouts - China.csv
Colombia- external id
- country
- amount
- currency
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- account type
- email
- document type
- address		Batch Payouts - Colombia.csv
Costa Rica- external id
- country
- amount
- document id
- beneficiary name
- beneficiary last name
- bank account
- document type
- address		Batch Payouts - Costa Rica.csv
Dominican Republic- external id
- country
- amount
- currency
- document id
- beneficiary name
- beneficiary last name
- bank account
- bank code
- document type
- account type		Coming soon
Ecuador- external id
- country
- amount
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- account type
- document type		Batch Payouts - Ecuador.csv
Egypt- external id
- country
- amount
- currency
- beneficiary name
- bank branch
- bank account
- purpose		Batch Payouts - Egypt.csv
India- external id
- country
- amount
- currency
- beneficiary name
- beneficiary last name
- bank code
- bank branch
- bank account
- email
- phone
- address		Batch Payouts - India.csv
Mexico- external id
- country
- amount
- beneficiary name
- beneficiary last name
- bank account
- bank code		Batch Payouts - Mexico.csv
Morocco- external id
- country
- amount
- beneficiary name
- beneficiary last name
- bank account
- address		Batch Payouts - Morocco.csv
Nigeria- external id
- country
- amount
- beneficiary name
- beneficiary last name
- bank code
- bank account		Batch Payouts - Nigeria.csv
Panama- external id
- country
- amount
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- account type		Batch Payouts - Panama.csv
Paraguay- external id
- country
- amount
- currency
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- document type		Batch Payouts - Paraguay.csv
Peru- external id
- country
- amount
- document id
- beneficiary name
- beneficiary last name
- bank account
- account type
- document type		Batch Payouts - Peru.csv
Philippines- external id
- country
- amount
- currency
- beneficiary name
- beneficiary last name
- bank code
- bank account
- phone		Batch Payouts - Philippines Bank transfers.csv
Thailand- external id
- country
- amount
- currency
- beneficiary name
- beneficiary last name
- bank code
- bank account
- phone		Batch Payouts - Thailand.csv
Uruguay- external id
- country
- amount
- document id
- beneficiary name
- beneficiary last name
- bank code
- bank account
- document type *only if RUT or PASS
- bank branch *only if bank is Santande
- account type *only if bank is BROU		Batch Payouts - Uruguay.csv
Vietnam- external id
- country
- amount
- currency
- beneficiary name
- beneficiary last name
- bank code
- bank account
- phone		Batch Payouts - Vietnam.csv

Create On-hold payouts

On-hold Payout section

The On-hold payouts section displays all the payouts that have been uploaded with the on-hold status (either through the API or the dashboard) and need to be confirmed in order to be processed.

Change payout status

On-hold payouts can be Cancelled or Processed by clicking on the 'Action' button. Once a payout is processed it will be listed in the 'Payouts list' section and its status will be Received. If the payout is canceled, the payment changes to Cancelled and modifies the value because it is no longer in transit.

How to create a Payout

In order to upload a payout with the On-hold status, you need to make sure you input 1 in the on_hold column. The payout will be listed in the On-hold section of the Merchant Dashboard to be processed later.

📘

Upload options

Payouts can be uploaded from any section in the dashboard where the "+Batch Payout" and "+Single Payout" buttons are available.


ℹ️

Payout status

See the detailed information on each status on the Payout status page.

Updated over 1 year ago

© 2024 DLOCAL. ALL RIGHTS RESERVED

Dlocal LLP (Company Number UK OC413287) is a limited liability partnership incorporated in England and Wales. DLocal Limited (Company Registration Number C77538) is authorised by the Malta Financial Services Authority under the Financial Institutions Act for the issuance of electronic money and the provision of payment services. Dlocal Corp LLP (Company Number UK OC 424987) is registered as a Money Service Business (MSB) with Financial Crime Enforcement Network in United States of America (USA) under MSB Registration Numbers 31000193620515. Dlocal Corp LLP acts as agent of e-commerce merchants based in the USA, and collects payments from end users based in emerging markets, on behalf of the merchants.