dLocal API Reference

The dLocal API is built on RESTful principles, making it straightforward to integrate with and easy to use. It follows a predictable structure with resource-based endpoints, leverages standard HTTP methods, and communicates using JSON for both requests and responses.

You can use the sandbox environment to test your integration without triggering real transactions.

Keep in mind that some API behavior may vary depending on your account configuration, supported regions, and activated payment methods.

Authentication

Each request to the dLocal API must include a signature. The signature is essential to confirm the information's validity and security.

Configure the header using your API Credentials and business information. You can view and manage your account credentials in the Merchant Dashboard under Settings > Integration.

curl -X POST \
   -H 'X-Date: {x-date}' \
   -H 'X-Login: {x-login}' \
   -H 'X-Trans-Key: {x-trans-key}' \
   -H 'Content-Type: application/json' \
   -H 'X-Version: 2.1' \
   -H 'User-Agent: MerchantTest / 1.0 ' \
   -H 'Authorization: V2-HMAC-SHA256, Signature: {Signature}' \
   -d '{body}'
    https://api.dlocal.com/payments

For more specific instructions, visit the security page for instructions on creating the signature.

Explore the API Reference

Hover over the hotspots to learn about key sections of the interface and how to use them.

API Reference Tooltip Guide