Como automatizar crédito com APIs com Open Finance: passos

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

Principais lições deste artigo

• O fluxo de originação de crédito automatizado divide-se em quatro etapas, consentimento, enriquecimento, decisão e emissão, que podem ser implementadas com APIs modulares sem necessidade de licença SCD ou IP própria.

• A distinção entre dados públicos, sem consentimento, e dados consentidos via Open Finance é requisito regulatório fundamental para conformidade com LGPD e normas do BCB.

• Motores de decisão independentes, originação, scoring e matching, operam de forma assíncrona e permitem substituição ou atualização sem impacto no pipeline completo.

• A emissão de CCB via API, com assinatura digital e cobrança automatizada, reduz o tempo médio de aprovação e garante rastreabilidade exigida em auditorias.

• Transforme seu negócio com a infraestrutura de crédito completa da Celcoin e opere toda a jornada, da originação à cobrança, em uma única plataforma neutra e modular.

Passo 1 – Como automatizar consentimento usando API com Open Finance

O framework brasileiro de Open Finance foi instituído como Sistema Financeiro Aberto, Open Banking, pela Resolução Conjunta nº 1, de 4 de maio de 2020, editada pelo Conselho Monetário Nacional e pelo Banco Central do Brasil, tendo sido renomeado para Open Finance em 2022. Essa regulação define categorias de dados compartilháveis, tipos de participantes e fases de implementação. O consentimento é a base legal primária para o compartilhamento, conforme o Art. 7º, I da LGPD.

O fluxo técnico de consentimento segue o padrão definido pelo Open Finance Brasil Financial-grade API Security Profile:

1. Criação do recurso de consentimento: a aplicação originadora chama o endpoint POST /consents e especifica os escopos de dados necessários, por exemplo, dados cadastrais, transacionais e operações de crédito.

2. Redirecionamento para autenticação: o Authorization Server exige Pushed Authorization Requests, PAR, PKCE e autenticação do cliente via private_key_jwt. O nível mínimo de autenticação é LoA2, fator único. LoA3, multifator, é recomendado para contratação de produtos.

3. Emissão de tokens: após a autorização, o servidor emite access tokens com validade entre 300 e 900 segundos e refresh tokens vinculados ao consentimento ativo. Os escopos seguem o formato consent:{Consent Resource Id}, em que o Consent Resource Id é namespaced, conforme o Open Finance Brasil Financial-grade API Security Profile 1.0.

4. Chamadas às APIs de dados: cada requisição usa JWS com algoritmo PS256, JWE com RSA-OAEP e A256GCM, e TLS com cipher suites específicas, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 e TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384.

Pré-requisitos: registro no Diretório de Participantes e autorização do Banco Central do Brasil.

Output esperado: objeto de consentimento com status AUTHORISED, escopos granulares por tipo de dado, timestamp de criação e data de expiração. No Open Finance Brasil, o prazo máximo de validade do consentimento não é mais limitado a 12 meses. O prazo pode ser indeterminado ou superior, conforme acordo entre cliente e instituição, mantendo a possibilidade de revogação a qualquer tempo.

Dica útil — erros comuns de consentimento e LGPD:

• Solicitar escopos mais amplos do que o necessário para a operação viola o princípio da necessidade da LGPD e pode resultar em sanções administrativas do BCB sob a Lei nº 13.506/2017. Esse erro geralmente ocorre quando equipes de produto pedem todos os escopos disponíveis para evitar integrações futuras, mas essa prática expõe a empresa a risco regulatório desnecessário.

• Mesmo quando os escopos estão corretos, não revogar tokens quando o consentimento é cancelado pelo titular configura não conformidade direta com o Security Profile v2.2.1, que exige revogação imediata de access e refresh tokens. Tokens ativos após o cancelamento criam uma janela de não conformidade que pode ser identificada em auditorias do BCB.

• Por fim, dados compartilhados devem ser deletados ou anonimizados após o término da validade do consentimento. A instituição receptora torna-se controladora autônoma e assume responsabilidade civil pelo uso indevido. Essa obrigação persiste mesmo quando o consentimento expira por prazo e não por revogação ativa do titular.

Passo 2 – Como automatizar enriquecimento usando APIs integradas com Receita Federal e Open Finance

O enriquecimento de dados opera em duas camadas, dados públicos, que não exigem consentimento do titular, e dados consentidos via Open Finance, que dependem do fluxo descrito no Passo 1. Essa separação garante que os dados consentidos só sejam utilizados dentro do escopo e do prazo autorizados.

