Cenários de teste
Nesta página
Conta de testeCobrançaEnvio para uma chaveDevoluçãoChaves, QR Codes e MEDOutras operaçõesTeste cada resultado da sua integração no sandbox escolhendo o valor da operação, sem rota de administração e sem dinheiro real.
Conta de teste
Cada credencial gerada em Credencial de sandbox abre uma conta própria.
| Item | Valor |
|---|---|
| Saldo disponível | R$ 10.000,00 |
| Agência | 0001 |
| Tarifas | Zeradas |
| Limite por operação | De R$ 1,00 a R$ 50.000,00, de entrada e de saída |
| Validade | 24 horas. As transações, os webhooks e as infrações criados com a credencial vencem junto, e depois disso qualquer chamada retorna 401. |
Não há rota para zerar a conta nem para forçar um status; para começar do zero, gere outra credencial.
Cobrança
A cobrança criada em POST /pix nasce PENDING e passa sozinha a COMPLETED 10 segundos depois, com o valor no saldo e o aviso enviado. Com expiresIn de 1 a 10 segundos, ou negativo, a cobrança vence antes de ser paga e passa a EXPIRED.
Envio para uma chave
Em POST /withdraw, a resposta da criação vem PENDING; o resultado aparece em GET /withdraw e no aviso.
amount | Resultado |
|---|---|
| Abaixo de R$ 1,00 | 400 com PZS600, sem criar a transação. |
| De R$ 1,00 a R$ 9,99 | CANCELED, com o motivo em cancellationReason. O valor volta ao saldo. |
| De R$ 10,00 a R$ 100,00 | COMPLETED logo depois da criação. |
| Acima de R$ 100,00 | PENDING e COMPLETED 10 segundos depois. |
O pagamento de QR Code em POST /withdraw/qrcode fica PENDING e é concluído 10 segundos depois, qualquer que seja o valor.
Devolução
A resposta de POST /refund/{transactionId} vem com refundStatus: "PENDING", como na produção.
| Valor devolvido | Resultado |
|---|---|
| Abaixo de R$ 1,00 | Devolução CANCELED, como se a instituição estivesse fora do ar. |
| De R$ 1,00 a R$ 9,99 | Devolução CANCELED, recusada pela instituição. |
| A partir de R$ 10,00 | Devolução COMPLETED. |
Na devolução cancelada, o valor volta ao saldo. Quando a soma devolvida alcança o valor do Pix, a transação passa a REFUNDED 10 segundos depois da conclusão da devolução.
Chaves, QR Codes e MED
| Operação | O que o sandbox faz |
|---|---|
| GET /pix/key | Retorna um titular fictício, sempre o mesmo para a mesma chave. Uma chave que contém chave-inexistente, como chave-inexistente@exemplo.com, retorna 404 com PZK300. |
| POST /pix/qrcode/read | Lê qualquer código como QR Code dinâmico, com valor entre R$ 10,00 e R$ 1.000,00. O mesmo código retorna sempre o mesmo titular, valor e txid, e createdAt vem com a hora da leitura. |
| Infrações MED | Cada conta nasce com 12 infrações OPEN, do tipo REFUND_REQUEST, com reportedAt sorteado nos últimos 30 dias. |
| Defesa MED | Aceita em qualquer infração OPEN, sem conferir expiresAt. Com anexo, ela fica DEFENDED; sem anexo, PENDING. |
Outras operações
| Operação | O que o sandbox faz |
|---|---|
| Transferência entre contas | Só aceita como destino a conta de outra credencial de sandbox. Gere uma segunda credencial e use o accountNumber dela em receiverAccountNumber. |
| GET /user/deposit-pending | Retorna sempre uma lista vazia, porque o sandbox não recebe Pix pela chave. |
| POST /user/report | O relatório fica COMPLETED 2 segundos depois. |
| Webhooks | Só recebem entregas depois de provar que a URL é sua. Veja Webhooks no sandbox. |
Cada credencial aceita 60 chamadas por minuto e 2.000 por dia.
Acima disso, a resposta é 429, com o tempo de espera em retryAfterSeconds. O pedido do código por e-mail aceita 3 envios por hora para o mesmo e-mail e 10 por hora para o mesmo IP.