O dossiê de crédito do CPF que você acabou de verificar
Seis consultas sobre a situação de crédito do CPF lido do documento, cada uma como módulo com preço próprio. O que você recebe é o dossiê da fonte, do jeito que ela responde, e ele é informacional: ter dívida não reprova a identidade de ninguém. A venda ainda não abriu, e o preço de cada linha sai do mesmo catálogo público da página de preços.
As seis linhas viajam no catálogo da API com preço e o estado coming_soon, e o construtor de flow recusa ligá-las enquanto a fonte não for liberada na conta do fornecedor de dados. Esta página descreve o que cada módulo entregará quando a venda abrir.
Por que consultar crédito junto da identidade
Uma consulta de crédito vale o que vale o CPF que entrou nela. Aqui o CPF não é digitado num formulário: ele é lido do documento que a pessoa mostrou na câmera, conferido contra o rosto dela e contra a prova de vida da mesma sessão. É por isso que cada módulo desta página exige Documento (OCR), Face Match e Liveness no mesmo flow: o dossiê chega amarrado a uma identidade provada, e não a um número que qualquer pessoa poderia ter copiado.
As seis consultas, uma a uma
Cada linha é um módulo do catálogo, ligado no flow por escolha sua, com preço próprio. Nenhuma delas depende das outras: você liga só as que interessam para a sua análise.
Consulta o CPF do documento e devolve score de crédito, renda presumida e negativações registradas.
Fonte: Bureau de crédito privado
Consulta o endividamento do CPF no Sistema de Informações de Crédito (SCR) do Banco Central: instituições, operações e carteira de crédito.
Fonte: Banco Central do Brasil
Consulta o CPF no bureau Boa Vista SCPC: score e pendências financeiras registradas.
Fonte: Boa Vista Serviços, administradora do SCPC
Consulta protestos em cartório (Cenprot) no nome do CPF do documento: cartório, UF, valor e data.
Fonte: Cartórios de protesto, pela Central Nacional de Serviços Eletrônicos dos Tabeliães de Protesto (Cenprot)
Consulta o CPF no CADIN, o Cadastro Informativo de créditos não quitados do setor público federal.
Fonte: Cadastro do setor público federal da Lei 10.522/2002, normatizado pela Secretaria do Tesouro Nacional
Consulta inscrições do CPF na Dívida Ativa da União (PGFN): número, valor e situação da inscrição.
Fonte: Procuradoria-Geral da Fazenda Nacional (PGFN), do Ministério da Fazenda
O preço ao lado de cada linha já soma o que a consulta exige no flow (Documento (OCR), Face Match e Liveness), pela mesma régua da página de preços. Ligar duas consultas de crédito no mesmo flow não paga a identidade duas vezes.
Retrato de Endividamento SCR
Em breveA sétima linha do grupo: o mesmo dado alvo do SCR Banco Central, por outro fornecedor. Nasceu com a venda pausada e não entra num flow enquanto ela não abrir.
Devolve o retrato de endividamento do CPF junto ao Sistema de Informações de Crédito, com quantidade de instituições, operações e carteira. É informativo: compõe a sua análise de crédito e nunca reprova a verificação de identidade.
Fonte: Banco Central do Brasil
Um detalhe que separa esta linha das seis acima: ela também nunca reprova ninguém, mas se a fonte não responder a verificação vai para revisão humana em vez de seguir sozinha. As seis consultas do pacote não fazem isso: elas ficam de fora do passa ou não passa em qualquer desfecho.
Como o resultado chega
Crédito é informação, nunca veredito de identidade. Nenhuma das seis consultas reprova uma verificação, e nenhuma delas leva a verificação para revisão: elas nem entram no cálculo do score, e o passa ou não passa continua sendo o da biometria. Dívida, protesto ou inscrição em dívida ativa são fatos sobre a vida financeira de alguém, e recusar uma identidade por causa deles seria negar serviço por condição econômica. A decisão de crédito é sua, e ela acontece depois, com o dossiê na mão.
A fonte processa a consulta no tempo dela, tipicamente cerca de um minuto. Enquanto isso o módulo viaja como pending e o dossiê chega num verification.completed posterior, com o número da revisão no id do evento: você faz upsert por esse id e não fica segurando o seu usuário à espera da resposta síncrona.
Sem dossiê, a chave data não vem null: ela simplesmente não existe. Vale enquanto a fonte processa, quando ela não responde na janela e quando o documento não é encontrado. Teste a presença da chave e ramifique pelo outcome, nunca por igualdade a nulo.
Tiramos só o que é da nossa conta com o fornecedor (pacote usado, saldo e identificador da consulta) e o resto passa como veio: o conjunto de chaves é o do pacote, não uma lista fechada nossa. Os valores em dinheiro chegam em reais com decimais, e não em centavos como os saldos do topo do webhook.
Refazemos a consulta sozinhos por uma janela de cerca de vinte minutos. Se ela ainda assim não concluir, o módulo termina como indisponível e a checagem não entra na sua fatura. Indisponibilidade nunca vira um nada consta falso: você enxerga a diferença entre não dever e não ter sido possível perguntar.
O formato exato de cada dossiê, campo a campo, está na seção de análise de crédito da documentação. No sandbox o dossiê vem pronto, sem os dois tempos da fonte real, e o desfecho segue o sufixo do documento de teste.
A UNIFOKAL não é bureau de crédito, não concede crédito e não calcula score de crédito próprio. Entregamos o dossiê que a fonte devolve sobre o CPF verificado, e a análise e a decisão de crédito são sempre da sua operação.
A guarda regulatória de longo prazo é obrigação da sua operação. A nossa retenção padrão é de 180 dias e não substitui o seu arquivo.
Crie a conta, monte no sandbox o flow de identidade que vai carregar as consultas de crédito e receba o webhook inteiro, sem consumir saldo.