Overview

The Sandbox is a testing environment where you can receive fictitious payments and test your integrations and Webhooks. This way, you can have more security when switching to production.

👍

You can create a Sandbox account here: https://sandbox.asaas.com/

Just follow the normal flow as if you were creating an Asaas account, and after finishing, generate a unique API Key for your Sandbox account.

The system is a copy of Asaas with some differences to make testing easier:

• Accounts are approved automatically, you just need to follow the account approval flow and submit any image as a document;
• Confirm payments with just one click and the balance will be credited to your account;
• Confirm credit card payments by informing fictitious valid card numbers;

🚧

Attention

Sending and receiving email and SMS notifications work normally in Sandbox. Therefore, you should not create clients with real emails and cell phones or random numbers like (51) 9999-9999. To test the receipt of notifications, you can use your own emails and cell phones.

However, not everything can be tested in Sandbox. Check the section "What can be tested?" for functionalities that do not yet have tests in Sandbox.

Development and testing environment

❗️

Important

The Sandbox is a separate environment from the production environment, changes made in your Sandbox account are not replicated in the production one. The Sandbox environment was created to test development and verify that everything is working correctly and then use the production API key in your integration.

We highly recommend that you use Sandbox for all of your testing. To do this, you must first create an account in the Sandbox environment. After creating the account, you can create your API key in Sandbox and replace the API URL in your calls, as described below: