PayZu Pix
Pagar com Pix
Envie um Pix para uma chave, pague um QR Code ou transfira saldo para outra conta PayZu.
Toda saída vira uma transação WITHDRAW da sua conta e dispara os mesmos eventos de callback. O id da resposta serve para consultar o status, baixar o comprovante e localizar o callback.
Modalidades
| Modalidade | Quando usar | Rota |
|---|---|---|
| Enviar um Pix para uma chave | Você tem a chave Pix do recebedor. | POST /withdraw |
| Pagar um QR Code | Você tem o QR Code (estático ou dinâmico) ou o copia e cola da cobrança. | POST /pix/qrcode/read e POST /withdraw/qrcode |
| Transferir entre contas PayZu | O destino é uma conta PayZu e você tem o número dela. | POST /internal-transfer |
Antes e depois de pagar
Consultar uma chave Pix
Mostre o titular no DICT a quem vai confirmar o envio.
Ler um QR CodeMostre quem recebe e quanto antes de pagar.
Consultar um envioConfira o status de um Pix enviado ou de um QR Code pago.
Consultar uma transferênciaAche uma transferência entre contas pelo clientReference.
O formato de cada chave está em Tipos de chave Pix.
Regras de toda saída
| Regra | Como funciona |
|---|---|
| Valor | Em reais, com até duas casas decimais, como "amount": 150.5. |
| Limites | Cada saída respeita o valor por operação (cashOutTicketMin e cashOutTicketMax) e o limite diário (DailyWithdrawLimit), que vêm em GET /user. |
| Resultado | Pix para chave e pagamento de QR Code costumam voltar PENDING, com o resultado final no callback. A transferência entre contas já volta COMPLETED na resposta. |
clientReference | Envie em toda saída. Com a mesma referência e os mesmos dados, a PayZu retorna a transação já criada; com dados diferentes, recusa com 409. Veja Idempotência. |
| IP | Para pagar pela API, a conta precisa ter o IP de saída cadastrado. Sem IP, ou de um IP fora da lista, a resposta é 403. Veja IP cadastrado. |