Como oferecer antecipação de recebíveis via API integrada

Última atualização: 3 de agosto de 2026

Principais lições deste artigo

• Garantir conformidade regulatória é obrigatório: Resolução CMN 5.045/2022, Resoluções BCB 264 e 267 e LC 214/2025 regem antecipação de recebíveis e split payment.

• Adotar arquitetura REST versionada, OAuth 2.0 ou JWT com mTLS, webhooks com HMAC e idempotency keys garante segurança, escala e rastreabilidade na integração via API.

• Concluir o checklist de compliance, incluindo KYC, AML, registro de recebíveis e adequação às normas do Banco Central, é condição para o go-live.

• Implementar o fluxo técnico completo envolve consulta de elegibilidade, simulação, contratação com emissão de CCB e monitoramento via webhooks para liquidação e inadimplência.

• Implemente antecipação de recebíveis com a infraestrutura de crédito da Celcoin.

1) Diagnóstico de requisitos técnicos e regulatórios

O mapeamento do enquadramento regulatório da operação deve ocorrer antes de qualquer linha de código. A Resolução CMN nº 5.045/2022 altera a Resolução nº 4.734/2019 e estabelece condições e procedimentos para operações de desconto e crédito garantidas por recebíveis de arranjo de pagamento. A Resolução BCB nº 264 obriga credenciadoras a disponibilizar canais de acesso às agendas de recebíveis registradas. A Resolução BCB nº 267 define a estrutura de governança para interoperabilidade entre sistemas de registro.

Com a entrada em vigor da LC 214/2025, operações de cessão de recebíveis devem observar regras de identificação do lojista original nas comunicações com a Plataforma Pública de Split Payment. A antecipação financeira não altera a obrigação de segregação e recolhimento de IBS e CBS. As regras de split payment passam a coexistir com o produto de antecipação.

Dica útil: verifique se sua empresa possui ou precisa da licença de Sociedade de Crédito Direto para formalizar a operação. Caso não possua, um parceiro de infraestrutura regulado pode disponibilizar a própria licença para viabilizar o produto.

2) Arquitetura de integração recomendada

A arquitetura padrão para antecipação de recebíveis via API segue o modelo REST com versionamento de URL desde o primeiro deploy, por exemplo, /v1/receivables. APIs stateless com autenticação OAuth 2.0 ou JWT permitem escalonamento horizontal, pois qualquer nó do servidor pode processar qualquer requisição sem armazenar estado de sessão.

O Open Finance brasileiro exige OAuth 2.0, FAPI e mTLS para comunicação segura entre instituições. Esses mesmos padrões devem ser adotados na integração da plataforma com o provedor de infraestrutura. O fluxo básico de integração se organiza em quatro camadas: autenticação, consulta de elegibilidade, simulação e contratação, além do monitoramento via webhook.

3) Consulta de recebíveis elegíveis via API

O endpoint de consulta retorna a agenda de recebíveis disponíveis para antecipação, filtrada por data de vencimento, valor mínimo e modalidade, como boleto, cartão ou Pix. A paginação baseada em cursor, por exemplo ?after=cursor&limit=20, é recomendada para conjuntos de dados grandes. Essa abordagem mantém a performance estável mesmo com aumento do volume da carteira.

Exemplo de requisição:

GET /v1/receivables/eligible?after=cursor_abc&limit=20&due_date_from=2026-08-10 Authorization: Bearer {access_token}

Dica útil: implemente cache com headers ETag e Cache-Control na consulta de elegibilidade para reduzir latência em plataformas com alto volume de requisições simultâneas.

4) Simulação de antecipação com payload JSON de exemplo

O endpoint de simulação calcula o valor líquido a receber, a taxa de desconto aplicada e o prazo de liquidação, sem gerar obrigação contratual. Idempotency keys devem ser implementadas em todos os endpoints com efeitos colaterais para evitar duplicações em caso de retentativas de rede.

Exemplo de payload de simulação:

POST /v1/receivables/simulate Content-Type: application/json Idempotency-Key: sim-20260803-001 { "receivable_ids": ["rec_001", "rec_002"], "anticipation_date": "2026-08-05", "discount_rate_monthly": 0.025 }

Resposta esperada:

{ "simulation_id": "sim_xyz", "gross_amount": 50000.00, "discount_amount": 1250.00, "net_amount": 48750.00, "settlement_date": "2026-08-05", "status": "simulated" }

