Skip to main content
dLocal is a global payments platform that helps you accept local payment methods and cards across emerging markets.

​
Supported payment methods

Integration shows how the buyer pays:
  • Direct: you send card or bank account details through Gr4vy, using Embed, Secure Fields, or the API. Gr4vy stores bank accounts. See Bank payments.
  • Redirect: the buyer completes the payment on the provider’s page, and the provider keeps their details.
  • Redirect or SDK: as redirect, or you can use the provider’s own SDK or components in place of the redirect. See the method’s page.

​
Setup

To create a dLocal account please contact the dLocal Sales Team.

​
Credentials

When setting up dLocal in the dashboard, configure the following credentials, which can all be obtained from the Settings -> Integration section of the dLocal dashboard.
  • X login - API key necessary to authenticate your request.
  • X trans key - API key necessary to authenticate your request.
  • Secret Key - Use for the creation of the Authorization.
  • Merchant name - Your merchant name
Please refer to the dLocal documentation For more information on their API credentials
Gr4vy checks the signature on every dLocal notification with the X login and Secret Key configured in the dashboard, and ignores notifications that don’t match. If your dLocal account has more than one set of API credentials, make sure dLocal signs notifications with the set you enter in Gr4vy. Ask your dLocal contact which credentials are selected for notifications. Otherwise, payments that complete after the initial request, for example after 3D Secure, can stay processing.

​
Required fields

Many of the payment methods supported dLocal require some of the buyer data to be passed, for example the buyer’s name, email, or tax ID. Once configured, you can use the payment options API to query the exact required_fields for each method.

​
Supported methods

Please contact the dLocal support team to get any of the payment methods enabled on your account. If not enabled, you may see a transaction fail in the system.

​
Refunds

In many cases, a refund requires the buyer to provide their bank details to process a refund. In these situations, the buyer receives an email with a link to complete the reversal of the payment. Until that link has been followed, a refund is marked as processing in the system.