Skip to main content

​
How to Configure dLocal Go?

​
Step 1: Getting dLocal Go API Credentials

  1. Go to the dLocal Go website.
  2. Sign up for an account or log in if you already have one.
  3. Open the Dashboard and navigate to Integrations > API Keys.
  4. Copy the X-Login (API Key) and the X-Trans-Key (API Secret).
The X-Trans-Key is your secret — treat it like a password. Never expose it in client-side code or commit it to a public repository.

​
Step 2: Configure the Notification URL

dLocal Go uses a single notification URL to confirm payments after the customer completes checkout on its hosted page. In your dLocal Go dashboard, set the notification URL to:
The exact URL with your store’s domain is shown next to the dLocal Go section in the admin panel.

​
Step 3: Enable dLocal Go in the Admin Panel

1

Open Payment Gateways

Go to Settings > Payment Gateways in the sidebar.
2

Find dLocal Go

Scroll down to the dLocal Go section.
3

Enable the Method

Toggle the dLocal Go switch on, then click Configure to expand the settings.
4

Enter API Credentials

Paste your API Key (X-Login) and API Secret (X-Trans-Key) in the corresponding fields.
5

Set the Default Country

Enter the default country code in ISO 3166-1 alpha-2 format (e.g. BR, MX, AR, CL, CO, PE). This is the country dLocal Go will route the transaction through when the buyer’s country cannot be inferred.
6

Set the Charge Currency

Enter the currency customers will be charged in (e.g. USD, BRL, MXN). The selected currency must be supported by dLocal Go for the chosen country.
7

Save Changes

Click on the Save Changes button.

​
Settings Reference

​
How It Works

  1. The customer clicks Pay with dLocal Go at checkout.
  2. The platform calls dLocal Go’s /v1/payments API with the order ID, amount and currency, then redirects the customer to dLocal Go’s hosted payment page.
  3. The customer pays using any local method supported by dLocal Go for their country.
  4. On completion, dLocal Go calls the notification URL on your store. The platform verifies the payment by calling dLocal Go’s /v1/payments/{id} API and compares the amount before delivering the package.
If your store’s base currency differs from the configured Charge Currency, the platform automatically converts the order total using the exchange rate configured in Settings > Currencies.

​
Handled Webhook Statuses

​
Troubleshooting

'dLocal Go is not configured properly' on checkout

Make sure both API Key and API Secret are filled in Settings > Payment Gateways > dLocal Go, and that the dLocal Go switch is enabled.

Notification URL not firing

Confirm the URL in your dLocal Go dashboard matches the one shown in your admin panel exactly, and that your store is reachable over HTTPS from the public internet.

Currency not configured in the system

If your Charge Currency differs from the store’s base currency, the conversion currency must also exist in Settings > Currencies with a valid exchange rate.