Usando o CertivantClientes recorrentes

Clientes recorrentes

O que a Certivant faz quando você verifica alguém que já foi verificado antes. Ela compara a nova verificação com o arquivo do cliente, tolera uma mudança de endereço, uma CNH renovada ou um sobrenome de casamento, e encaminha um conflito real para uma pessoa.

Who can do this:Org ownerOrg adminOrg member— Os membros veem isso nas solicitações às quais têm acesso.

O que faz

Quando você verifica uma pessoa que já verificou e aprovou na sua organização, a Certivant compara a nova verificação com a anterior — o arquivo do cliente — e mostra ao revisor o que é igual, o que mudou de forma comum e o que entra em conflito.

Ela nunca bloqueia uma mudança legítima. Uma mudança de endereço, uma CNH renovada, um sobrenome de casamento ou um novo número de telefone são situações normais. Só um conflito real adiciona um motivo de revisão, e um motivo de revisão envia a solicitação para uma pessoa — nunca rejeita sozinho.

A comparação fica dentro da sua organização. Nada é comparado com verificações de outra organização, nem exibido a partir delas.

Como a Certivant encontra o arquivo do cliente

Formulários públicos criam um novo registro de solicitante a cada envio, por isso a Certivant não depende desse registro. Ela procura as solicitações anteriores da sua organização para a mesma pessoa, nesta ordem:

  1. A sua própria referência do cliente (a referência que você envia com a solicitação ou no solicitante).
  2. O mesmo e-mail e, depois, o mesmo telefone.

Uma correspondência em uma chave é então confirmada: a data de nascimento precisa coincidir, assim como o nome ou o número do documento. Isso impede que uma caixa de e-mail compartilhada ou um telefone reaproveitado vinculem duas pessoas diferentes. A única exceção é a sua própria referência: se ela corresponder, mas a data de nascimento for diferente, a Certivant aceita a correspondência e a sinaliza — veja O cliente recorrente não corresponde ao arquivo mais abaixo.

O arquivo é a verificação aprovada mais recente da pessoa (o registro de identidade verificada congelado). Verificações excluídas ou apagadas nunca são usadas.

O que é comparado

O cartão Cliente recorrente — comparado com o arquivo, na página de detalhes da solicitação, mostra uma linha por campo, com um status:

StatusSignificado
CorrespondeIgual ao arquivo.
AlteradoDiferente de forma comum. Nenhum motivo de revisão por si só.
ConflitoContradiz o arquivo. Adiciona um motivo de revisão.
DesconhecidoNão pôde ser comparado (não lido, não rotulado no documento ou um documento diferente). Nunca é um conflito.
CampoRegra
Data de nascimentoDeve coincidir exatamente. Uma data diferente é um conflito.
NomeAcentos, ordem das palavras e nomes do meio são ignorados. Um sobrenome diferente com a mesma data de nascimento e o mesmo documento é alterado (casamento, divórcio). Um nome diferente sem esse respaldo é um conflito.
E-mail e telefoneUm valor novo é alterado. É indicado como confirmado por código ou não confirmado.
EndereçoUm endereço novo é alterado — mudanças de endereço são normais.
DocumentoVeja abaixo.

O cartão mostra apenas status e rótulos de regras. Ele não copia os dados pessoais do cliente para nenhum lugar novo.

CNH e documentos de identidade

Documentos são comparados pelo número (e pelo tipo de documento e pelo estado ou província emissora, quando conhecidos). Só contam os valores que o documento indica explicitamente: uma data de validade impressa sem rótulo é desconhecida, nunca um conflito.

SituaçãoResultado
Mesmo número, validade posterior e data de emissão posterior (ou ilegível)Alterado — documento renovado. Legítimo mesmo que o documento antigo ainda não tivesse vencido.
Mesmo número, validade anterior à do arquivoConflito — A validade da CNH conflita com o arquivo.
Mesmo número, mesma data de emissão, validade diferenteConflito (alto). Uma mesma data de emissão não pode ter duas datas de validade.
Mesmo número, validade posterior, mas data de emissão anterior à do arquivoConflito.
Número diferente (ou outro tipo, ou outra província)Desconhecido — outro documento, verificado do zero como qualquer primeiro documento.
Mesmo número, mesma validadeCorresponde.
Mesmo número, mesmo número de referência do cartão ("Referência", "DD"), mas datas diferentesConflito (alto). O número de referência identifica um único cartão físico e muda a cada renovação ou substituição — a mesma referência com outras datas significa que as datas foram alteradas.
Mesmo número, novo número de referência, mesma validadeCorrespondência — cartão de substituição (perda, roubo, mudança de endereço).

