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 otransactionIdentification(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⬅️bankaccountNumber⬅️accounttaxIdNumber⬅️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
amountvier zerado na decodificação, sua interface deve permitir que o pagador digite o valor.Segurança: O uso do
initiationTypecorreto 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.
Comentários
0 comentário
Artigo fechado para comentários.