5) Fluxo de contratação e emissão de CCB

O fluxo de contratação começa após a aprovação da simulação pelo cliente. O endpoint de contratação formaliza a operação e aciona a emissão automatizada da Cédula de Crédito Bancário. A CCB é emitida pela empresa, pessoa física ou jurídica, em favor de instituição financeira ou Sociedade de Crédito Direto autorizada pelo Banco Central, conferindo validade à operação de antecipação de recebíveis.

Exemplo de payload de contratação:

POST /v1/receivables/contract Content-Type: application/json Idempotency-Key: ctr-20260803-001 { "simulation_id": "sim_xyz", "borrower_document": "12.345.678/0001-99", "bank_account": { "bank_code": "000", "agency": "0001", "account": "123456-7" }, "acceptance": true }

Automatize a emissão de CCB e formalize operações de crédito com a infraestrutura de crédito da Celcoin.

6) Configuração de webhooks para eventos de liquidação e inadimplência

Webhooks exigem retentativas com backoff exponencial automático por até 72 horas, assinaturas HMAC, event_id único para idempotência e logs de entrega para garantir rastreabilidade em produção.

Os eventos essenciais a monitorar incluem:

• receivable.settled: liquidação confirmada na data prevista.

• receivable.overdue: recebível não liquidado na data de vencimento.

• receivable.cancelled: cancelamento ou devolução que aciona regras de split payment conforme a LC 214/2025.

• ccb.signed: CCB assinada digitalmente pelo tomador.

Dica útil: valide a assinatura HMAC de cada evento recebido antes de processar qualquer atualização de status. Rejeite eventos com event_id já processado para garantir idempotência no seu sistema.

7) Checklist de compliance e KYC/AML

A conformidade regulatória define a prontidão para o go-live. O processo começa com a validação da identidade do cedente por meio de KYC completo, segue para a análise de risco de lavagem de dinheiro e só então avança para registro de recebíveis e adequação contratual.

O KYC completo do cedente inclui validação de CNPJ, sócios e beneficiários finais conforme normas do Banco Central. Essa validação alimenta a triagem de AML, que cruza os dados coletados com listas restritivas, como OFAC e COAF, e com a análise de PEP para identificar riscos regulatórios.

Somente após a aprovação dessas etapas o sistema deve prosseguir para o registro de recebíveis na registradora habilitada, em linha com a Resolução BCB nº 264. Em paralelo, os contratos entre cedente e cessionário precisam prever a alocação do ônus econômico da segregação de IBS e CBS, conforme a LC 214/2025.

Os termos de financiamento também devem ser compatíveis com a capacidade de pagamento do lojista, em linha com a Resolução CMN nº 5.045/2022. Quando houver uso de dados do Open Finance, o consentimento do usuário deve seguir os padrões de OAuth 2.0, FAPI e mTLS com validade de até 12 meses.

Dica útil: mantenha logs auditáveis de todas as etapas do KYC e AML com timestamp e hash de integridade. Reguladores podem solicitar evidências de due diligence em auditorias.

8) Métricas de sucesso e monitoramento contínuo

O monitoramento contínuo após o go-live garante a saúde operacional e regulatória da carteira. As principais métricas incluem taxa de liquidação no prazo, volume de recebíveis antecipados por período, taxa de inadimplência por segmento de cedente e tempo médio de resposta dos endpoints de simulação e contratação.

Headers de rate limit, como X-RateLimit-Limit e X-RateLimit-Remaining, devem ser monitorados para identificar picos de uso e ajustar limites por tier de cliente. Respostas de erro 4xx e 5xx com traceId devem ser centralizadas em um sistema de observabilidade para diagnóstico ágil.

Monitore sua carteira de recebíveis em tempo real com a infraestrutura de crédito da Celcoin.

Sobre a Celcoin

A Celcoin oferece infraestrutura tecnológica e financeira full stack para que fintechs, ERPs e grandes varejistas lancem produtos de antecipação de recebíveis com segurança jurídica, conformidade regulatória e escala. A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes.

A tabela a seguir resume as principais funcionalidades da infraestrutura da Celcoin e os benefícios diretos que cada uma oferece para a sua operação:

