Handle accounts

Learn account management essentials.

Through dLocal for Platforms API, you can easily manage your Liable accounts and User accounts.

With straightforward endpoints, you can efficiently perform tasks such as retrieving accounts, updating settings, blocking and unblocking, and canceling accounts whenever you need.

Get balance

Get the account balance with the account ID.

You can get the available balance and the amount pending to settle.

Check the balance of an existing account >

📘

Please note that you can only payout/withdraw the amount available in balance to withdraw.

Get accounts

Retrieve all the information for an account by querying with the account ID.

Some use cases of using this endpoint:

  1. During the onboarding process, you can check the status of your accounts. Any errors will be displayed alongside the status information. You can then update the relevant details as needed. Additionally, you can subscribe to our webhook to receive notifications about any changes in account status.
  2. To access the detailed information about the account at any time.

Retrieve an account >

Update account settings

In addition to the overall settings applied to your Platform account, we also support updating settings for Liable accounts and User accounts via API during your daily operations.

The settings that can be updated are:

  1. Pricing level. The specific user accounts or liable accounts can have different pricing levels compared to the general setting.
  2. Settlement period. Accounts can have a different settlement period than the general settings.
  3. Installment fee responsibility. You can specify whether the payin installment fee applies to users or end customers.

Adjust account configurations >

Block and unblock accounts

This function temporarily blocks or unblocks accounts, reverting status upon unblocking.

When you block accounts:

  1. Payins and refund requests for blocked accounts will be rejected.
  2. Payouts or withdrawal requests for blocked accounts will be rejected.

Take action: Block account >

Undo: Unblock account >


🚧

There are some circumstances that dLocal might block accounts for risk reasons mainly. We will inform you while webhooks with detailed reason to protect you away from the risks and help you to investigate further and solve the potential issues.

Cancel accounts

When the account is no longer being used, you can cancel an account.

Deactivate account >


❗️

Compared with block and unblock, this is an activity that can not be rollback.