API de originação de crédito consignado privado: guia 2026

Última atualização: 28 de julho de 2026

Principais lições deste artigo

• A API de originação de crédito consignado privado automatiza quatro etapas sequenciais: consulta de margem com averbação eSocial, análise de crédito, formalização via CCB e liquidação Pix.

• O leiaute eSocial S-1.3 (NT 06/2026) entra em produção em 27/04/2026, com suporte a CNPJ alfanumérico a partir de 01/07/2026.

• Autenticação OAuth 2.0 com mTLS, validação JWT e rate limiting por múltiplos níveis formam o conjunto mínimo de requisitos técnicos para operar em conformidade com as regras do Banco Central e da LGPD.

• Requisitos regulatórios de 2026 incluem eSocial lote S-1.3, LGPD ativa, Open Finance e obrigações da Resolução Conjunta CMN/BCB nº 16/2025 para relações de BaaS.

• Use a infraestrutura de crédito completa da Celcoin para estruturar e escalar sua operação, com APIs modulares, licenças IP/SCD e neutralidade de gestoras em uma única plataforma.

1. Consulta de margem e averbação eSocial

A primeira etapa do fluxo consiste em verificar a margem consignável disponível do trabalhador, que é o percentual máximo do salário que pode ser comprometido com descontos autorizados. Em seguida, a operação registra o desconto na folha de pagamento via eSocial, processo conhecido como averbação. Esse registro garante que o empregador desconte automaticamente a parcela do empréstimo direto da folha, o que reduz o risco de inadimplência.

O endpoint de consulta recebe CPF, matrícula e dados do empregador, e retorna margem máxima, valor máximo de empréstimo e número máximo de parcelas. Antes da chamada, o trabalhador deve fornecer opt-in explícito autorizando o acesso a 30 dias de dados de CPF, matrícula, empregador, elegibilidade, margem, datas de admissão, status PEP e contratos vigentes.

Exemplo de payload de consulta:

{ "cpf": "000.000.000-00", "matricula": "123456", "cnpj_empregador": "00.000.000/0001-00", "ip_cliente": "192.168.0.1", "user_agent": "Mozilla/5.0..." }

A resposta inclui margem_max, max_value, max_installments e um uuid de sessão. O integrador deve armazenar esse identificador e utilizá-lo em todas as chamadas subsequentes do fluxo.

O suporte a CNPJ alfanumérico nos esquemas XSD dos Leiautes eSocial v. S-1.3 (NT 06/2026) entra em produção em 01/07/2026, enquanto a versão principal entra em produção em 27/04/2026. A averbação deve ser enviada via evento eSocial antes da liquidação, e o número de averbação retornado torna-se obrigatório nas etapas seguintes.

Webhooks de status relevantes para esta etapa: AVERBACAO_CONFIRMADA, AVERBACAO_REJEITADA.

2. Análise de crédito e políticas

A confirmação da margem e o registro da averbação permitem iniciar a etapa de análise de crédito. O endpoint de proposta recebe os parâmetros da operação e aplica as políticas definidas pelo originador.

A calculadora aceita o valor líquido desejado (value) ou o valor da parcela (pmt), com suporte apenas aos prazos de 12, 18, 24, 30 ou 36 parcelas. O integrador deve validar os limites retornados na etapa anterior, pois a API não rejeita automaticamente valores que excedam esses limites.

Exemplo de payload de proposta:

{ "uuid_sessao": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "valor_liquido": 5000.00, "prazo": 24, "taxa_juros_mensal": 0.0199, "score_bureau": 720, "politica_id": "POL_CLT_2026" }

A resposta inclui o CET, Custo Efetivo Total, que é obrigatório em qualquer operação de crédito ao consumidor. Instituições financeiras devem divulgar o CET em formato padronizado pelo Banco Central antes da execução do contrato, o que impacta diretamente o design de APIs de originação e formalização de crédito.

Webhooks desta etapa: PROPOSTA_APROVADA, PROPOSTA_REPROVADA, PROPOSTA_EM_REVISAO.

3. Formalização via CCB e emissão digital

A Cédula de Crédito Bancário, CCB, é o instrumento jurídico que formaliza a operação. O endpoint de emissão recebe os dados da proposta aprovada e retorna a CCB assinada digitalmente, com hash de integridade e timestamp qualificado.

Exemplo de payload de emissão:

{ "proposta_id": "PROP-2026-000001", "cpf_tomador": "000.000.000-00", "valor_principal": 5000.00, "prazo": 24, "taxa_cet_mensal": 0.0215, "numero_averbacao": "AVB-20260701-00001", "dados_bancarios": { "banco": "260", "agencia": "0001", "conta": "1234567", "tipo_conta": "Checking" } }

