Como realizar um Pix Cash-out via QR Code Estático? – Celcoin

O Pix por QR Code Estático é ideal para pagamentos em balcões de check-out ou transferências recorrentes. Diferente do dinâmico, o código estático pode ou não conter um valor fixo, exigindo que sua aplicação trate a decodificação antes do envio.

🛠️ Fluxo de Integração (3 Etapas)

Etapa 1: Decodificação do EMV

Após sua aplicação ler o QR Code (via câmera ou upload), você terá uma string no padrão EMV Co|10. O primeiro passo é enviar essa string para a Celcoin:

Ação: Chame o endpoint de Decodificação de QR Code.
Resultado: Você receberá a Chave Pix (key) do recebedor e o transactionIdentification (se disponível).

Etapa 2: Consulta DICT (Validação)

Com a chave obtida na etapa anterior, você deve consultar os dados do recebedor:

Ação: Realize a Consulta DICT.
Resultado: Confirmação do nome do recebedor, CPF/CNPJ mascarado e dados bancários. Exiba esses dados ao seu usuário para confirmação antes de prosseguir.

Etapa 3: Efetivação do Pagamento

Com os dados validados, utilize o endpoint de Pagamento Pix preenchendo os campos conforme abaixo:

initiationType: Defina como "STATIC_QRCODE".
transactionIdentification: Utilize o identificador retornado na Etapa 1.
creditParty: Mapeie os dados retornados na Consulta DICT:
- participant ⬅️ bank
- accountNumber ⬅️ account
- taxIdNumber ⬅️ taxId
amount: Valor da transação (se o QR Code não possuir valor fixo, este dado deve ser inserido pelo usuário).
clientCode: Seu identificador exclusivo para evitar duplicidade.

💡 Exemplo de Requisição (JSON)

JSON

{
  "amount": 120.00,
  "clientCode": "LOJA-ABC-5544",
  "initiationType": "STATIC_QRCODE",
  "transactionIdentification": "TX12345678",
  "paymentType": "IMMEDIATE",
  "urgency": "HIGH",
  "creditParty": {
    "participant": "12345678",
    "accountNumber": "0001112223",
    "taxIdNumber": "000.000.000-00"
  }
}

✅ O que você precisa saber

Valor Variável: Se o campo amount vier zerado na decodificação, sua interface deve permitir que o pagador digite o valor.
Segurança: O uso do initiationType correto garante que o Banco Central identifique a origem da transação como uma leitura de código físico, aumentando a conformidade da sua operação.
Diagrama de Sequência: Para visualizar o fluxo completo de mensagens entre seu app, Celcoin e Bacen, consulte nosso Portal de Developers.