Como gerar uma Cobrança Imediata com Pix (QR Code Dinâmico)?

Diferente do Pix com vencimento, a cobrança imediata é focada em pagamentos instantâneos. O processo é dividido em duas etapas principais: a geração da Location (o "espaço" onde a cobrança viverá) e a Criação da Cobrança propriamente dita.

🛠️ Parâmetros Obrigatórios

Ao utilizar a API de Cobrança Imediata, certifique-se de enviar os seguintes campos no seu JSON:

• clientRequestId: Seu identificador exclusivo para controle da requisição.

• key: A sua chave Pix cadastrada na Celcoin que receberá o valor.

• amount: O valor exato a ser cobrado.

• debtor: Objeto contendo os dados do pagador (Nome e CPF/CNPJ).

• calendar: Define o tempo de expiração da cobrança (em segundos). Após esse prazo, o QR Code deixa de ser válido.

🔄 Fluxo da Operação

1. Geração da Location: Utilize a API para criar um QR Code (Location). Ela retornará um id e a URL que será codificada no QR Code.

2. Vínculo da Cobrança: Utilize o endpoint de Criar Cobrança Imediata, associando o valor e os dados do pagador à Location gerada.

3. Apresentação: Sua aplicação gera o QR Code visual ou o código "Pix Copia e Cola" para o cliente.

4. Confirmação: Assim que o pagamento for concluído, você receberá um Webhook de confirmação para liberar o pedido em tempo real.

💡 Exemplo de Requisição (JSON)

{
  "clientRequestId": "VENDA-00123",
  "key": "suachave@email.com",
  "amount": 150.00,
  "calendar": {
    "expiration": 3600
  },
  "debtor": {
    "name": "Nome do Cliente",
    "cpf": "00000000000"
  }
}

✅ Por que usar a Cobrança Imediata Dinâmica?

• Rastreabilidade: Cada pagamento está vinculado a um único txid, facilitando a conciliação automática.

• Segurança: O valor e o recebedor são travados no código, impedindo que o pagador altere o valor manualmente no app do banco.

• Gestão de Estoque: Com o campo expiration, você pode cancelar reservas de produtos automaticamente se o pagamento não for feito no tempo previsto.

🔗 Diagrama de Sequência: Para visualizar a troca de mensagens entre seu sistema, a Celcoin e o Banco Central, consulte nossa Documentação Técnica.