Os dados bancários para crédito devem pertencer ao CPF do tomador e não podem ser conta salário. As instituições aceitas incluem Banco do Brasil, código 001, Caixa, código 104, Nubank, código 260, Itaú, código 341, entre outras.

Webhooks desta etapa: CCB_EMITIDA, CCB_ASSINADA, CCB_CANCELADA.

4. Liquidação de Pix e registro de cessão

A assinatura da CCB libera a etapa de liquidação. O endpoint de disbursement dispara o crédito ao trabalhador via Pix, seguindo os SLAs definidos pelo Open Finance Brasil para o endpoint POST /pix/payments. Em operações com cessão, o registro deve ocorrer em sequência, vinculando o recebível ao fundo ou à securitizadora responsável pelo funding.

Exemplo de payload de liquidação:

{ "ccb_id": "CCB-2026-000001", "chave_pix_destino": "000.000.000-00", "valor_liquido": 5000.00, "descricao": "Liberacao consignado privado CLT" }

Webhooks desta etapa: PAGAMENTO_REALIZADO, PAGAMENTO_FALHOU, CESSAO_REGISTRADA.

Requisitos regulatórios em 2026

As quatro etapas descritas formam o núcleo técnico da originação. Operar em produção exige também conformidade com três eixos regulatórios que passaram a vigorar ou foram atualizados em 2026.

• eSocial S-1.3, lote 120: O leiaute S-1.3, NT 06/2026, entra em produção em 27/04/2026, com suporte a CNPJ alfanumérico a partir de 01/07/2026. A Portaria MTE nº 1.115/2026 regulamenta o uso de garantias sobre verbas rescisórias e FGTS nas operações de consignado privado e orienta a implantação em folha.

• LGPD: Todas as entidades que processam dados pessoais em APIs de originação de crédito devem cumprir a LGPD, com enforcement ativo em 2026 que afeta coleta, retenção, compartilhamento e governança de dados em consultas de margem, validação de elegibilidade e formalização de contratos.

• Open Finance e BaaS: A Resolução Conjunta CMN/BCB nº 16/2025 define responsabilidades das partes envolvidas no BaaS e exige governança corporativa robusta, gestão de riscos, controles internos e segurança da informação. Fintechs autorizadas pelo Banco Central devem garantir confidencialidade, integridade e disponibilidade dos sistemas, com planos de resposta a incidentes e conformidade com a Resolução BCB nº 498/25 para ambientes críticos conectados à RSFN e ao Pix.

Autenticação OAuth 2.0 + mTLS

Autenticação segura em APIs de consignado privado combina múltiplas camadas de proteção. O padrão em 2026 utiliza OAuth 2.0 com mTLS, mutual TLS, e validação de tokens JWT em cada requisição.

Tokens OAuth 2.0 com mecanismos de refresh e rotação regular de chaves armazenadas em variáveis de ambiente fornecem controle de acesso seguro para fluxos de dados financeiros sensíveis. Esses tokens precisam de validação consistente.

A validação JWT deve verificar assinatura, algoritmo, expiração, emissor e audience em cada requisição, com tokens de acesso de curta duração, 15 minutos ou menos, e fluxos de refresh baseados em PKCE para APIs financeiras externas.

A camada de transporte deve usar TLS 1.3 em todas as conexões, inclusive no tráfego interno entre serviços, e, quando TLS 1.2 for necessário, aplicar cipher suites fortes como AES-GCM ou ChaCha20-Poly1305.

API gateways funcionam como pontos centralizados de autenticação, autorização, rate limiting, filtragem de tráfego e logging, o que reduz a superfície de ataque em APIs de alta volumetria como as de originação de crédito.

Rate limiting e throttling complementam essa arquitetura ao prevenir abuso e garantir alocação adequada de recursos durante picos de consultas de margem e envios em lote ao eSocial.

Como a Celcoin resolve?

A Celcoin não oferece empréstimo diretamente para consumidores. A Celcoin fornece infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes com segurança regulatória e escala.

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 esforço 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.
Distribuição white-label e embutida, embedded	Suporte a produtos financeiros com marca própria em diferentes jornadas digitais.
Escalabilidade com confiabilidade	Infraestrutura em nuvem com alta disponibilidade mantém serviços estáveis em altos volumes e protege a receita.
Cobertura de pagamentos e 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 impacto direto em conversão e retenção.
Compliance e conformidade como princípio	KYC, AML e relatórios integrados reduzem risco regulatório e encurtam 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 e reduzem tempo de entrada no mercado.

A solução de crédito da Celcoin cobre toda a jornada de originação à liquidação com APIs modulares, licenças de Instituição de Pagamento, IP, e Sociedade de Crédito Direto, SCD, próprias, participação direta no Pix e atuação como Iniciadora de Pagamentos no Open Finance. A plataforma opera com neutralidade de gestoras, sem favorecer nenhum fundo em detrimento de outro, e atende originadores, correspondentes bancários, fintechs, ERPs e varejistas de diferentes portes.

