Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.minestorecms.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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: 
https://<your-store-domain>/api/payments/handle/dlocalgo
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

FieldMeaning
API Key (X-Login)Public API identifier issued by dLocal Go.
API Secret (X-Trans-Key)Secret key paired with the API Key — used to sign payment requests.
Default CountryISO 3166-1 alpha-2 country code, e.g. BR, MX, AR. Drives the available local methods on the hosted page.
Charge CurrencyCurrency in which customers are billed. Must be supported by dLocal Go for the selected country.

​
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

dLocal Go StatusEffect on the Order
PAIDOrder is marked as paid and the package is delivered.
REJECTEDOrder is marked as failed.
CANCELLEDOrder is marked as failed.
EXPIREDOrder is marked as failed.
REFUNDEDOrder is reversed (commands are revoked where supported).
Any other statusAcknowledged but not acted on (e.g. PENDING).

​
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.