PayZu Pix

Cenários de teste


Nesta páginaConta de testeCobrançaEnvio para uma chaveDevoluçãoChaves, QR Codes e MEDOutras operações

Teste 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.

ItemValor
Saldo disponívelR$ 10.000,00
Agência0001
TarifasZeradas
Limite por operaçãoDe R$ 1,00 a R$ 50.000,00, de entrada e de saída
Validade24 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.

amountResultado
Abaixo de R$ 1,00400 com PZS600, sem criar a transação.
De R$ 1,00 a R$ 9,99CANCELED, com o motivo em cancellationReason. O valor volta ao saldo.
De R$ 10,00 a R$ 100,00COMPLETED logo depois da criação.
Acima de R$ 100,00PENDING 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 devolvidoResultado
Abaixo de R$ 1,00Devolução CANCELED, como se a instituição estivesse fora do ar.
De R$ 1,00 a R$ 9,99Devolução CANCELED, recusada pela instituição.
A partir de R$ 10,00Devoluçã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çãoO que o sandbox faz
GET /pix/keyRetorna 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/readLê 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 MEDCada conta nasce com 12 infrações OPEN, do tipo REFUND_REQUEST, com reportedAt sorteado nos últimos 30 dias.
Defesa MEDAceita em qualquer infração OPEN, sem conferir expiresAt. Com anexo, ela fica DEFENDED; sem anexo, PENDING.

Outras operações

OperaçãoO que o sandbox faz
Transferência entre contasSó aceita como destino a conta de outra credencial de sandbox. Gere uma segunda credencial e use o accountNumber dela em receiverAccountNumber.
GET /user/deposit-pendingRetorna sempre uma lista vazia, porque o sandbox não recebe Pix pela chave.
POST /user/reportO relatório fica COMPLETED 2 segundos depois.
WebhooksSó 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.