Funcionalidade da Celcoin	Benefício para sua empresa
APIs modulares	Integrações mais rápidas, com redução de custos e prazos de desenvolvimento.
Experiência e suporte ao desenvolvedor	Documentação, SDKs e sandboxes reduzem ciclos de integração e custos de engenharia.
Capacidade de lançamento rápido	Módulos pré-construídos e entrega via SaaS aceleram lançamentos, melhorando o tempo para geração de receita e competitividade.
Distribuição white-label e embutida	Suporte a produtos financeiros com marca própria.
Escalabilidade com confiabilidade	Solução com alta disponibilidade e escalável na nuvem mantém serviços funcionando mesmo com altos volumes, protegendo sua receita.
Cobertura de diversas possibilidades de pagamentos, incluindo crédito	Oferta combinada de pagamentos e emissão de crédito aumenta conversão, ARPU e fidelização.
Acesso a dados e personalização	Dados e análises via Open Finance permitem ofertas personalizadas, com melhora de conversão e retenção.
Compliance e conformidade como princípio	KYC, AML e relatórios integrados reduzem risco regulatório e aceleram ciclos de vendas.
Prevenção de fraude e controles de risco	Monitoramento baseado em IA e autenticação robusta reduzem estornos, perdas e exposição regulatória.
Força do ecossistema de parceiros da Celcoin	Parcerias e integrações com bancos, redes e fintechs ampliam cobertura, recursos e velocidade de entrada no mercado.

Implemente antecipação de recebíveis com conformidade regulatória usando a infraestrutura de crédito da Celcoin.

Perguntas frequentes

O que é antecipação de recebíveis via API integrada?

Antecipação de recebíveis via API integrada é a oferta de liquidez antecipada sobre valores a receber de cartão, boleto ou Pix diretamente dentro de uma plataforma digital, sem redirecionamento para sistemas externos. A integração via API permite que fintechs, ERPs e varejistas embutam o produto com a própria marca e automatizem simulação, contratação, emissão de CCB e monitoramento de liquidação em um único fluxo técnico.

Quais licenças regulatórias são necessárias para oferecer antecipação de recebíveis?

A formalização da operação de antecipação exige, em geral, a atuação de uma Sociedade de Crédito Direto ou instituição financeira autorizada pelo Banco Central do Brasil para emissão da CCB. Plataformas que não possuem essa licença podem operar por meio de um parceiro de infraestrutura regulado que disponibilize a própria licença, viabilizando o produto sem que a plataforma precise obter autorização própria imediatamente.

Como a LC 214/2025 afeta operações de cessão de recebíveis?

A LC 214/2025 introduziu regras de split payment que coexistem com a antecipação de recebíveis. Em operações de cessão, o campo de identificação do receptor nas comunicações com a Plataforma Pública de Split Payment deve apontar para o lojista original, e não para o cessionário. Além disso, contratos entre cedente e cessionário precisam prever a alocação do ônus econômico da segregação de IBS e CBS e o tratamento de eventuais restituições em caso de cancelamento ou devolução.

Qual é a diferença entre simulação e contratação no fluxo de API?

A simulação calcula o valor líquido, a taxa de desconto e o prazo de liquidação sem gerar obrigação jurídica. Esse endpoint é informativo e pode ser chamado múltiplas vezes sem efeitos colaterais. A contratação formaliza a operação, aciona a emissão da CCB e reserva os recebíveis selecionados. Por ter efeito colateral, o endpoint de contratação deve implementar idempotency key para evitar duplicações em caso de falhas de rede.

Como configurar webhooks para monitorar liquidação e inadimplência?

A configuração de webhooks deve contemplar eventos de liquidação confirmada, vencimento sem pagamento, cancelamento de recebível e assinatura de CCB. Cada evento precisa conter um identificador único para garantir idempotência no processamento. A plataforma receptora deve validar a assinatura HMAC de cada notificação antes de atualizar qualquer status interno. O provedor de infraestrutura deve implementar retentativas automáticas com backoff exponencial para garantir a entrega mesmo em casos de indisponibilidade temporária do endpoint receptor.

A Celcoin oferece crédito diretamente para os consumidores finais?

Não. Conforme explicado anteriormente, a Celcoin opera no modelo B2B2C e atende empresas como fintechs, ERPs, varejistas e gestoras de fundos. A Celcoin fornece infraestrutura para que essas empresas estruturem e ofertem produtos de crédito, incluindo antecipação de recebíveis, aos próprios clientes com sua marca.