Como usar API de recebíveis para originação de crédito

abril 13, 2026

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

Principais lições deste artigo

Um motor de originação automática de crédito exige cinco módulos integrados: recebíveis, cash flow via Open Finance, decisão de crédito, originação e monitoramento.
O registro obrigatório em registradoras como B3 e CERC é essencial para vincular garantias e reduzir o risco de duplicatas.
Combinar dados de recebíveis com Open Finance permite calcular advance rates dinâmicos e limites de crédito mais precisos.
Webhooks bem arquitetados são indispensáveis para o monitoramento contínuo da carteira e detecção precoce de inadimplência.
Use a infraestrutura de crédito completa da Celcoin para construir um motor de originação automática, escalável e em conformidade regulatória.

O desafio de automatizar a originação sem processos manuais

Processos manuais de análise de crédito reduzem velocidade de aprovação, aumentam o custo por operação e elevam o risco de falhas regulatórias. Para fintechs, ERPs, marketplaces e gestoras de fundos, depender de análises humanas em cada etapa limita a escala e reduz a competitividade.

Construir um motor de originação automática que combine APIs de recebíveis, dados de cash flow via Open Finance e registro formal em registradoras permite escalar com controle de risco. Este artigo descreve a arquitetura técnica para isso, módulo por módulo e em passos práticos.

A Celcoin não oferece empréstimo para consumidores. A Celcoin fornece infraestrutura tecnológica para que empresas ofertem produtos de crédito aos seus clientes.

Passo 1: visão geral da arquitetura de 5 módulos

Um motor de originação automática de crédito baseado em recebíveis utiliza cinco módulos funcionais conectados entre si.

Módulo de recebíveis: consulta, validação e trava de recebíveis via API junto às registradoras.
Módulo de cash flow via Open Finance: coleta de dados transacionais e de renda com consentimento do tomador, via APIs padronizadas do Open Finance Brasil.
Módulo de decisão de crédito: motor de score combinado que cruza dados de recebíveis, histórico transacional e bureau externo para calcular limite e advance rate.
Módulo de originação: emissão automatizada de CCB, vinculação de garantias e integração com gestoras de funding.
Módulo de monitoramento: webhooks e alertas para acompanhamento contínuo da carteira.

Cada tipo de empresa aplica esses cinco módulos de forma diferente, de acordo com o modelo de negócio e os produtos de crédito que oferece. A tabela abaixo mostra como cada perfil utiliza os módulos.

Módulo	Fintech / banco digital	ERP / marketplace	Gestora de fundos
Recebíveis	Antecipação de recebíveis para PMEs clientes	Financiamento de fornecedores via duplicatas registradas	Aquisição de carteiras de recebíveis para FIDC
Open Finance	Score de renda alternativo para não correntistas	Verificação de faturamento do lojista parceiro	Due diligence automatizada de originadores
Decisão de crédito	Pré-aprovação em tempo real no app	Limite dinâmico por ciclo de vendas	Advance rate por qualidade da carteira
Originação	CCB emitida via SCD própria ou da Celcoin	Contrato vinculado ao pedido de compra	Nota Comercial ou CCB cedida ao fundo
Monitoramento	Alerta de inadimplência por webhook	Reconciliação automática de pagamentos	Dashboard de performance da carteira

Passo 2: fluxo de 6 etapas para originação automática

Autenticação OAuth 2.0: o sistema emite um token de acesso com escopos específicos para consulta de recebíveis e dados de Open Finance, garantindo rastreabilidade por sessão.
Consulta de recebíveis na registradora: via API, o motor consulta os recebíveis elegíveis do tomador na B3 ou CERC, filtrando por prazo, valor e status de livre movimentação.
Score combinado: os dados de recebíveis são cruzados com o histórico transacional obtido via Open Finance para gerar um score composto e calcular o advance rate dinâmico.
Trava, ou vinculação, via registradora: os recebíveis selecionados como garantia são travados na registradora, o que impede a reutilização em outras operações e reduz o risco de duplicata.
Emissão da CCB: com a garantia vinculada, o módulo de originação emite a Cédula de Crédito Bancário de forma automatizada, com assinatura digital e validade jurídica.
Webhook de monitoramento: após o desembolso, o sistema registra os endpoints de callback para receber notificações de liquidação, atraso ou inadimplência em tempo real.

Passo 3: como registrar recebíveis em B3/CERC e evitar duplicatas

O registro de recebíveis em registradoras autorizadas pelo Banco Central é obrigatório em operações de crédito com garantia em recebíveis de cartão e duplicatas. A CERC atua como registradora eletrônica especializada e processa grandes volumes de contratos diariamente. A B3 registra duplicatas e outros ativos e é referência em crédito privado.

O fluxo de registro segue estas etapas.

Envio do payload com dados do recebível, como valor, vencimento, CNPJ do sacado e número do contrato, via API da registradora.
Recebimento do identificador único de registro, que funciona como chave de rastreabilidade.
Armazenamento imutável desse identificador no sistema de originação para auditoria.
Consulta periódica do status do recebível para verificar livre movimentação antes de qualquer trava.

Pontos de atenção

Nunca inicie a trava de um recebível sem confirmar o status de livre movimentação na registradora. Recebíveis já onerados geram falhas silenciosas que aparecem apenas na liquidação.

Use chaves de idempotência em todas as chamadas de registro para reduzir o risco de duplicatas causadas por retentativas de rede.

Armazene o identificador de registro como campo imutável no banco de dados da operação. Qualquer alteração posterior deve gerar um novo registro, não sobrescrever o anterior.

Valide o CNPJ do sacado antes do envio. Inconsistências cadastrais são causa frequente de rejeição nas registradoras.

Passo 4: combinação de dados de recebíveis e Open Finance para cálculo dinâmico de limites e advance rate

O advance rate representa o percentual do valor nominal do recebível que pode ser antecipado. Em operações de financiamento de recebíveis, advance rates típicos variam entre 70% e 90% do valor elegível, com variações conforme qualidade da carteira, prazo dos títulos e histórico de pagamento do sacado.

A fórmula base é:

Valor antecipado = valor do recebível elegível × advance rate

Com Open Finance, o motor enriquece esse cálculo com dados de cash flow real do tomador. Em fevereiro de 2026 o Open Finance Brasil somava 154 milhões de consentimentos ativos, movimentando bilhões de chamadas de API semanalmente, o que torna os dados transacionais disponíveis em escala para decisões de crédito.

Alguns exemplos práticos de cálculo dinâmico ajudam a visualizar o impacto.

PME com recebíveis de cartão: recebível de R$ 100.000, prazo médio de 30 dias e sacado com histórico de pagamento pontual, advance rate de 85%, valor antecipado de R$ 85.000.
Lojista de marketplace: recebíveis de R$ 50.000, mas dados de Open Finance mostram queda de 40% no faturamento nos últimos 60 dias, advance rate ajustado para 70%, valor antecipado de R$ 35.000.
Fornecedor com duplicatas: concentração acima de 25% em um único sacado aciona limite de concentração e reduz a base elegível, mesmo com volume total elevado.

Dicas úteis

Aplique limites de concentração por sacado, com recomendação de máximo entre 20% e 30% da base elegível por cliente, para reduzir risco de portfólio.

Exclua recebíveis com vencimento superior a 90 dias da base de cálculo inicial, pois o risco de inadimplência cresce de forma não linear com o prazo.

Atualize o advance rate a cada novo ciclo de dados do Open Finance, não apenas na originação. Limites dinâmicos reduzem a exposição em carteiras rotativas.

Congele um snapshot imutável de todos os dados usados na decisão, como score, advance rate, dados de Open Finance e versão da política de crédito, vinculado ao ID da operação para auditoria.

Passo 5: regras de pré-aprovação automática e vinculação de garantias

Tratar a pré-aprovação como etapa separada da subscrição final reduz risco de decisões desatualizadas. Sistemas de originação de crédito se beneficiam ao separar a pré-aprovação da subscrição final, que precisa ser reexecutada imediatamente antes da assinatura do contrato, pois janelas de validade podem expirar e dados podem mudar.

