Setup

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

Credentials

When setting up dLocal in our dash dashboard, you will need to 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 our 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 our system.

Refunds

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