Approval of accounts

Even though it is very similar to the production environment, the sandbox environment requires some attention to ensure that account and subaccount approval is carried out correctly.

Standalone Account Approval

To have your account automatically approved in the sandbox environment, you must complete the registration, including business details and document submission.

The information provided does not need to be real — just fill in the required business fields and upload any image as documentation, and the account will be validated.

To do this, simply follow these steps:

1. Access your account and in the user menu, click on “My Account”.
2. Go to "Information" > "Business Data" and fill in the following fields:
   1. CPF/CNPJ
   2. Date of birth
   3. Full name
   4. Mobile phone
   5. Address
   6. Business information
3. Then, go to the "Documents" tab and upload any random file.
4. Finally, go to the "Registration Status" section to check if your account has been approved.

👍

Tip

If you don’t want to use real data, you can use company data generators, such as: >https://www.4devs.com.br/gerador_de_pessoas<

Additionally, whenever you update any information — even non-required fields — you will need to contact our Integration Success team to have the account re-approved.

❗️

Important

To prevent errors, name your Sandbox accounts and sub-accounts using only letters and spaces.

Using numbers or special characters (!, #, _, etc.) in account names can desynchronize and disable PIX on your test account, blocking your integration. Avoid: Test Account_01 Prefer: Test Account One

If your account is approved and PIX is disabled, check and correct the account names. If the problem persists, contact our support.

Subaccounts

When creating subaccounts in the sandbox environment, it is essential to use a valid email address. This ensures the password reset link is sent, which is necessary to complete the onboarding process. After accessing this link, you must complete the registration on the subaccount, including uploading images for automatic document validation. If the provided email is invalid or the link is not accessed, the subaccount cannot be automatically approved. In such cases, you must call the Check Pending Documents endpoint using the subaccount's API Key and then contact our Integrations team to complete the process.

White Label

In the white label subaccount model, document submission is done via the onboarding link. In the sandbox environment, these links are for illustration purposes only and do not perform real validations. Approval for these subaccounts is done manually by our Integrations team. To ensure the process is completed correctly, you must call Check Pending Documents with the subaccount's API Key. Additionally, if you call Check Pending Documents and find that your subaccount needs to send additional documents — such as the company’s articles of incorporation — these can be submitted via API using the Send Documents endpoint. For support, please contact: [email protected]