A integração de dados transacionais via Open Finance fornece insumos diretos para cálculo de capacidade de pagamento e Debt-to-Income ratio, conforme detalhado na tabela de fontes de dados abaixo.

A tabela abaixo descreve as fontes de dados MVP para um pipeline de pré-aprovação e destaca a diferença entre dados públicos, que podem ser consultados imediatamente, e dados consentidos, que exigem autorização formal via Open Finance. Essa separação influencia a velocidade de processamento e a conformidade regulatória do fluxo.

Fonte	Tipo	Dados principais	Consentimento exigido?
Receita Federal, CNPJ ou CPF	Público	Situação cadastral, atividade econômica, sócios, data de abertura	Não
Open Finance, dados cadastrais	Consentido	Endereço, renda declarada, vínculos empregatícios	Sim
Open Finance, dados transacionais	Consentido	Histórico de débitos, créditos, transferências Pix, pagamentos de boleto, operações de crédito ativas, saldos de conta, limites contratados versus utilizados, status de conta	Sim
Score de parceiro	Externo	Score bureau, negativações, histórico de crédito no SFN	Contratual

Do ponto de vista de feature engineering, variáveis sintéticas como média de saldo diário nos últimos 90 dias, soma de empréstimos pagos nos últimos 6 meses e razão entre Pix de saída e Pix de entrada são geradas a partir dos dados transacionais consentidos e alimentam diretamente os motores de decisão.

Passo 3 – Como automatizar decisão usando motores de crédito e score

A arquitetura de decisão de crédito baseada em APIs abertas opera com três motores independentes. Cada motor tem responsabilidade delimitada e se conecta aos demais por meio de eventos ou chamadas assíncronas.

Motor 1, Originação: recebe os dados enriquecidos do Passo 2, aplica as políticas de crédito da empresa, como limites por segmento, restrições de produto e regras de elegibilidade, e produz uma proposta de crédito parametrizada com valor, prazo e taxa simulada. Pré-requisito: payload normalizado com dados cadastrais e transacionais. Output: objeto de proposta com status, pré-aprovado, pendente ou recusado, e parâmetros de oferta.

Motor 2, Crédito, scoring: consome o histórico transacional consentido e o score de bureau para calcular a probabilidade de inadimplência. Estudos com mais de 2,7 milhões de clientes mostram que o compartilhamento voluntário de dados via Open Finance aumenta em média 14,7 pontos percentuais a probabilidade de aprovação de cartões de crédito, com maiores ganhos, 18 pontos percentuais, para quem não possuía cartão prévio. Pré-requisito: acesso ao histórico transacional de pelo menos 3 meses via Open Finance. Output: score interno, faixa de risco e taxa de juros recomendada.

Motor 3, Matching: orquestra a conexão entre a proposta aprovada e a gestora de fundo ou fonte de capital disponível, respeitando critérios de elegibilidade do fundo, como ticket mínimo, modalidade e garantia. Pré-requisito: integração com o catálogo de fundos e regras de cessão. Output: confirmação de funding alocado e condições finais do contrato.

Os três motores operam de forma assíncrona via webhooks ou polling. Essa abordagem permite que cada componente seja substituído ou atualizado de forma independente, sem impacto no pipeline completo, e cria um fluxo em que a saída de um motor alimenta diretamente o próximo.

Integre os três motores de decisão em uma única esteira modular com a Celcoin, eliminando a fragmentação de fornecedores e simplificando a governança do pipeline completo.

Passo 4 – Como automatizar emissão usando API de CCB e cobrança

Uma vez que os três motores confirmam a aprovação, o motor de originação valida a elegibilidade, o motor de scoring define a taxa final e o motor de matching aloca o funding, o pipeline avança automaticamente para a formalização contratual. Com a proposta aprovada e o funding alocado, o pipeline aciona a emissão da Cédula de Crédito Bancário, CCB, via API.

O fluxo inclui:

1. Geração do instrumento com os parâmetros contratuais, valor, taxa, prazo e garantias.

2. Assinatura digital pelo tomador por meio de integração com uma plataforma de assinatura eletrônica.

3. Registro automático do instrumento, quando a modalidade exigir registro.

4. Ativação do módulo de cobrança com geração de boletos ou débito automático via Pix.

Dica útil — versionamento de API e compliance:

• Mantenha versionamento semântico, v1, v2, nos endpoints de emissão de CCB para garantir retrocompatibilidade durante atualizações regulatórias. Quando uma nova resolução do BCB exigir mudanças no formato da CCB, sua equipe poderá lançar o endpoint /v2/ccb sem quebrar integrações existentes que ainda usam /v1/ccb.

