dLocal - Tarjeta Clave

This page presents all information related to the dLocal connection using Tarjeta Clave as payment. Use the following buttons to navigate to the desired section.

Connecting with Yuno

Mandatory fields when integrating via Yuno:

first_name
last_name
email
document_number
telehpone_number

General information

Countries:

Panama-flag
Panama

Currencies:

USD

Payment methods:

debit card
Debit card

Minimum amount:

1 USD.

Maximum amount:

1500 USD.

TRX limit:

dLocal's fraud motor has velocity rules. Because of security these can't be shared.

TRX without CVV:

No

Purchase TRX:

Payments with debit card.

Support for recurrency:

No

Webhooks:

Yes

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

Yes

Time to request refund:

Between 120 and 180 days.

Time to process refund:

7 days.

Voids

Void support:

Yes

Void to Refund:

No

Chargebacks

Notifications of chargebacks:

Yes

Defined period to make a chargeback:

Between 120 and 150 days.

Endpoint for disputes:

Yes

Maximum time to dispute a chargeback (provide evidence):

5 days.

Security

E3DS v2:

No

Testing guidelines for sandbox environment

Necessary fields for testing:

X-Login, X-Trans-Key and Secret Key.

Limitations/Specifications for testing:

You can test payments using the Create a Payment API method, just remember to use the https://sandbox.dlocal.com/payments endpoint.

If you want to test the response of all possible errors, you can do so with the following trick exclusive for sandbox:
  • On the description body parameter of the Create a payment you can include the error code that you want the payment to result to.
  • For example, description: “302” will result in the payment being rejected with the error: “Insufficient Amount”.
  • You can check the full list of codes available whenever you need.

Integration configuration

Credentials and steps to obtain them:

There are two types of credentials: Sandbox credentials and Production Credentials. You can get both from your same account in the Merchant Dashboard. You just have to change between the Test and the Live modes by pressing the toggle at the top bar and then find the corresponding credentials in Settings > Integration.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select dLocal.
  3. Click Connect.
  4. Introduce Name,X-Login, X-Trans-Key and Secret Key.
  5. Click Connect

Configuration of webhooks in partner:

In the Merchant Dashboard go to Settings > Integration, scroll to Endpoint configuration and set up Payins notification URL and Refunds and Chargebacks URL.

Production environment

Specific procedure for a merchant to go live:

Make a connection test to validate that the IPs are configured correctly performing a GET at the endpoint of payment methods. Additionally, it is recommended to make a satisfactory test in each country to go live. Some PSP go one step further and test for main brand: Amex, Visa and Master.