Get your API credentials
Learn everything you need to know about your dLocal API credentials.
All dLocal API requests require API credentials to verify the call is being made through a valid dLocal account.
Types of credentials
There are two types of credentials that you can use:
- Sandbox credentials. These credentials allow you to check your integration by sending payments to our Sandbox API. You will be able to view all the transactions through the Merchant Dashboard in Test mode. We recommend trying the Sandbox API before going live to ensure that your integration works properly.
- Production credentials. These credentials allow you to start processing real payments.
API credentials detail
| Credentials | type | Description |
|---|---|---|
x-login | String | Sent as a header to identify the merchant making the request. |
x-trans-key | String | Sent as a header along with x-login to authenticate the request. |
Secret key | String | Used to generate the signature for the Authorization header in API requests. |
Smartfields API key | String | Used in the tokenization process; acts as the merchant ID for identification. Only for Smart Fields integration. |
Obtain your credentials
You can get the Sandbox and the Production credentials from your account in the Merchant Dashboard.
You can switch between the Test and Live modes by pressing the toggle at the top bar and then finding the corresponding credentials in Settings > Integration.
Integration section in the Merchant Dashboard.
The account creation allows you to test payments but does not guarantee that you will be able to process live payments until the account is activated.
Updated 15 days ago