dLocal
Connect dLocal to PayLexer to accept card payments across Latin America, Africa, and Asia through a single hosted checkout.
dLocal is a cross-border payments platform built for emerging markets, headquartered in Montevideo, Uruguay and publicly listed on Nasdaq (DLO). Through a single integration, dLocal lets global merchants accept the local cards and payment methods that shoppers actually use across Latin America, Africa, and Asia.
- Supported Regions (Merchant Accounts): Latin America, Africa, and Asia (including Brazil, Mexico, Argentina, Colombia, India, Nigeria, South Africa, and Indonesia) - view full list
- Supported Currencies: USD, BRL, MXN, ARS, PEN, UYU, INR, IDR, MYR, EGP, TRY, BDT - view full list
Supported Features
- Hosted checkout that redirects shoppers to dLocal's secure payment page
- Card payments across 20 currencies in emerging markets
- Full and partial refunds
- Real-time webhook notifications for payments and refunds, secured with HMAC-SHA256 signatures
- Separate sandbox and live environments for safe testing
dLocal does not support subscriptions or recurring billing in PayLexer. Its recurring payments are merchant-initiated rather than scheduled by the gateway, so only one-time card payments are available.
Before You Start
Make sure you have:
- dLocal Account – Don't have one? Sign up for dLocal →
- PayLexer Account – Required to configure the integration. Create your account →
- A website where you want to integrate
You can create a dLocal sandbox account and get test credentials on your own. Moving to live payments requires completing dLocal's business onboarding and KYC review with their team.
Looking for a different payment processor? View all supported gateways →
Configuring dLocal
You need an X-Login, X-Trans-Key, and Secret Key from dLocal for this integration.
Getting API Credentials
Open the dLocal Merchant Dashboard
Log in to your dLocal Merchant Dashboard.
Go to the Integration section
Open the Integration (API credentials) section of the dashboard. This is where dLocal lists the keys for your sandbox and live environments.
Copy your credentials
Copy the three values dLocal provides:
- X-Login - identifies your merchant account on each request
- X-Trans-Key - authenticates the request alongside X-Login
- Secret Key - generates the request signature and verifies webhooks
Copy the values that match the environment you are setting up (sandbox for testing, live for real payments).
Your Secret Key is sensitive. Keep it private, never share it, and never expose it in client-side code.
Adding Credentials to PayLexer
Open PayLexer Dashboard
Log in to your PayLexer dashboard and navigate to Payment Gateways → dLocal.
Enter your credentials
Paste the X-Login, X-Trans-Key, and Secret Key you copied from dLocal into the corresponding fields.
Understanding Live/Production and Sandbox Settings:
| Environment | Purpose |
|---|---|
| Live / Production | Used for real transactions. |
| Test / Sandbox | Used for testing only. No real money is processed. |
How PayLexer selects credentials:
- Debug/Test mode ON → Test credentials are used
- Debug/Test mode OFF → Live credentials are used
Test and save
Click Save to save your configuration and verify your credentials. Click Verify Connection to test the connection.
Configuring Webhooks (Mandatory)
Webhooks enable real-time payment updates and significantly improve reliability.
Benefits of Webhooks:
- Instant payment status updates
- Automatic refund processing
- Dispute notifications
dLocal signs every webhook with your Secret Key, so there is no separate webhook secret to enter in PayLexer. You only need to give dLocal the notification URL that PayLexer provides.
Copy the Webhook URL from PayLexer
In Payment Gateways → dLocal, copy the Webhook URL that PayLexer displays for your account.
Add the URL in your dLocal Dashboard
In the dLocal Merchant Dashboard, open the notification settings and paste the PayLexer Webhook URL as your notification (IPN) URL.
Save the configuration
Save the settings in dLocal. PayLexer verifies each incoming webhook signature automatically using your Secret Key.
Once configured, payment and refund updates from dLocal reach PayLexer in real time.
Integrate dLocal to Your Website
If you have already added and configured your site, you can enable dLocal in your existing setup.
Go to Websites
Navigate to Websites in your PayLexer dashboard.
Edit your website
Click the Edit Icon of your added website.
Enable dLocal
Click the checkbox to enable dLocal for the website.
If you haven't added a website yet, Continue to Add Your Website →
Troubleshooting
Best Practices
- Test in sandbox before enabling production, using dLocal test credentials and Test mode in PayLexer.
- Configure webhooks so payment and refund statuses update in real time.
- Keep your Secret Key private and rotate it in both dLocal and PayLexer if it is ever exposed.
- Match the order currency to the shopper's country so dLocal can route the payment to the right local methods.
- Keep your dLocal business onboarding and KYC current so live payments are not interrupted.
FAQs
Still Have Questions?
- dLocal Support: dLocal Support
- PayLexer Support: Contact Support