Enviar Pix por QR Code (Cash-out QR)

​

Visão geral

• O destinatário fornece um QR Code estático ou dinâmico.
• Você precisa pagar uma cobrança Pix emitida por terceiros.
• O valor já está codificado na string EMV.

​

Criar o pagamento

curl -X POST https://api.clearpago.com.br/api/pix/cash-out-qrcode \
  -H "Authorization: Bearer <seu_api_token>" \
  -H "Content-Type: application/json" \
  -H "X-Correlation-ID: req-qrpay-001" \
  -d '{
    "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"
  }'

{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "status": "CREATED",
  "externalId": "pagamento-qr-456"
}

​

Campos

​

Diferenças em relação ao cash-out por chave

​

Ciclo de vida e webhooks

1. 201 com estado inicial (CREATED, RESERVED, etc.).
2. Despacho ao BaaS.
3. Webhook pix_cash_out com CONFIRMED ou FAILED.
4. Em caso de reversão posterior: webhook pix_cash_out_reversal com REVERSED.

​

Cuidados práticos

• QR expirado: se o QR Code já expirou, a criação falhará com 4xx ou o BaaS rejeitará. Obtenha uma nova string EMV junto ao emissor.
• QR já pago: QR Codes dinâmicos de uso único são rejeitados se já foram liquidados.
• Não reutilize externalId: cada tentativa de pagamento deve usar um externalId distinto.

​

Referências

• POST /api/pix/cash-out-qrcode
• GET /api/pix/cash-out/
• Enviar por chave (fluxo completo)
• Modelo de status