[MARCA] Documentação

QR Code impresso

Cartaz para balcão, caixa ou mesa, com o Pix reconhecido automaticamente.

Crie um QR por ponto de venda:

curl -X POST "https://api.exemplo.com.br/v1/static_qrs" \
  -H "Authorization: Bearer $PIX_API_KEY" -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{"label": "Caixa 1", "description": "Loja Aurora - Centro"}'
  • Sem amount, o cliente digita o valor no app; com amount, o valor vem no QR.
  • poster_url abre o cartaz pronto para imprimir (A5): nome da loja, valor, QR, instruções e a razão social e o CNPJ para o cliente conferir. Também dá para baixar só o QR em SVG.
  • O Pix pago pelo cartaz chega como pagamento matched com static_qr_id (evento payment.received) — não cai em "sem cobrança".
  • Cartaz trocado ou extraviado? Desative o QR (POST /v1/static_qrs/{id}/deactivate). Pix que ainda chegarem por ele ficam "sem cobrança" (motivo static_qr_inactive), aguardando a sua decisão.

No sandbox: POST /v1/sandbox/static_qrs/{id}/simulate_payment com {"amount": "25.00"}.

Próximo: Pagamentos, devoluções e MED →