POST /v3/pix/qrcode

POST /v3/pix/qrcode

valor é obrigatório. nome (nome do pagador), cpf (documento do pagador), descricao e urlnoty são lidos como textos ou números convertidos em textos; campos omitidos viram textos vazios. No sandbox, o nome padrão do pagador é Cliente Sandbox. A validação do provedor pode exigir outros dados do pagador em produção. urlnoty é opcional; quando presente, deve usar HTTPS e um destino público.

{
  "statusCode": 200,
  "qrcode": "PIX_COPY_AND_PASTE_TEXT",
  "checkout_url": "",
  "transactionId": "TRANSACTION_ID",
  "amount": 25
}

qrcode contém o texto PIX copia e cola, não uma imagem base64. checkout_url está vazio atualmente; não redirecione o cliente para ele. O sandbox acrescenta mode: "sandbox" e gera um QR simulado que não pode ser pago em banco. Tarifas maiores que a cobrança ou valores abaixo do mínimo configurado são rejeitados. A criação de QR não trata Idempotency-Key: repetir a chamada pode criar outra cobrança. Salve o resultado e investigue chamadas sem resposta antes de criar possíveis duplicatas.

Enviar urlnoty não configura sozinho a entrega do webhook. Cadastre um webhook ativo e habilite "Usar nas notificações por cobrança". Sem ele, apenas credenciais que ainda tenham uma chave HMAC legada podem enviar notificações por cobrança. O header X-Quibly-Secret só é enviado para a mesma origem do endpoint marcado; outras origens devem verificar X-Quibly-Signature. Configure as entregas e as chaves antes de usar urlnoty.