Welcome to dLocal Go API

With dLocal Go API, you can get up and running with keys and integration tools. Manage a powerful payment solution with a range of capabilities, including: payments, refunds and notifications.

Not sure where to start? See our guide on Getting started with dLocal Go.

You can explore a sample integration project by visiting the repository at https://bitbucket.org/directopago/integration-sample/. Feel free to use and contribute to the project to enhance your understanding of the integration process.

Getting started

Every call to the dLocal Go API must include an API secret key. We offer two environments for developers to integrate our payment processing services: Sandbox and Live. Upon creating a dLocal Go account or a Testing account, we generate two distinct pairs of API keys—one for client-side use (publishable key) and one for server-side use (secret key). Each environment has its own unique set of keys. To process real transactions using live-mode keys, you need to have an activated live account.

Testing environment

URL: https://api-sbx.dlocalgo.com

The Testing environment is a sandbox designed for developers to test their integration with our payment processing services without using real money or impacting actual customer transactions. In this environment, developers can create test accounts, simulate transactions, and test their code in a safe, controlled setting.

Live environment

URL: https://api.dlocalgo.com

The Live environment is the production setting where real transactions are processed and actual money is involved. After developers have tested their integration in the Sandbox environment, they can switch to the Live environment to start processing real transactions.

Please note that in order to use the Live environment, developers must have a dLocal Go valid account and be authorized to use our payment processing services.

Step 1. Create a testing account

Get started with dLocal Go by creating a free testing account. Your testing account gives you access to the testing environment.

If you want to create a testing account, please go to this link: https://dashboard-sbx.dlocalgo.com/signup

How to access to your Testing keys

1. Go to https://dashboard-sbx.dlocalgo.com/.

2. Click on Integrations.

3. Select API Integration.

4. A dialog box labeled "Install dLocal Go on your site" will appear.

5. In this box, you will find your private Testing keys:

   1. Sandbox API Key

   2. Sandbox Secret Key

   You can easily copy and paste these keys by clicking on the copy icon.

Step 2. Try the testing environment

To verify that your testing account is working correctly, let's create a payment as an example:

curl -X GET \
  https://api-sbx.dlocalgo.com/v1/me \
  -H 'authorization: Bearer <API_KEY>:<SECRET_KEY>' \
  -H 'content-type: application/json' \
  -d '{}'

Testing card

To complete a payment, you can use a testing credit card.

Number: 4111 1111 1111 1111 Expiration date: Every date after the present date CVV: any CVV

Declined Payment Testing Card:

To test declined credit card payments, use the following Mastercard test card to simulate unsuccessful payment scenarios and validate your system's behavior:

Number: 5555 5555 5555 4444 Expiration date: Every date after the present date CVV: any CVV

Step 3. Create a live account

You can now create a live account on dLocal Go. Your live account grants you access to the live environment.

To create a live account at dLocal Go, please visit the following link: https://dashboard.dlocalgo.com/signup

How to access to your Live Integration keys

1. Go to https://dashboard.dlocalgo.com/.

2. Click on Integrations.

3. Select API Integration.

4. A dialog box labeled "Install dLocal Go on your site" will appear

5. In this box, you will find your private Integration keys:

   1. API Key

   2. Secret Key

   You can easily copy and paste these keys by clicking on the copy icon.

Step 4. Get ready to accept live payments

To begin accepting live payments with your live account, you need to first configure your account.

Settings from your test account do not automatically transfer to your live account.

You must configure your accepted payment methods on your live account dashboard; otherwise, the configurations will remain at their default settings.

Is this documentation clear enough? If you don't find what you need, please provide feedback here.