Adicionando saldo em uma conta Sandbox

No Sandbox, você pode simular saldo para testar operações que dependem de recursos disponíveis na conta, como transferências, pagamentos e antecipações.

Como o ambiente não movimenta valores reais, o saldo é gerado por meio da confirmação de uma cobrança de teste.

Quando utilizar

Adicione saldo quando precisar testar:

• transferências Pix;
• transferências entre contas Asaas;
• pagamentos de contas;
• antecipações;
• consultas de saldo e extrato;
• outras operações que exijam saldo disponível.

Como funciona

O fluxo recomendado é:

Criar cliente
      ↓
Criar cobrança
por Pix ou boleto
      ↓
Confirmar pagamento
      ↓
Saldo disponibilizado
      ↓
Executar os testes

1. Crie um cliente

Cadastre um cliente de teste para vincular à cobrança.

Consulte o guia Criar um cliente.

2. Crie uma cobrança

Crie uma cobrança utilizando uma destas formas de pagamento:

• PIX;
• BOLETO.

Após a criação, a cobrança ficará disponível para confirmação no Sandbox.

3. Confirme o pagamento

Na interface do Sandbox, acesse a cobrança e clique na opção para confirmar o pagamento.

Após a confirmação, o valor será adicionado ao saldo da conta Sandbox.

Exemplo

Para testar uma transferência Pix de R$ 500:

1. Crie um cliente de teste.
2. Gere uma cobrança Pix de R$ 500.
3. Confirme o pagamento.
4. Utilize o saldo disponibilizado para realizar a transferência.

Confirme pela API

Em cenários de Sandbox com subcontas, também é possível confirmar o pagamento pela API.

Consulte Ações em Sandbox para:

• confirmar o pagamento de uma cobrança;
• forçar o vencimento de uma cobrança.

Caso o botão não apareça

Verifique se:

• a cobrança foi criada no Sandbox;
• a forma de pagamento é Pix ou boleto;
• a cobrança ainda não foi confirmada;
• o status atual permite a confirmação.

Boas práticas

• utilize somente dados destinados a testes;
• gere apenas o saldo necessário para o cenário;
• valide os Webhooks e as mudanças de status após a confirmação;
• não considere o comportamento do Sandbox como garantia de disponibilidade em Produção.

Próximos passos

Após adicionar saldo, você pode testar:

• transferências Pix;
• pagamentos de contas;
• antecipações;
• consulta de saldo;
• extrato financeiro.