Cash-in

POST /api/v1/gateway/request-qrcode gera uma cobrança PIX. A resposta traz o PIX copia e cola (paymentCode) e a imagem PNG do QR Code em base64 (paymentCodeBase64) para você mostrar ao cliente.

Fluxo

1. Seu servidor chama Gerar cobrança PIX com o requestNumber do pedido.
2. Você exibe o QR Code e o botão "copiar código" ao cliente.
3. O cliente paga no app do banco.
4. A WeetPay credita o valor (líquido da tarifa) no seu saldo e faz POST no callbackUrl com statusTransaction: "PAID_OUT".
5. Seu sistema valida a assinatura, libera o pedido e responde 200.

Exibindo o QR Code

<img src="data:image/png;base64,{paymentCodeBase64}" width="240" height="240" alt="QR Code PIX" />
<input value="{paymentCode}" readonly />
<button onclick="navigator.clipboard.writeText('{paymentCode}')">Copiar código PIX</button>

Status da cobrança

Dicas

• Use um requestNumber por tentativa de pagamento. Se o QR expirar, gere outra cobrança com um novo requestNumber (ex.: pedido-12345-2).
• Informe o CPF/CNPJ real do pagador em client.document: ele é validado e repassado ao banco.
• Envie utm_source, utm_campaign… na query string para guardar a origem da venda junto da cobrança.