A pré-aprovação exige que três condições principais sejam atendidas ao mesmo tempo: qualidade de crédito, capacidade de garantia e conformidade cadastral.

Score combinado, que inclui recebíveis, Open Finance e bureau, acima do threshold definido pela política de crédito.
Recebíveis elegíveis suficientes para cobrir o valor solicitado com o advance rate aplicado.
Ausência de restrições cadastrais no CNPJ ou CPF do tomador.

Além disso, a pré-aprovação precisa ter validade limitada para manter alinhamento entre decisão e desembolso.

Prazo de validade da pré-aprovação definido explicitamente, com recomendação entre 24 e 72 horas, e revalidação obrigatória antes do desembolso.

Para a vinculação de garantias, o fluxo técnico segue uma sequência clara.

Seleção dos recebíveis elegíveis com base nos critérios de advance rate.
Envio da instrução de trava à registradora via API, com identificação da operação como chave de idempotência.
Confirmação do status de trava antes de avançar para a emissão do instrumento de crédito.
Revalidação dos limites e do status da garantia imediatamente antes do desembolso, para reduzir o risco de sobre-limite entre aprovação e funding.

Passo 6: webhooks e alertas para acompanhamento da carteira

O monitoramento pós-desembolso depende de uma arquitetura de webhooks confiável e observável. Webhooks costumam falhar em quatro pontos principais: falhas de rede, timeouts, falhas de validação de payload e problemas de ordenação ou duplicação, sem gerar erro imediato no sistema de destino.

Algumas boas práticas ajudam a manter a carteira sob controle.

O endpoint deve verificar a assinatura HMAC e enfileirar o payload imediatamente, retornando 200 em até 5 a 30 segundos. Todo o processamento ocorre de forma assíncrona.
Implemente idempotência usando o ID do evento como chave única, o que evita reprocessamento em caso de retentativas do provedor.
Envie eventos que esgotam as retentativas para uma fila de dead-letter, ou DLQ, com alerta imediato para a equipe de operações.
Monitore métricas críticas como profundidade da fila, taxa de sucesso por evento, latência de processamento e idade do evento mais antigo pendente.

Alguns alertas ajudam a detectar problemas cedo.

Ausência de webhooks por mais de 15 minutos, gerando alerta de aviso.
Taxa de erro acima de 5% em janela de 5 minutos, gerando alerta crítico.
Qualquer evento na DLQ, gerando alerta crítico imediato.
Falha de verificação de assinatura, gerando alerta crítico por possível ataque ou deriva de configuração.

Passo 7: neutralidade e seleção de parceiros de funding para gestoras

Gestoras de fundos que atuam em originação de crédito precisam de infraestrutura que mantenha neutralidade entre originadores e fundos. Essa neutralidade é um requisito operacional para evitar conflitos de interesse.

Alguns critérios técnicos ajudam a avaliar parceiros de funding em uma arquitetura neutra.

A plataforma de infraestrutura não deve ter participação direta em fundo de crédito que concorra com os fundos dos clientes.
O roteamento de operações entre originadores e gestoras deve seguir regras configuráveis pela gestora, não preferências da plataforma.
Todos os originadores conectados devem ter acesso às mesmas condições de integração e visibilidade de carteira.
A cessão de recebíveis ao fundo deve ser registrada de forma rastreável, com documentação padronizada independentemente do originador.

A solução de crédito da Celcoin opera com neutralidade como princípio, conecta gestoras a múltiplos originadores sem conflito de interesses e fornece infraestrutura para emissão de CCB, registro de recebíveis e gestão de carteira em um único ambiente integrado.

Conheça a infraestrutura de crédito completa da Celcoin e opere com neutralidade, escala e conformidade regulatória.

Passo 8: armadilhas comuns de integração com registradoras e como evitá-las

Integrações com registradoras concentram boa parte das falhas operacionais em produção. Conhecer as armadilhas mais frequentes ajuda a estruturar controles preventivos.

