> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifokal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Glossário

> Os termos de verificação de identidade e de empresa (KYC, KYB, PEP, prova de vida, 1:1 e 1:N) e o vocabulário da API UNIFOKAL, um verbete por âncora.

## Glossário

Os termos de verificação de identidade e de empresa que aparecem no mercado, e o vocabulário da API UNIFOKAL: prefixos de id, estados da verificação e eventos de webhook. Os verbetes da API saem do mesmo contrato que a referência usa, então o que está aqui é o que a API devolve.

* [A](https://docs.unifokal.com/glossario.md#evento-act-rejected)
* [B](https://docs.unifokal.com/glossario.md#beneficiario-final)
* [C](https://docs.unifokal.com/glossario.md#chave-secreta)
* [D](https://docs.unifokal.com/glossario.md#recomendacao-decline)
* [E](https://docs.unifokal.com/glossario.md#envelope-de-erro)
* [F](https://docs.unifokal.com/glossario.md#face-match-1-1)
* [H](https://docs.unifokal.com/glossario.md#risco-high)
* [I](https://docs.unifokal.com/glossario.md#idempotencia)
* [K](https://docs.unifokal.com/glossario.md#kyb)
* [L](https://docs.unifokal.com/glossario.md#lgpd)
* [M](https://docs.unifokal.com/glossario.md#matricula-biometrica)
* [O](https://docs.unifokal.com/glossario.md#ocr-de-documento)
* [P](https://docs.unifokal.com/glossario.md#evento-passkey-bound)
* [R](https://docs.unifokal.com/glossario.md#reautenticacao-facial)
* [S](https://docs.unifokal.com/glossario.md#screening)
* [T](https://docs.unifokal.com/glossario.md#titular)
* [U](https://docs.unifokal.com/glossario.md#evento-user-created)
* [V](https://docs.unifokal.com/glossario.md#prefixo-verification)
* [W](https://docs.unifokal.com/glossario.md#webhook)

### act.rejected

O titular recusou o ato que a sessão pedia para ele aprovar com a passkey.

Na documentação: [Aprovação de ato com passkey](https://docs.unifokal.com/modulos/passkey.md#modulo-passkey). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [Titular](https://docs.unifokal.com/glossario.md#titular).

### Ambiente (sandbox e produção)

Sandbox é o ambiente de teste, gratuito e com desfechos simulados; produção verifica gente de verdade e é cobrado. O ambiente é definido pela chave usada.

Na documentação: [Sandbox e produção: o que muda](https://docs.unifokal.com/ambientes.md#ambientes). Veja também: [Chave secreta (unifokal\_test\_ e unifokal\_live\_)](https://docs.unifokal.com/glossario.md#chave-secreta), [Flow](https://docs.unifokal.com/glossario.md#flow).

### approve (Aprovar)

Recomendação de aprovar, no campo recommendation do webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [review (Revisar)](https://docs.unifokal.com/glossario.md#estado-review).

### approved (Aprovado)

A verificação foi aprovada. Libere o que dependia dela.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [verification.completed](https://docs.unifokal.com/glossario.md#evento-verification-completed).

### Assinatura eletrônica avançada

Assinatura de um documento ligada de forma única a quem assinou, com a identidade verificada e prova conferível fora da UNIFOKAL.

Na documentação: [Assinatura eletrônica](https://docs.unifokal.com/modulos/assinatura.md#modulo-assinatura). Veja também: [Dossiê](https://docs.unifokal.com/glossario.md#dossie), [KYC (conheça o seu cliente)](https://docs.unifokal.com/glossario.md#kyc).

### auth.compromised\_password

A senha certa de um usuário está em um vazamento conhecido. O login dele virou a redefinição de senha por código.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### auth.refresh\_reuse\_detected

Um refresh token já usado voltou a ser apresentado. A sessão inteira foi encerrada: peça um novo login.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### auth.suspicious\_sign\_in

Um login fora do habitual foi concluído. O corpo traz só as categorias (aparelho novo, viagem impossível, rede de risco ou rajada de falhas).

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### Beneficiário final (UBO)

A pessoa natural que, no fim da cadeia societária, controla ou é dona de uma empresa, direta ou indiretamente.

Na documentação: [Cadeia societária até o beneficiário final](https://docs.unifokal.com/modulos/ubo-profundo.md#modulo-ubo-profundo). Veja também: [KYB (conheça a empresa)](https://docs.unifokal.com/glossario.md#kyb), [Screening](https://docs.unifokal.com/glossario.md#screening).

### blocked (Bloqueado)

A verificação bateu na sua lista de bloqueio. Não é cobrada.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Lista de bloqueio](https://docs.unifokal.com/glossario.md#lista-de-bloqueio), [verification.blocked](https://docs.unifokal.com/glossario.md#evento-verification-blocked).

### Busca 1:N (múltiplas contas)

Comparação de um rosto com todos os rostos já verificados na sua base, para saber se a mesma pessoa já abriu outra conta com outro nome.

Na documentação: [Detecção de múltiplas contas (1:N)](https://docs.unifokal.com/modulos/face-unica.md#modulo-face-unica). Veja também: [Face match 1:1](https://docs.unifokal.com/glossario.md#face-match-1-1), [Lista de bloqueio](https://docs.unifokal.com/glossario.md#lista-de-bloqueio).

### Chave secreta (unifokal\_test\_ e unifokal\_live\_)

A credencial da sua integração, usada só no seu servidor. unifokal\_test\_ chama o sandbox e unifokal\_live\_ chama a produção.

Na documentação: [Autenticação](https://docs.unifokal.com/autenticacao.md#auth). Veja também: [Ambiente (sandbox e produção)](https://docs.unifokal.com/glossario.md#ambiente), [Credencial do painel (dsk\_)](https://docs.unifokal.com/glossario.md#credencial-do-painel).

### consent\_declined (Consentimento recusado)

O titular recusou o consentimento na abertura da verificação. É um desfecho neutro e final, nunca reprovação.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [Titular](https://docs.unifokal.com/glossario.md#titular), [LGPD](https://docs.unifokal.com/glossario.md#lgpd).

### Credencial do painel (dsk\_)

A credencial da sessão de um membro no painel. Não entra nas rotas da integração, que só aceitam a chave secreta.

Na documentação: [Autenticação](https://docs.unifokal.com/autenticacao.md#auth). Veja também: [Chave secreta (unifokal\_test\_ e unifokal\_live\_)](https://docs.unifokal.com/glossario.md#chave-secreta).

### decline (Recusar)

Recomendação de recusar, no campo recommendation do webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [review (Revisar)](https://docs.unifokal.com/glossario.md#estado-review).

### denied (Recusado)

A verificação foi recusada. Não libere o acesso, e fale com o titular pelo texto de subject\_message.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [verification.completed](https://docs.unifokal.com/glossario.md#evento-verification-completed).

### Desfecho

O estado final de uma verificação (aprovada, recusada, em revisão e os demais) e o que você faz com cada um.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [approved (Aprovado)](https://docs.unifokal.com/glossario.md#estado-approved), [denied (Recusado)](https://docs.unifokal.com/glossario.md#estado-denied), [review (Revisar)](https://docs.unifokal.com/glossario.md#estado-review), [approve (Aprovar)](https://docs.unifokal.com/glossario.md#recomendacao-approve).

### Dossiê

O registro completo de uma verificação ou de uma assinatura, com as evidências e os carimbos, para guardar e apresentar a quem precisar conferir.

Na documentação: [Assinatura eletrônica](https://docs.unifokal.com/modulos/assinatura.md#modulo-assinatura). Veja também: [Verificação](https://docs.unifokal.com/glossario.md#verificacao), [Assinatura eletrônica avançada](https://docs.unifokal.com/glossario.md#assinatura-eletronica).

### Envelope de erro

A forma de toda resposta de erro da API: um código estável em error e um texto legível em message. Trate pelo código.

Na documentação: [API REST (4 endpoints públicos)](https://docs.unifokal.com/api-rest.md#api). Veja também: [Idempotência](https://docs.unifokal.com/glossario.md#idempotencia).

### Face match 1:1

Comparação de um rosto com outro rosto específico: a selfie do titular contra a foto do documento dele. Responde se são a mesma pessoa.

Na documentação: [Documento, face match e prova de vida](https://docs.unifokal.com/modulos/identidade.md#modulos-identidade). Veja também: [Busca 1:N (múltiplas contas)](https://docs.unifokal.com/glossario.md#busca-1-n), [Prova de vida (liveness)](https://docs.unifokal.com/glossario.md#prova-de-vida), [Reautenticação facial](https://docs.unifokal.com/glossario.md#reautenticacao-facial).

### failed (Erro)

A análise não foi concluída do nosso lado. Não é cobrada e não é reprovação do titular: abra uma verificação nova para ele.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [verification.failed](https://docs.unifokal.com/glossario.md#evento-verification-failed).

### Flow

A receita da verificação: quais módulos rodam e em que ambiente. Você monta no painel, e cada sessão aponta um flow pelo flow\_id.

Na documentação: [Integração ponta a ponta](https://docs.unifokal.com/integracao.md#integracao). Veja também: [Módulo](https://docs.unifokal.com/glossario.md#modulo), [flow\_ (flow)](https://docs.unifokal.com/glossario.md#prefixo-flow), [Ambiente (sandbox e produção)](https://docs.unifokal.com/glossario.md#ambiente).

### flow\_ (flow)

Prefixo do id de um flow. É o valor que vai em flow\_id na criação da sessão.

Na documentação: [POST /v1/verification-sessions](https://docs.unifokal.com/api-rest.md#post-sessions). Veja também: [Flow](https://docs.unifokal.com/glossario.md#flow).

### high (risco alto)

Nível de risco alto, no campo risk\_level do webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho).

### HMAC (assinatura do webhook)

O cabeçalho que prova que o webhook saiu da UNIFOKAL e não foi alterado. O seu servidor confere com o segredo que você cadastrou antes de confiar no corpo.

Na documentação: [Valide a assinatura do webhook](https://docs.unifokal.com/webhooks.md#webhook-signature). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [Replay de webhook](https://docs.unifokal.com/glossario.md#replay).

### Idempotência

Repetir a mesma chamada não duplica o efeito. Na criação de sessão o reference\_id é a chave: o retry recebe a mesma sessão, sem cobrança dupla.

Na documentação: [Integração ponta a ponta](https://docs.unifokal.com/integracao.md#integracao). Veja também: [reference\_id](https://docs.unifokal.com/glossario.md#reference-id), [Sessão de verificação](https://docs.unifokal.com/glossario.md#sessao-de-verificacao).

### KYB (conheça a empresa)

Verificação de uma empresa: CNPJ, situação cadastral, quadro societário, representante e beneficiário final.

Na documentação: [Consulta cadastral de CPF e de CNPJ](https://docs.unifokal.com/modulos/cadastrais.md#modulos-cadastrais). Veja também: [KYC (conheça o seu cliente)](https://docs.unifokal.com/glossario.md#kyc), [Beneficiário final (UBO)](https://docs.unifokal.com/glossario.md#beneficiario-final), [Screening](https://docs.unifokal.com/glossario.md#screening).

### KYC (conheça o seu cliente)

Verificação de que uma pessoa é quem diz ser, antes de abrir conta ou liberar um serviço. Reúne documento, face match, prova de vida e consultas cadastrais e de listas.

Na documentação: [Documento, face match e prova de vida](https://docs.unifokal.com/modulos/identidade.md#modulos-identidade). Veja também: [KYB (conheça a empresa)](https://docs.unifokal.com/glossario.md#kyb), [Prova de vida (liveness)](https://docs.unifokal.com/glossario.md#prova-de-vida), [Face match 1:1](https://docs.unifokal.com/glossario.md#face-match-1-1), [PEP (pessoa exposta politicamente)](https://docs.unifokal.com/glossario.md#pep).

### LGPD

Lei Geral de Proteção de Dados Pessoais (Lei 13.709/2018), que rege o tratamento de dado pessoal no Brasil.

Na documentação: [Privacidade e consentimento](https://docs.unifokal.com/conta-e-dados.md#privacidade-consentimento). Veja também: [Titular](https://docs.unifokal.com/glossario.md#titular), [verification.subject\_erased](https://docs.unifokal.com/glossario.md#evento-verification-subject-erased).

### Link hospedado

Um endereço de verificação pronto para mandar ao titular por e-mail ou mensagem, sem integrar o widget na sua página.

Na documentação: [Link de verificação hospedado](https://docs.unifokal.com/api-rest.md#link-hospedado). Veja também: [Widget](https://docs.unifokal.com/glossario.md#widget), [Sessão de verificação](https://docs.unifokal.com/glossario.md#sessao-de-verificacao).

### Lista de bloqueio

A lista de documentos, rostos e referências que você mesmo barrou. Vale para a conta inteira ou só para um flow, e uma verificação que bate nela termina bloqueada.

Na documentação: [Lista de bloqueio](https://docs.unifokal.com/ambientes.md#blocklist). Veja também: [blocked (Bloqueado)](https://docs.unifokal.com/glossario.md#estado-blocked), [verification.blocked](https://docs.unifokal.com/glossario.md#evento-verification-blocked), [reference\_id](https://docs.unifokal.com/glossario.md#reference-id).

### Listas restritivas e sanções

Listas oficiais de pessoas e empresas com restrição, como as de sanções internacionais. Conferir o titular contra elas é parte do screening.

Na documentação: [PEP e listas restritivas](https://docs.unifokal.com/modulos/pep.md#modulo-pep). Veja também: [PEP (pessoa exposta politicamente)](https://docs.unifokal.com/glossario.md#pep), [Screening](https://docs.unifokal.com/glossario.md#screening), [Mídia adversa](https://docs.unifokal.com/glossario.md#midia-adversa).

### low (risco baixo)

Nível de risco baixo, no campo risk\_level do webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho).

### Matrícula biométrica

A referência facial de um titular, criada num onboarding aprovado e usada depois pela reautenticação facial. Existe uma por reference\_id.

Na documentação: [Reautenticação facial](https://docs.unifokal.com/modulos/face-reauth.md#modulo-face-reauth). Veja também: [Reautenticação facial](https://docs.unifokal.com/glossario.md#reautenticacao-facial), [reference\_id](https://docs.unifokal.com/glossario.md#reference-id).

### medium (risco médio)

Nível de risco médio, no campo risk\_level do webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho).

### Mídia adversa

Notícia pública que associa o nome de uma pessoa a crime ou irregularidade, entregue como evidência para revisão.

Na documentação: [Mídia adversa](https://docs.unifokal.com/modulos/midia-adversa.md#modulo-midia-adversa). Veja também: [Screening](https://docs.unifokal.com/glossario.md#screening), [Listas restritivas e sanções](https://docs.unifokal.com/glossario.md#listas-restritivas).

### Módulo

Uma capacidade que dá para ligar num flow, como documento, prova de vida, PEP ou consulta cadastral. Cada um tem seu resultado no webhook.

Na documentação: [Catálogo de módulos](https://docs.unifokal.com/modulos.md#catalogo-modulos). Veja também: [Flow](https://docs.unifokal.com/glossario.md#flow), [Verificação](https://docs.unifokal.com/glossario.md#verificacao).

### Monitoramento contínuo

Vigilância do titular já aprovado nas listas de PEP e sanções, com aviso por webhook quando ele aparece numa delas depois do onboarding.

Na documentação: [Monitoramento contínuo](https://docs.unifokal.com/modulos/monitoring-aml.md#modulo-monitoring-aml). Veja também: [verification.monitoring](https://docs.unifokal.com/glossario.md#evento-verification-monitoring), [Screening](https://docs.unifokal.com/glossario.md#screening).

### MRZ (zona de leitura mecânica)

As linhas de caracteres padronizados no pé de passaportes e documentos de viagem, no padrão ICAO 9303.

Na documentação: [Documento de viagem estrangeiro (MRZ)](https://docs.unifokal.com/modulos/doc-global.md#modulo-doc-global). Veja também: [OCR de documento](https://docs.unifokal.com/glossario.md#ocr-de-documento).

### OCR de documento

Leitura automática dos campos impressos num documento fotografado, como nome, CPF e data de nascimento.

Na documentação: [Documento, face match e prova de vida](https://docs.unifokal.com/modulos/identidade.md#modulos-identidade). Veja também: [MRZ (zona de leitura mecânica)](https://docs.unifokal.com/glossario.md#mrz), [KYC (conheça o seu cliente)](https://docs.unifokal.com/glossario.md#kyc).

### Onboarding

A entrada de um cliente novo no seu produto, o momento em que a verificação de identidade costuma acontecer.

Na documentação: [Integração ponta a ponta](https://docs.unifokal.com/integracao.md#integracao). Veja também: [KYC (conheça o seu cliente)](https://docs.unifokal.com/glossario.md#kyc), [Titular](https://docs.unifokal.com/glossario.md#titular), [Flow](https://docs.unifokal.com/glossario.md#flow).

### passkey.bound

A passkey do titular passou a valer na conta dele na sua base, com o modo do vínculo e a garantia (Identidade ou Presença). Quando o vínculo é uma recuperação, avise o titular.

Na documentação: [Aprovação de ato com passkey](https://docs.unifokal.com/modulos/passkey.md#modulo-passkey). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [Titular](https://docs.unifokal.com/glossario.md#titular).

### passkey.revoked

Uma passkey do titular deixou de valer, revogada pelo painel ou pelo apagamento dos dados dele. Ela não aprova mais nenhum ato.

Na documentação: [Aprovação de ato com passkey](https://docs.unifokal.com/modulos/passkey.md#modulo-passkey). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [Titular](https://docs.unifokal.com/glossario.md#titular).

### Passo condicional

Módulo pago do flow que só é pedido quando uma regra sua acontece, por exemplo quando a nota do Face Match fica abaixo de um número que você escolhe. Se algum sinal ficar sem resposta conclusiva, o passo é pedido. É escolha de custo, nunca proteção.

Na documentação: [Passos condicionais](https://docs.unifokal.com/passos-condicionais.md#passos-condicionais). Veja também: [Flow](https://docs.unifokal.com/glossario.md#flow), [Módulo](https://docs.unifokal.com/glossario.md#modulo).

### pending (Pendente)

A verificação ainda não tem decisão final. Espere o webhook antes de agir.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [verification.pending](https://docs.unifokal.com/glossario.md#evento-verification-pending).

### PEP (pessoa exposta politicamente)

Pessoa que ocupa ou ocupou cargo público relevante, e os familiares e próximos dela. A regulação pede atenção reforçada, não recusa automática.

Na documentação: [PEP e listas restritivas](https://docs.unifokal.com/modulos/pep.md#modulo-pep). Veja também: [Listas restritivas e sanções](https://docs.unifokal.com/glossario.md#listas-restritivas), [PLD e AML](https://docs.unifokal.com/glossario.md#pld-aml), [Screening](https://docs.unifokal.com/glossario.md#screening).

### pix\_device.revoked

Aviso de que um dispositivo Pix cadastrado foi revogado pelo seu operador.

Na documentação: [Cadastro de dispositivo Pix](https://docs.unifokal.com/modulos/pix-device.md#modulo-pix-device). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### PLD e AML

Prevenção à lavagem de dinheiro. No onboarding, é conferir o cliente contra listas de PEP e de sanções e manter o registro do que foi conferido.

Na documentação: [PEP e listas restritivas](https://docs.unifokal.com/modulos/pep.md#modulo-pep). Veja também: [PEP (pessoa exposta politicamente)](https://docs.unifokal.com/glossario.md#pep), [Listas restritivas e sanções](https://docs.unifokal.com/glossario.md#listas-restritivas), [Monitoramento contínuo](https://docs.unifokal.com/glossario.md#monitoramento-continuo).

### pld.alert.created

Aviso de que o monitoramento de PLD/FT selecionou uma operação ou situação para a sua análise. O corpo é mínimo e sigiloso, e o detalhe fica no painel.

Na documentação: [PLD/FT pela regra da norma](https://docs.unifokal.com/pld-ft.md#pld-ft). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### Prova de vida (liveness)

Confirmação de que a selfie é de uma pessoa presente diante da câmera naquele momento, e não de uma foto ou de uma tela apresentada à câmera.

Na documentação: [Documento, face match e prova de vida](https://docs.unifokal.com/modulos/identidade.md#modulos-identidade). Veja também: [Face match 1:1](https://docs.unifokal.com/glossario.md#face-match-1-1), [KYC (conheça o seu cliente)](https://docs.unifokal.com/glossario.md#kyc), [Selfie](https://docs.unifokal.com/glossario.md#selfie).

### Reautenticação facial

Nova confirmação, numa ação sensível, de que quem age agora é a mesma pessoa aprovada no onboarding, sem pedir documento de novo.

Na documentação: [Reautenticação facial](https://docs.unifokal.com/modulos/face-reauth.md#modulo-face-reauth). Veja também: [Face match 1:1](https://docs.unifokal.com/glossario.md#face-match-1-1), [Matrícula biométrica](https://docs.unifokal.com/glossario.md#matricula-biometrica).

### reference\_id

O identificador do titular no SEU sistema, obrigatório na criação da sessão. Volta no webhook, serve de chave de idempotência e pode entrar na lista de bloqueio.

Na documentação: [POST /v1/verification-sessions](https://docs.unifokal.com/api-rest.md#post-sessions). Veja também: [Idempotência](https://docs.unifokal.com/glossario.md#idempotencia), [Titular](https://docs.unifokal.com/glossario.md#titular), [Lista de bloqueio](https://docs.unifokal.com/glossario.md#lista-de-bloqueio).

### Replay de webhook

O reenvio, pedido por você, de entregas de webhook que o seu servidor perdeu, pela API ou pelo painel.

Na documentação: [POST /v1/webhook-events/replay](https://docs.unifokal.com/api-rest.md#post-webhook-replay). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [HMAC (assinatura do webhook)](https://docs.unifokal.com/glossario.md#assinatura-do-webhook).

### review (Revisar)

A verificação precisa de uma decisão humana. Ela aparece na fila de revisão do painel para o seu time decidir.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [review (Revisar)](https://docs.unifokal.com/glossario.md#recomendacao-review).

### review (Revisar)

Recomendação de revisar antes de decidir, no campo recommendation do webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [review (Revisar)](https://docs.unifokal.com/glossario.md#estado-review).

### Screening

A conferência de uma pessoa ou empresa contra listas de PEP, sanções e outras restrições, com a evidência de cada achado no resultado.

Na documentação: [Screening do quadro societário](https://docs.unifokal.com/modulos/screening-socios.md#screening-socios). Veja também: [PEP (pessoa exposta politicamente)](https://docs.unifokal.com/glossario.md#pep), [Listas restritivas e sanções](https://docs.unifokal.com/glossario.md#listas-restritivas), [Monitoramento contínuo](https://docs.unifokal.com/glossario.md#monitoramento-continuo).

### Selfie

A foto do rosto do titular capturada pelo widget durante a verificação.

Na documentação: [O Widget](https://docs.unifokal.com/widget.md#widget). Veja também: [Prova de vida (liveness)](https://docs.unifokal.com/glossario.md#prova-de-vida), [Face match 1:1](https://docs.unifokal.com/glossario.md#face-match-1-1), [Busca 1:N (múltiplas contas)](https://docs.unifokal.com/glossario.md#busca-1-n).

### Sessão de verificação

O que o seu servidor cria com a chave secreta para um titular fazer a verificação. Tem id com prefixo vs\_, vale por tempo limitado e é o que o widget recebe para abrir.

Na documentação: [POST /v1/verification-sessions](https://docs.unifokal.com/api-rest.md#post-sessions). Veja também: [vs\_ (sessão de verificação)](https://docs.unifokal.com/glossario.md#prefixo-verification-session), [Widget](https://docs.unifokal.com/glossario.md#widget), [Verificação](https://docs.unifokal.com/glossario.md#verificacao), [reference\_id](https://docs.unifokal.com/glossario.md#reference-id).

### Titular

A pessoa que está sendo verificada: o seu usuário final, dono dos dados que a verificação trata.

Na documentação: [Privacidade e consentimento](https://docs.unifokal.com/conta-e-dados.md#privacidade-consentimento). Veja também: [reference\_id](https://docs.unifokal.com/glossario.md#reference-id), [Onboarding](https://docs.unifokal.com/glossario.md#onboarding).

### user.created

Um usuário da sua autenticação concluiu o cadastro e a conta dele está ativa.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### user.deleted

A conta de um usuário da sua autenticação foi apagada, pela sua chamada ou pelo apagamento do titular. Apague a sessão dele no seu sistema.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [LGPD](https://docs.unifokal.com/glossario.md#lgpd).

### user.locked

A conta de um usuário da sua autenticação foi bloqueada ou desativada por você. O login dele é recusado.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### user.unlocked

A conta de um usuário da sua autenticação foi desbloqueada e ele volta a entrar.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### user.updated

A conta de um usuário da sua autenticação mudou por uma chamada sua (identificador, metadados ou status).

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### ver\_ (verificação)

Prefixo do id de uma verificação. Chega no webhook em verification\_id, e é por ele que você concilia.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Verificação](https://docs.unifokal.com/glossario.md#verificacao), [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### Verificação

O resultado de uma sessão: a análise dos módulos do flow e o desfecho. Tem id com prefixo ver\_ e chega ao seu servidor pelo webhook.

Na documentação: [Os desfechos, e o que fazer com cada um](https://docs.unifokal.com/integracao.md#desfechos). Veja também: [ver\_ (verificação)](https://docs.unifokal.com/glossario.md#prefixo-verification), [Desfecho](https://docs.unifokal.com/glossario.md#desfecho), [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### verification.blocked

A verificação terminou barrada pela sua lista de bloqueio. Não é cobrada.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Lista de bloqueio](https://docs.unifokal.com/glossario.md#lista-de-bloqueio), [blocked (Bloqueado)](https://docs.unifokal.com/glossario.md#estado-blocked).

### verification.completed

A verificação terminou com uma decisão. O status do corpo diz qual, e é por ele que você age.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [approved (Aprovado)](https://docs.unifokal.com/glossario.md#estado-approved), [denied (Recusado)](https://docs.unifokal.com/glossario.md#estado-denied).

### verification.failed

A análise não foi concluída do nosso lado. A verificação não é cobrada: trate como inconclusiva e abra outra.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [failed (Erro)](https://docs.unifokal.com/glossario.md#estado-failed).

### verification.monitoring

Alerta do monitoramento contínuo: um titular aprovado apareceu numa lista de sanções ou de PEP depois do onboarding. Quem decide é você.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Monitoramento contínuo](https://docs.unifokal.com/glossario.md#monitoramento-continuo), [review (Revisar)](https://docs.unifokal.com/glossario.md#estado-review).

### verification.pending

A verificação ficou aguardando uma decisão. Trate como pendente até o próximo evento dela.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [pending (Pendente)](https://docs.unifokal.com/glossario.md#estado-pending), [review (Revisar)](https://docs.unifokal.com/glossario.md#estado-review).

### verification.subject\_erased

Os dados pessoais do titular daquela verificação foram apagados do nosso lado. Repita o apagamento nos seus sistemas (LGPD, art. 18, § 6º).

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [LGPD](https://docs.unifokal.com/glossario.md#lgpd), [Titular](https://docs.unifokal.com/glossario.md#titular).

### verification\_link.claimed

Aviso de que a pessoa abriu o link de verificação que você emitiu e começou a jornada.

Na documentação: [Assinatura eletrônica](https://docs.unifokal.com/modulos/assinatura.md#modulo-assinatura). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### vs\_ (sessão de verificação)

Prefixo do id de uma sessão de verificação. É o que o widget recebe para montar.

Na documentação: [POST /v1/verification-sessions](https://docs.unifokal.com/api-rest.md#post-sessions). Veja também: [Sessão de verificação](https://docs.unifokal.com/glossario.md#sessao-de-verificacao), [Widget](https://docs.unifokal.com/glossario.md#widget).

### Webhook

O aviso que o nosso servidor manda ao seu quando algo acontece, como a verificação terminar. É a fonte oficial do resultado.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [HMAC (assinatura do webhook)](https://docs.unifokal.com/glossario.md#assinatura-do-webhook), [Replay de webhook](https://docs.unifokal.com/glossario.md#replay), [verification.completed](https://docs.unifokal.com/glossario.md#evento-verification-completed).

### webhook.test

O evento de teste disparado pelo painel, para conferir endereço, assinatura e parser. Nunca representa uma verificação.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook), [HMAC (assinatura do webhook)](https://docs.unifokal.com/glossario.md#assinatura-do-webhook).

### whe\_ (destino de webhook)

Prefixo do id de um destino de webhook cadastrado no painel.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### whk\_ (chave pública de cifra)

Prefixo do id da chave pública que cifra a carga do webhook. Vem no campo kid do envelope cifrado e diz qual chave privada abre a entrega.

Na documentação: [Webhooks e eventos](https://docs.unifokal.com/webhooks.md#webhooks). Veja também: [Webhook](https://docs.unifokal.com/glossario.md#webhook).

### Widget

A tela de verificação que você embute no seu site com uma linha. Monta com o id da sessão e nunca recebe a chave secreta.

Na documentação: [O Widget](https://docs.unifokal.com/widget.md#widget). Veja também: [Sessão de verificação](https://docs.unifokal.com/glossario.md#sessao-de-verificacao), [Link hospedado](https://docs.unifokal.com/glossario.md#link-hospedado).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.