Como gerar uma Cobrança com Vencimento (COBV)?

Diferente da cobrança imediata, a COBV exige o preenchimento de campos de endereço do pagador e permite a configuração de regras financeiras complexas para o pós-vencimento.

🛠️ Parâmetros Fundamentais

Ao integrar a API de Cobrança com Vencimento, atente-se aos seguintes campos:

• locationId: O identificador gerado previamente na API de Location (configurada como COBV).

• amount: O valor nominal da cobrança.

• debtor (Devedor): Diferente do Pix comum, aqui o CEP, Cidade, Logradouro e UF são obrigatórios para a validade jurídica da cobrança.

• expirationAfterPayment: Define por quantos dias o QR Code ainda poderá ser pago após a data de vencimento.

• key: Sua chave Pix registrada na Celcoin.

🔄 Fluxo de Implementação

O processo segue uma ordem lógica para garantir que o QR Code contenha todas as regras de negócio:

1. Reservar a Location: Chame a API Criar um QR Code (Location) com o tipo COBV. Ela servirá como o "endereço digital" da sua cobrança.

2. Configurar a Cobrança: Utilize o endpoint de Criar cobrança com vencimento vinculando o locationId aos dados do devedor e aos valores.

3. Definir Encargos (Opcional): Neste momento, você pode configurar os objetos de Multa (fine), Juros (interest) e Descontos (discount).

4. Disponibilizar ao Cliente: Gere o QR Code dinâmico. O cliente visualizará todos os dados (incluindo juros, se estiver pagando em atraso) diretamente no app do banco dele.

💡 Exemplo de Requisição (JSON)

{
  "clientRequestId": "FATURA-2024-001",
  "locationId": 123456,
  "key": "financeiro@suaempresa.com.br",
  "amount": 250.00,
  "dueDate": "2024-12-25",
  "expirationAfterPayment": 30,
  "debtor": {
    "name": "Cliente Exemplo",
    "cpf": "000.000.000-00",
    "email": "cliente@email.com",
    "postalCode": "01001-000",
    "city": "São Paulo",
    "state": "SP"
  }
}

✅ Vantagens do Pix COBV

• Substituição do Boleto: Reduz drasticamente as taxas de emissão e liquidação.

• Cálculo Automático: Se o cliente pagar após o vencimento, o próprio Banco Central calcula os juros e multas definidos por você, apresentando o valor final atualizado para o pagador.

• Gestão de Inadimplência: Através dos Webhooks, você sabe no segundo exato em que a fatura foi quitada, permitindo a liberação imediata de serviços.

🔗 Dica de Developer: Lembre-se que, para cobranças com vencimento, o objeto receiver (recebedor) deve estar com os dados da sua empresa atualizados para evitar que o pagador desconfie da transação.