--- updatedAt: 2026-03-25T16:33:42.000Z agentTools: projectIndex: https://docs.dlocal.com/llms.txt --- # API Reference [block:html] { "html": "\n\n\n \n \n dLocal API Reference\n \n\n\n\n
\n \n
\n

\n 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.\n

\n

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


\n

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

\n
\n\n \n
\n
Base URL
\n
\n \n \n \n \n \n\n \n
\n \n
\n
\n \n
\n\n \n

\n Some product-specific variations may apply; be sure to check the details for each endpoint.\n

\n
\n\n \n
\n Not sure where to begin? The Get started guide has everything you need.\n
\n
\n
\n\n\n\n" } [/block] *** # 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](https://dashboard.dlocal.com/settings/integration). ```json Authentication header 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](https://docs.dlocal.com/docs/payins-security). *** # Explore the API Reference Hover over the hotspots to learn about key sections of the interface and how to use them. [block:html] { "html": "\n\n\n \n \n API Reference Tooltip Guide\n \n\n\n\n\n
\n \"API\n\n
+
\n
+
\n
+
\n
+
\n
+
\n
+
\n
+
\n
\n\n\n\n\n" } [/block]