Testing Transfers

Introduction

The Asaas Sandbox environment allows full simulation of financial transfers, enabling you to safely validate integrations without moving real funds.

This guide explains how to test transfers via Pix and via TED, highlighting the expected behaviors and features available exclusively in this environment.


Testing Transfers via Pix

Option 1: Using BACEN’s Fictitious Pix Keys

The Central Bank provides a set of fictitious Pix keys, specifically for testing transfers in homologation environments such as the Asaas Sandbox.

When making a transfer to any of these fictitious keys, the operation will:

  • Be completed immediately with success.
  • Have the amount debited from the Sandbox account.
  • Not be settled in any other account, since these are fictitious keys.

Check the official list of fictitious Pix keys provided by BACEN:

Name: Joao Silva
CPF/CNPJ: 99991111140
Key: [email protected]
Bank: Virtual Mensageria 04 (99999004)
Branch: 0001
Account: 12345678 (CACC)

Name: Joao Silva Silva
CPF/CNPJ: 99992222263
Key: [email protected]
Bank: Virtual Mensageria 04 (99999004)
Branch: 0002
Account: 11345678 (CACC)

Name: Jose Silva
CPF/CNPJ: 99993333387
Key: [email protected]
Bank: Virtual Mensageria 04 (99999004)
Branch: 0003
Account: 12145678 (CACC)

Name: Jose Silva Silva
CPF/CNPJ: 99994444409
Key: [email protected]
Bank: Virtual Mensageria 04 (99999004)
Branch: 0004
Account: 12315678 (CACC)

Name: Jose da Silva
CPF/CNPJ: 99995555514
Key: [email protected]
Bank: Virtual Mensageria 04 (99999004)
Branch: 0004
Account: 12341678 (CACC)

Option 2: Using Pix Keys from Other Sandbox Accounts

You can create a Pix key in your own Sandbox account or in another Sandbox account to perform more complete tests.

In this case:

  • The amount will be debited from the origin account.
  • The amount will be credited to the destination account.
  • The entire flow occurs within the Sandbox environment, allowing you to validate real debit and credit scenarios.

Example flow: Sandbox Account A → makes Pix → Pix Key of Sandbox Account B → Account B receives the credit.


❗️

Important

  • Transfers to fictitious keys do not generate credit records in any account.]Transfers between real
  • Sandbox accounts perfectly simulate the movement between bank accounts in the production environment.

Testing Transfers via TED

In the Sandbox environment, TED transfers have manual controls available exclusively in the Asaas interface (not available via API).

After initiating a TED transfer, you will have two options in the interface to simulate the operation result:

Confirm Transfer:

  • Simulates a successful settlement. The amount is debited from the Sandbox account.
  • The transfer status changes to Completed.

Simulate Failure:

  • Simulates a failed transfer.
  • The amount is not debited from the account.
  • The transfer status changes to Failed.

📘

Note:

  • In Sandbox, no transfer results in real financial movements.
  • All tests can be performed safely, without risk of impact in production environments.
  • The use of fictitious Pix keys is recommended to test success flows without the need to configure multiple accounts.
  • To test credit and debit scenarios, use multiple Sandbox accounts with real Pix keys.

The Asaas Sandbox provides a safe and controlled environment to validate all transfer flows via Pix and TED — from successful cases to failures — ensuring higher quality and security in your integration before using the production environment.

See the request to make transfers here.