• Além do versionamento, implemente logs imutáveis de cada chamada de emissão com timestamp, payload e resposta. Esses registros são exigidos em auditorias do BCB e do COAF. Logs imutáveis permitem comprovar, de forma retrospectiva, que cada CCB emitida tinha consentimento válido no momento da emissão.

• Para que os logs sejam úteis em auditoria, valide o status do consentimento Open Finance antes de cada chamada de emissão. O Security Profile v2.2.1 exige que access tokens sejam emitidos apenas para consentimentos com status AUTHORISED. Essa validação pré-emissão cria uma trilha de auditoria que demonstra conformidade contínua, e não apenas conformidade no momento da integração inicial.

Tabela de métricas de funil

O monitoramento do pipeline automatizado deve cobrir as três etapas principais do funil de originação. A tabela abaixo apresenta as métricas-chave por estágio e mostra como cada API do fluxo tem um indicador de alerta específico que ajuda a diagnosticar gargalos antes que afetem a taxa de conversão geral.

Estágio do funil	Métrica principal	Sinal de alerta	API responsável
Leads, solicitações	Taxa de consentimento concluído	Abandono no fluxo OAuth	API de consentimento Open Finance
Pré-aprovações	Taxa de aprovação por motor de score	Queda na taxa de aprovação sem mudança de política	Motor de crédito, scoring
Contratos emitidos	Tempo médio de emissão de CCB	Latência acima do SLA contratual	API de emissão de CCB

Validação, acompanhamento e dicas úteis

A validação contínua do pipeline automatizado requer monitoramento em três dimensões, qualidade dos dados de entrada, performance dos motores de decisão e conformidade regulatória dos outputs. Essa rotina mantém o funil saudável e reduz riscos operacionais e regulatórios.

Dica útil — checklist de validação pós-integração:

• Verificar se todos os consentimentos ativos têm tokens correspondentes com status AUTHORISED no Authorization Server. Consentimentos sem tokens válidos indicam falha no fluxo de renovação e podem bloquear operações de enriquecimento.

• Uma vez confirmada a validade dos tokens, auditar mensalmente a base de dados enriquecidos para garantir que dados de consentimentos expirados foram deletados ou anonimizados, conforme exige a LGPD. Essa auditoria complementa a validação de tokens ao cobrir o ciclo de vida completo dos dados, e não apenas o acesso ativo.

• Além da conformidade de dados, monitorar a disponibilidade das APIs de dados do Open Finance, já que falhas de SLA podem resultar em sanções administrativas do BCB. Disponibilidade inadequada afeta a taxa de aprovação, por causa de dados incompletos, e a conformidade regulatória.

• Por fim, revisar trimestralmente as políticas de crédito dos motores de originação para refletir mudanças macroeconômicas e regulatórias. Essa revisão mantém as regras de decisão alinhadas ao ambiente de risco atual, e não apenas às condições do momento da implementação inicial.

Reduza o tempo médio de subscrição com a infraestrutura completa da Celcoin e transforme o monitoramento contínuo do pipeline em um diferencial competitivo direto.

Infraestrutura completa da Celcoin

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.

Para originadores, correspondentes bancários, fintechs de crédito, ERPs e varejistas que precisam implementar esse pipeline completo, a Celcoin atua como camada de infraestrutura neutra e full stack. Empresas sem licença SCD ou IP própria podem operar com crédito formalizado utilizando a licença da Celcoin. Empresas já licenciadas se beneficiam da infraestrutura modular para reduzir esforço de integração e acelerar o time-to-market.

A Celcoin é participante direta no Pix e Iniciadora de Pagamentos no Open Finance, com integrações nativas à Rede do Sistema Financeiro Nacional, RSFN, e ao Sistema de Pagamentos Brasileiro, SPB. A emissão de CCB é realizada via SCD própria, o que elimina a necessidade de múltiplos fornecedores para cobrir a jornada completa. A tabela a seguir traduz cada capacidade técnica da infraestrutura Celcoin em impacto direto nos indicadores de negócio, como redução de custos de desenvolvimento, aumento de conversão e proteção de receita.

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 e competitividade.
Distribuição white-label e embutida, embedded	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 e protege a receita da sua empresa.
Cobertura de diversas possibilidades de pagamentos, incluindo crédito	Oferta 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	Integração com parceiros estratégicos amplia o alcance e a capacidade de oferta de produtos financeiros.

Saiba mais

• Como automatizar a originação de crédito na minha fintech?

• Como integrar APIs de crédito em fintechs brasileiras?

• Integração com Open Finance para crédito: passo a passo

• Automatizar processos de crédito com Credit as a Service

• Como automatizar a jornada de crédito com conformidade