dLocal - Cards
This page presents all information related to the dLocal connection using Cards as payment. Use the following buttons to navigate to the desired section.
Connecting with Yuno
Mandatory fields when integrating via Yuno:
last_name
document_number
country(transaction) *The provider may request additional fields according to the merchant or to improve the approval rate.
General information
Countries:
Currencies:
ARS, BOB, BRL, CLP, COP, CRC, DOP, USD, GTQ, HNL, MXN, NIO, PYG, PEN, UYU, BDT, XAF, CNY, EGP, GHS, INR, IDR, X0F, YEN, KES, MYR, MAD, NGN, PKR, PHP, RWF, ZAR, TZS, THB, TRY, UGX, VND
Payment methods:
Minimum amount:
Maximum amount:
Depends on issuing bank.
TRX limit:
dLocal's fraud motor has velocity rules. Because of security these can't be shared.
Support of international BIN:
Yes
Activation of functionality:
Yes
TRX without CVV:
Yes. Must be requested during setup.
Purchase TRX in 1-Step:
Yes
Purchase TRX in 2-Step:
Yes
Support for recurrency:
Yes
Webhooks:
Yes
Captures
Partial capture:
Yes
Multiple captures:
Yes
Maximum time to capture an authorization:
7 days.
Captures over the amount of authorization:
Yes, for some countries. In case it is not supported, a solution by dLocal can simulate the operation.
Maximum amount:
When simulated by dLocal, there are no limits.
Refunds
Refund support:
Yes
Partial refunds:
Yes
Multiple refunds:
Yes
Time to request refund:
Between 120 and 180 days.
Time to process refund:
Depends on each country's issuing banks. Can take up to two billing cycles.
Voids
Void support:
Yes
Void to authorization:
Yes
Void to refund:
No
Installments
Capability to define the installments when creating the payment:
Yes
GET endpoint available for retrieving the permitted BIN for the installments:
Yes
Possibility to choose who will be responsible for financing installments:
No, this is configured account-level.
Conditions or restrictions:
International cards don't operate with installments.
Deferral date availability:
No
Grace period:
No
Minimum number of Installments (#months):
These information can be obtained from dLocal's API.
Maximum number of Installments (#months):
These information can be obtained from dLocal's API.
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:
Yes
Testing guidelines for sandbox environment
Necessary fields for testing:
Limitations/Specifications for testing:
In Sandbox, all Credit Card payments are automatically approved by default. 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:
Dashboard configuration:
- Log in to dashboard.y.uno.
- Click Connections and then select dLocal.
- Click Connect.
- Introduce Name,X-Login, X-Trans-Key and Secret Key.
- Click Connect
Configuration of webhooks in partner:
Production environment
Specific procedure for a merchant to go live:
Updated 3 months ago