Pagar um QR Code
Pague um QR Code estático ou dinâmico com o mesmo copia e cola usado na leitura.
Pague o QR Code
Envie o código em qrCode.
curl -X POST https://pix.sandbox.payzu.dev/v1/withdraw/qrcode \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"qrCode": "00020101021226780014br.gov.bcb.pix2556api.payzu/pix/qr/v2/013318d6-2d7d-479e-8bb3-b5c7b9da688c5204000053039865802BR5905PAYZU6008SAOPAULO6217051320260118278956304FEFF",
"callbackUrl": "https://webhook.cool/",
"clientReference": "order-12323456"
}'{
"id": "PAYZU20261106M5KT9WB2LD000000",
"status": "PENDING",
"amount": 10,
"type": "WITHDRAW",
"qrCodeText": null,
"qrCodeBase64": null,
"qrCodeUrl": null,
"generatedName": null,
"generatedDocument": null,
"generatedEmail": null,
"serviceFeeCharged": 1,
"payerName": null,
"payerDocument": null,
"payerInstitutionIspb": null,
"payerInstitutionName": null,
"payerAccountNumber": "000000",
"withdrawPixKey": null,
"withdrawPixType": null,
"receiverName": null,
"receiverDocument": null,
"receiverInstitutionIspb": null,
"receiverInstitutionName": null,
"receiverAccountNumber": null,
"endToEndId": null,
"createdAt": "2025-11-06T19:10:00.000Z",
"updatedAt": "2025-11-06T19:10:00.000Z",
"paidAt": null,
"clientReference": "order-12323456",
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": null
}Referência: Pagar um QR Code Pix
| QR Code | amount |
|---|---|
| Com valor | Opcional: sem ele, vale o valor do QR Code. Se enviar, precisa ser igual. |
Dinâmico com amountEditable verdadeiro | Aceita outro valor. |
| Sem valor | Obrigatório. |
Pague logo depois de ler.
Um QR Code dinâmico expira em expiresIn segundos.
O pagamento respeita cashOutTicketMin, cashOutTicketMax e o DailyWithdrawLimit de GET /user.
O mesmo clientReference com o mesmo código e o mesmo valor retorna o saque já criado; com código ou valor diferente, a resposta é 409.
Confirme o pagamento
O saque criado pelo QR Code nasce PENDING e termina como o saque por chave, descrito em Confirme o envio.
Prefira receber o resultado pelo callback, informando callbackUrl ou assinando TRANSACTION_COMPLETED, TRANSACTION_CANCELED e TRANSACTION_ERROR num webhook. Os corpos estão em Transação concluída, Transação cancelada e Transação com erro. Para conferir pelo id ou pelo clientReference, veja Consultar um envio.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZK601 | 400 | QR Code inválido ou mal formatado. |
PZS603 | 400 | O valor informado (R$ 100,00) não corresponde ao valor do QR Code (R$ 150,00). |
PZS604 | 400 | É obrigatório informar o valor. |
PZS600 | 400 | O valor mínimo do saque é R$ 1,00. |
PZS601 | 400 | O valor máximo do saque é R$ 50.000,00. |
PZS602 | 400 | O valor do saque está fora dos limites da instituição financeira. |
PZK310 | 410 | Este QR Code expirou ou foi removido pela instituição financeira recebedora. |
PZS200 | 422 | Saque não permitido para esta conta no momento. |
PZS202 | 422 | Limite diário de saque excedido. |
PZS206 | 422 | Limite diário não configurado para esta conta. |
PZK101 | 424 | Não foi possível consultar o QR Code junto à instituição financeira. |
PZK104 | 424 | A consulta de chave/QR demorou para responder. Tente novamente. |
PZS500 | 424 | Nenhuma instituição financeira disponível para o saque no momento. Tente novamente em instantes. |
PZG429 | 429 | Limite de consultas atingido. Tente novamente em breve. Tente novamente em 30s. |
Os códigos de autenticação e de validação estão no Catálogo de erros.