Trava sem confirmação de status: conforme descrito no passo 3, iniciar a vinculação de garantia sem verificar o status atual do recebível na registradora expõe a operação a garantias já oneradas. Solução: consultar sempre o status antes de qualquer instrução de trava.
Ausência de idempotência nas chamadas: retentativas de rede sem chave de idempotência podem gerar registros duplicados. Solução: usar o ID da operação como chave única em todas as chamadas de escrita.
Snapshot de decisão não armazenado: conforme estabelecido no passo 4, a ausência de snapshot imutável dos dados de decisão dificulta auditorias. Solução: implementar o congelamento de dados descrito anteriormente.
Gestão de estado por if-statements dispersos: transições de estado da operação devem ficar centralizadas em uma máquina de estados explícita, com histórico append-only. Solução: implementar uma state machine dedicada com log imutável de transições.
Desembolso sem revalidação: conforme descrito no passo 5, limites e garantias podem mudar entre aprovação e funding. Solução: aplicar a revalidação obrigatória de limite, status da garantia e validade da aprovação imediatamente antes do desembolso.

Critérios de sucesso da operação

Uma operação de originação automática de crédito com recebíveis é bem-sucedida quando cumpre critérios técnicos e operacionais claros.

Taxa de aprovação automática acima do threshold definido pela política de crédito, sem intervenção manual.
Tempo médio de originação, da consulta de recebíveis à emissão da CCB, dentro do SLA estabelecido.
Zero duplicatas de registro nas registradoras, comprovado por auditoria periódica dos identificadores únicos.
Taxa de sucesso de webhooks acima de 95%, com DLQ zerada em operação normal.
Snapshot imutável de decisão disponível para 100% das operações, auditável a qualquer momento.
Advance rate recalculado a cada ciclo de dados do Open Finance, com limites ajustados automaticamente.

A infraestrutura da Celcoin cobre esses critérios com APIs modulares, integração nativa com registradoras, Open Finance e emissão automatizada de CCB. A tabela abaixo resume as principais funcionalidades e benefícios.

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 que 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 e melhoram o tempo para geração de receita.
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 em altos volumes e protege a 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 e melhoram 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.

Perguntas frequentes

O que é uma API de recebíveis e como ela se conecta à originação de crédito?

Uma API de recebíveis é uma interface de programação que permite consultar, registrar e travar recebíveis, como duplicatas e recebíveis de cartão, junto às registradoras autorizadas pelo Banco Central, como B3 e CERC. Na originação de crédito, essa API funciona como ponto de entrada para identificar os ativos que serão usados como garantia, verificar elegibilidade, calcular o advance rate e vincular formalmente os recebíveis à operação antes da emissão do instrumento de crédito. Sem essa integração, o processo de vinculação de garantias permanece manual, mais lento e sujeito a erros.

Qual a diferença entre B3 e CERC como registradoras de recebíveis?

B3 e CERC são registradoras autorizadas pelo Banco Central do Brasil para registro de recebíveis, mas atuam com focos distintos. A CERC é especializada em recebíveis de cartão de crédito e duplicatas e opera como câmara de liquidação e depositária central de dados. A B3 registra duplicatas e outros ativos de crédito privado e é amplamente utilizada em operações de mercado de capitais e FIDCs. Em uma arquitetura de originação automática, a integração pode incluir as duas, de acordo com o tipo de recebível e o perfil do tomador.

Como o Open Finance melhora a precisão do cálculo de advance rate?

O Open Finance melhora a precisão do advance rate ao fornecer dados de fluxo de caixa real do tomador, como entradas e saídas recorrentes, sazonalidade de faturamento e concentração de receitas. Esses dados permitem ajustar o percentual de antecipação de forma dinâmica, em vez de usar apenas parâmetros estáticos baseados em tipo de recebível ou histórico limitado. Com isso, o motor de crédito consegue conceder limites mais aderentes à capacidade de pagamento e reduzir tanto o risco de inadimplência quanto a concessão abaixo do potencial.

Saiba mais

The best service for growth Infratech financeira para potencializar negócios

Oferecemos uma infraestrutura completa e pioneira para conectar empresas de todos os segmentos a oportunidades do mercado financeiro, com soluções incorporadas às necessidades de seus clientes.

Contratar