Skip to main content

​
Rota

POST /api/pix/cash-out-qrcode

​
Corpo (exemplo)

{
  "value": 99.90,
  "externalId": "pagamento-qr-456",
  "qrCode": "00020101021226870014br.gov.bcb.pix2565...",
  "description": "Pagamento via QR Code",
  "name": "Loja XYZ",
  "document": "00.000.000/0001-00"
}
CampoObrigatórioDescrição
valueSimValor em BRL.
externalIdSimIdentificador único da operação.
qrCodeSimString EMV; tipicamente começa com 000201 e possui comprimento mínimo (validação do provedor/parceiro).
description, name, documentNãoMetadados.
TODO: tamanho mínimo exato (caracteres) e conjunto de erros 400 — a origem cita “comprimento mínimo” sem quantificar; confirme com a API runtime ou suporte.

​
Ciclo e webhooks

O ciclo de vida e os webhooks seguem a mesma família do cash-out por chave. No detalhe da transação, o campo paymentType aponta key ou qrcode.

​
Limitações e validações

  • O EMV precisa ser válido e aceito pelo parceiro. Erros de parse ou regra de BaaS retornarão 4xx conforme a implementação.
  • Mesmas orientações de estados ambíguos e reconciliação do cash-out por chave: ver reconcilição.

​
API reference