Saques
O caminho de saída de dinheiro da sua conta: mande Pix por chave, que é o mais comum, ou pague um QR Code que o seu cliente passou, dinâmico ou estático.
Saques são o caminho de saída de dinheiro. Use chave Pix (mais comum) ou pagar um QR Code que seu cliente recebeu. Todas as transações geradas aqui são do tipo WITHDRAW.
Quando usar cada um
| Pergunta | Endpoint |
|---|---|
| Quem é o titular dessa chave Pix? | GET /pix/key |
| Quero pagar via chave Pix (cpf, cnpj, email, phone, evp) | POST /withdraw |
| Recebi um QR Code do cliente, quero ler antes de pagar | POST /pix/qrcode/read |
| Quero pagar um QR Code direto | POST /withdraw/qrcode |
| O saque foi concluído? Qual o status agora? | GET /withdraw |
| Quero o comprovante oficial do saque | GET /withdraw/proof/{id} |
PayZu processa QR Code dinâmico e estático na leitura e pagamento.
Exemplos
Fluxo recomendado (por chave)
Limites mínimos
| Operação | amount mínimo |
|---|---|
POST /withdraw | R$ 0,01 |
POST /withdraw/qrcode | R$ 0,10 |
Tutoriais e boas práticas
Estornar um Pix POST
Devolva um Pix que você recebeu, no valor cheio ou em parte. O estorno entra como pendente na hora e a PayZu confirma a conclusão depois por webhook.
Saque por chave Pix POST
Envia dinheiro pra fora da sua conta informando a chave de destino, seja CPF, CNPJ, telefone, e-mail ou chave aleatória.