PayZu PixPagar com Pix

Pagar um QR Code


Nesta páginaPague o QR CodeConfirme o pagamentoErros desta operação

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.

bash
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"
  }'

Referência: Pagar um QR Code Pix

QR Codeamount
Com valorOpcional: sem ele, vale o valor do QR Code. Se enviar, precisa ser igual.
Dinâmico com amountEditable verdadeiroAceita outro valor.
Sem valorObrigató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ódigoHTTPMensagem
PZK601400QR Code inválido ou mal formatado.
PZS603400O valor informado (R$ 100,00) não corresponde ao valor do QR Code (R$ 150,00).
PZS604400É obrigatório informar o valor.
PZS600400O valor mínimo do saque é R$ 1,00.
PZS601400O valor máximo do saque é R$ 50.000,00.
PZS602400O valor do saque está fora dos limites da instituição financeira.
PZK310410Este QR Code expirou ou foi removido pela instituição financeira recebedora.
PZS200422Saque não permitido para esta conta no momento.
PZS202422Limite diário de saque excedido.
PZS206422Limite diário não configurado para esta conta.
PZK101424Não foi possível consultar o QR Code junto à instituição financeira.
PZK104424A consulta de chave/QR demorou para responder. Tente novamente.
PZS500424Nenhuma instituição financeira disponível para o saque no momento. Tente novamente em instantes.
PZG429429Limite 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.