Skip to main content

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

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.