Checklist de integração com estimativas de esforço

Item	Perfil fintech	Perfil ERP/varejista	Esforço estimado
Configuração OAuth 2.0 + mTLS	Equipe interna	Equipe interna ou parceiro	1 a 3 dias
Integração endpoint de margem eSocial	Direto via API	Via middleware ERP	3 a 5 dias
Averbação e rubrica 9253	Direto via API	Adaptação de folha	2 a 5 dias
Motor de crédito e políticas	Configuração de parâmetros	Integração com score bureau	3 a 7 dias
Emissão de CCB digital	Endpoint único	Endpoint único	1 a 2 dias
Liquidação Pix	Participante direto ou via IP	Via IP/SCD parceira	1 a 3 dias
Configuração de webhooks	URL própria	URL própria ou ERP	1 a 2 dias
Adequação LGPD, opt-in e retenção	Revisão jurídica e técnica	Revisão jurídica e técnica	5 a 10 dias
Testes em sandbox	Ambiente dedicado	Ambiente dedicado	3 a 5 dias

FAQ

O que muda na averbação de consignado privado CLT com o eSocial S-1.3 em 2026?

A atualização do eSocial traz duas mudanças principais para originadores de crédito. O leiaute S-1.3 entra em produção em 27/04/2026, e o suporte a CNPJ alfanumérico nos esquemas XSD, NT 06/2026, chega em 01/07/2026. Originadores e plataformas de crédito precisam integrar o evento de averbação ao fluxo de API antes da liquidação, garantindo que o número de averbação gerado pelo eSocial seja vinculado à CCB emitida. A Portaria MTE nº 1.115/2026 regulamenta ainda o uso de garantias sobre verbas rescisórias e FGTS nas operações de consignado privado.

Qual é a diferença entre operar com licença própria e usar a licença de um parceiro de infraestrutura no consignado privado?

Operar com licença própria de SCD exige autorização do Banco Central, capital mínimo, estrutura de governança, controles de risco e conformidade contínua com resoluções como a CMN/BCB nº 16/2025. Para empresas que ainda não possuem essa licença, como fintechs em estágio inicial, ERPs e varejistas, utilizar a licença de um parceiro de infraestrutura como a Celcoin permite lançar produtos de crédito consignado privado com segurança jurídica e conformidade regulatória sem o custo e o tempo de obtenção de autorização própria. Empresas que já possuem licença podem usar a infraestrutura da Celcoin para escalar operações sem construir toda a stack tecnológica internamente.

Como a LGPD afeta o design de APIs de consulta de margem e formalização de CCB?

A LGPD exige que cada etapa do fluxo de originação trate dados pessoais com base legal explícita, geralmente consentimento ou execução de contrato. Na prática, isso impacta o design das APIs em três pontos principais. O opt-in do trabalhador deve ser registrado antes da primeira chamada de consulta de margem, com evidência de IP e user-agent. Os dados retornados precisam ser minimizados, retornando apenas o necessário para cada etapa. Os logs de acesso, retenção e compartilhamento de dados devem ser auditáveis. APIs que expõem dados além do necessário ou que não implementam controles de acesso por recurso, BOLA, ficam em desconformidade com a LGPD e com o OWASP API Security Top 10.

Quais são os principais riscos técnicos de uma integração manual versus uma integração via API automatizada no consignado privado?

Processos manuais no consignado privado CLT geram riscos operacionais, regulatórios e financeiros. O risco operacional inclui retrabalho, erros de digitação e atrasos na averbação que podem invalidar a operação. O risco regulatório envolve descumprimento de prazos do eSocial e ausência de trilha de auditoria para LGPD e Banco Central. O risco financeiro aparece na liquidação sem averbação confirmada e na cessão de recebível sem registro formal. Uma integração via API automatizada reduz esses riscos ao impor sequência obrigatória entre etapas, validar payloads antes do processamento, entregar status em tempo real via webhooks e manter logs estruturados para auditoria.

A Celcoin fornece crédito diretamente para trabalhadores CLT?

A Celcoin não fornece crédito diretamente para trabalhadores CLT. A Celcoin disponibiliza infraestrutura tecnológica para que empresas, como originadores, correspondentes bancários, fintechs, ERPs e varejistas, ofertem produtos de crédito consignado privado aos seus clientes finais. A Celcoin oferece APIs modulares, licenças IP e SCD, integração com eSocial, emissão de CCB e liquidação via Pix, mas não atua como credor direto ao trabalhador. O funding permanece sob responsabilidade da empresa cliente, que pode utilizar capital próprio, fundo de investimento ou veículo de securitização.