Como realizar um Pix Cash-out via QR Code Dinâmico? – Celcoin

O Pix via QR Code Dinâmico é exclusivo para pagamentos únicos e rastreáveis. O processo exige a validação da URL de cobrança antes da efetivação.

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

Etapa 1: Decodificação do EMV

Após capturar a string do QR Code, envie-a para o endpoint de decodificação.

O que obter: Você receberá a URL do Payload e o TXID (Transaction ID).

Etapa 2: Consulta do Payload (COB ou COBV)

Você deve consultar a URL retornada para entender o que está sendo cobrado.

Ação: Verifique o campo type retornado.
- Se for COB (Cobrança Imediata): Use a API de consulta de payload imediato.
- Se for COBV (Cobrança com Vencimento): Use a API de consulta de vencimento.
Atenção: A URL deve ser enviada em formato URL-encoded.

Etapa 3: Consulta DICT

Utilize a chave Pix (key) encontrada no payload para validar os dados do recebedor.

Ação: Chame a API de Consulta DICT para obter o ISPB do banco, agência e conta.

Etapa 4: Iniciar Pagamento

Com todas as informações validadas, realize a chamada de pagamento com as seguintes configurações:

initiationType: Utilize "DYNAMIC_QRCODE".
transactionIdentification: Preencha obrigatoriamente com o TXID obtido nas etapas anteriores.
creditParty: Mapeie os dados bancários da consulta DICT:
- participant ⬅️ bank
- accountNumber ⬅️ account
- taxIdNumber ⬅️ taxId
amount: Valor total a ser pago (considerando eventuais juros ou multas calculados no payload).

💡 Exemplo de Estrutura (JSON)

JSON

{
  "amount": 250.75,
  "clientCode": "FATURA-FEB-2024",
  "initiationType": "DYNAMIC_QRCODE",
  "transactionIdentification": "asdf0001bcde222333444555",
  "paymentType": "IMMEDIATE",
  "urgency": "HIGH",
  "creditParty": {
    "participant": "12345678",
    "accountNumber": "99887766",
    "taxIdNumber": "00.000.000/0001-00"
  }
}

📑 Pontos de Atenção para Desenvolvedores

Validade: QR Codes dinâmicos expiram conforme configuração do recebedor. Verifique o status da cobrança antes de tentar pagar.
Juros e Multas: No caso de COBV, sua aplicação deve calcular o valor final se o pagamento estiver sendo feito após o vencimento, baseando-se nas regras contidas no payload.
Diagrama de Sequência: Esta operação é a que possui mais trocas de mensagens. Recomendamos a consulta ao Diagrama de Uso na Documentação para evitar erros de fluxo.