Validade informada apenas com o mês vale até o fim desse mês.

Histórico de tentativas

Cada nova verificação também registra quantas vezes você já verificou este cliente e por quais razões. Ela conta todas as tentativas anteriores, não apenas as aprovadas. Uma pessoa é encontrada como descrito acima. Uma empresa (KYB) é encontrada pela sua referência ou pelo seu número de registro.

O cartão na página de detalhes da solicitação mostra:

  • Verificação nº N com sua organização — todas as tentativas, incluindo esta — e quantas foram por esta mesma razão.
  • Como terminaram as tentativas anteriores por esta razão: aprovada, rejeitada, em revisão, não concluída, cancelada.
  • Já verificado aqui para — as razões pelas quais este cliente já foi aprovado, com uma contagem e a última data.

“A mesma razão” significa o mesmo código de razão classificado. Quando a razão não pôde ser classificada, significa o mesmo texto de razão.

A API retorna os mesmos dados como attemptHistory em GET /api/v1/kyc/requests/:id. Ele é null para um cliente de primeira vez. Use-o para decidir o que fazer com um cliente que fica tentando de novo, por exemplo alguém rejeitado três vezes por financiamento de dispositivos:

"attemptHistory": {
  "totalAttempts": 4,
  "samePurposeAttempts": 3,
  "samePurposeOutcomes": { "approved": 0, "rejected": 2, "inReview": 0, "inProgress": 0, "cancelled": 0 },
  "previousOutcomes": { "approved": 1, "rejected": 2, "inReview": 0, "inProgress": 0, "cancelled": 0 },
  "verifiedPurposes": [
    { "purpose": "account_opening", "count": 1, "lastVerifiedAt": "2026-06-02T14:10:00.000Z" }
  ],
  "firstAttemptAt": "2026-03-11T09:00:00.000Z"
}

Somente códigos de razão e contagens são armazenados. Nada vem de outra organização.

Motivos de revisão

Estes três motivos adicionam uma etapa de revisão. Nenhum rejeita.

Motivo de revisãoQuando
A validade da CNH conflita com o arquivo (licence_expiry_conflict)O número da CNH coincide, mas as datas de validade ou de emissão contradizem o arquivo, como na tabela acima.
O cliente recorrente não corresponde ao arquivo (returning_customer_mismatch)A data de nascimento ou o nome conflitam, ou dois ou mais campos de identidade mudaram ao mesmo tempo sem confirmação — um nome novo, um e-mail novo não confirmado, um telefone novo não confirmado. Renovação, mudança de endereço ou contato confirmado por código nunca contam. Uma correspondência pela sua própria referência com data de nascimento diferente indica uma possível apropriação indevida de conta e mostra um aviso vermelho no cartão.
Vários endereços em um ano (address_change_frequent)A mesma pessoa (encontrada como acima) usou três ou mais endereços diferentes nos últimos 12 meses em suas verificações, incluindo esta.

Os endereços são comparados após normalização (maiúsculas, acentos, pontuação, «Street» / «St.», notação de apartamento e unidade, CEP) e guardados apenas como hash com chave.

Usar em políticas e fluxos de trabalho

O designer de políticas e os fluxos de automação podem ler estes campos:

CampoTipoSignificado
returning.isReturningverdadeiro/falsoA mesma pessoa foi verificada e aprovada antes na sua organização.
returning.conflictslistaCampos que conflitam com o arquivo: dateOfBirth, name, document.
returning.changedFieldslistaCampos que mudaram de forma comum: address, email, phone, document, name.
returning.addressCount12mnúmeroEndereços distintos nos últimos 12 meses.

Os três motivos de revisão também podem ser testados com reviewTriggers CONTAINS '…'.