dLocal

This page provides an overview of the payments methods provided by the dLocal adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating dLocal within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment Method	Transaction Flows	Transaction Types
Credit card	iFrame Form & payment.js Integration	Debit, Preauthorize, Capture, Void, Register, Deregister, Refund
BankTransfer	Full-Page Redirect	Debit, Payout
Abitab	Full-Page Redirect	Debit
Baloto	Full-Page Redirect	Debit
BancoNacional	Full-Page Redirect	Debit
BNServicios	Full-Page Redirect	Debit
Boleto	Full-Page Redirect	Debit
Cash	Full-Page Redirect	Debit
Davivienda	Full-Page Redirect	Debit
Efecty	Full-Page Redirect	Debit
Fawry	Full-Page Redirect	Debit
Nequi	Full-Page Redirect	Debit
Oxxo	Full-Page Redirect	Debit
PagoEfectivo	Full-Page Redirect	Debit
PagoExpress	Full-Page Redirect	Debit
PagoFacil	Full-Page Redirect	Debit
Pix	Full-Page Redirect	Debit
PuntoPago	Full-Page Redirect	Debit
PuntoXpress	Full-Page Redirect	Debit
PayCash	Full-Page Redirect	Debit
RapiPago	Full-Page Redirect	Debit
RedPagos	Full-Page Redirect	Debit
Serviepag	Full-Page Redirect	Debit
SevenEleven	Full-Page Redirect	Debit
Sinpe	Full-Page Redirect	Debit
Speedmart	Full-Page Redirect	Debit
Tucan	Full-Page Redirect	Debit
Wafacash	Full-Page Redirect	Debit
VPay	Full-Page Redirect	Debit,

Additional Parameters

Credit card

Field	Required
customer.firstName	true
customer.lastName	true
customer.billingCountry	true
customer.nationalId	conditional please see: https://docs.dlocal.com/reference/country-reference
customer.billingAddress1	true in India
extraData.installments	true for Installments payments
extraData.installments_plan_id	false

Note: 3D-Secure behaviour is dependent on dLocal's configuration. For Mexico you may set 3dsecure explicitly to OPTIONAL.

APM & BankTransfer

Field	Required
customer.firstName	country dependent
customer.lastName	country dependent
customer.email	country dependent
customer.billingPhone	country and method dependent
customer.nationalId	country dependent
extraData.bank_id	true for BankTransfer

Payouts

Depending on the country and receiving bank, a variety of additional parameter may be required (refer to dLocal's documentation).

Options Request

You can find more information about the options request here: Options Request

Debit - BankTransfer

For BankTransfer, you may retrieve a list of available banks in a country via the Options request identifier getBankList. You can display this list to your customer having him selecting his bank. The selected bank code should be submitted as bank_id in extra data.

Credit card - Installments

To make a payment using the installments make a Debit or Preauthorize request with extraData.installments param that stores the number of installment payments that customer chose to split the payment amount by. Optionally provide the id value of installment plan object inside extraData.installments_plan_id to secure the applicable installment rate.

To create an installment plan, you need to request it via the Options request identifier installmentsPlan. The returned value is installment plan object provided by dLocal (refer to dLocal's documentation). It provides information of possible options for customer to split the payment by installments and the applicable installments rate.

Parameters

Name	Type	Required	Description
parameters.country	string	true	The country of the installments plan. 2 letters (ISO 3166-1 alpha-2)
parameters.currency	string	true	The currency of the installments plan. 3 letters (ISO 4217)
parameters.bin	string	true	The credit card bin.
parameters.amount	number	true	The amount of the installments plan