Como relacionar um recebimento Pix ao QR Code que gerei?

A conciliação automática entre uma cobrança e um recebimento é feita através de um identificador exclusivo. Veja como funciona o fluxo de ponta a ponta:

1. Na Geração da Cobrança

Ao criar um QR Code (seja Imediato ou com Vencimento) via API, a Celcoin retorna no JSON de resposta o campo transactionIdentification.

• Dica: Armazene este código em seu banco de dados vinculado ao pedido ou fatura do seu cliente.

2. No Momento do Recebimento (Webhook)

Quando o pagador escaneia o código e conclui o pagamento, a Celcoin envia uma notificação automática (Webhook) para o seu sistema. No corpo desse Webhook, o campo transactionIdentification estará presente com o mesmo valor gerado no passo anterior.

3. A Conciliação

Basta que o seu sistema compare o identificador recebido no Webhook com os identificadores armazenados em seu banco de dados. Se os códigos forem iguais, você pode alterar o status do pedido para "Pago" instantaneamente.

🔍 Outras formas de identificação:

Se você não utiliza Webhooks, existem alternativas:

• Consulta de Extrato Detalhado: Ao consultar o extrato via API, o campo de identificação também estará disponível em cada linha de crédito.

• End-to-End ID: Para uma rastreabilidade ainda mais profunda perante o Banco Central, você também pode utilizar o endToEndId, que é o RG único da transação no arranjo Pix.