Definições simples para os termos que aparecem no console, nos webhooks e na API - session, workflow, application, vendor_data, warning, UBO, KYT e o resto.

Resposta curta

Aplicação - um espaço de trabalho dentro de uma organização, com seus próprios workflows e sua própria chave de API. Mude para Sandbox no seletor abaixo do nome da aplicação, crie uma chave de API de teste e use-a. As verificações são simuladas, sem cobrança, e você escolhe o resultado.

Workflow - o conjunto de verificações que você quer rodar, em ordem, com qualquer lógica de ramificação. Montado visualmente no console. A configuração de um workflow é o que determina o preço de uma sessão.

Sessão - a tentativa única de uma pessoa em um workflow. Tem um session_id, um status e um resultado por verificação. Às vezes chamada de verificação.

Os termos abaixo aparecem no console, nos payloads de webhook e na API. Esta página traz a versão em linguagem simples.

#Objetos principais

Organização - sua conta. Contém seu time, seu saldo de faturamento e tudo o mais abaixo.

Aplicação - um espaço de trabalho dentro de uma organização, com seus próprios workflows e sua própria chave de API. Mude para Sandbox no seletor abaixo do nome da aplicação, crie uma chave de API de teste e use-a. As verificações são simuladas, sem cobrança, e você escolhe o resultado.

Produtos e o que eles incluem: A Didit tem três produtos: Verificação de identidade, Monitoramento de transações e Travel Rule e Autenticação (em acesso antecipado).

Pessoas e empresas: Pessoas e Empresas, na barra lateral, listam todos que você já verificou, com um registro para cada um, não importa quantas verificações tenham feito.

Workflow - o conjunto de verificações que você quer rodar, em ordem, com qualquer lógica de ramificação. Montado visualmente no console. A configuração de um workflow é o que determina o preço de uma sessão.

Sessão - a tentativa única de uma pessoa em um workflow. Tem um session_id, um status e um resultado por verificação. Às vezes chamada de verificação.

Sessão de empresa - o equivalente em KYB: a tentativa de uma empresa em um workflow de verificação de negócio. Pode gerar sessões filhas para as pessoas por trás da empresa.

Funcionalidade (também chamada de módulo, ou etapa) - uma verificação individual: verificação de ID, prova de vida passiva, triagem AML, e assim por diante. Você é cobrado por funcionalidade concluída, não por sessão.

Decisão - o objeto de resultado completo de uma sessão: o status mais o resultado próprio de cada funcionalidade, os dados extraídos, as pontuações e os avisos.

#Status e resultados

Approved / Declined / In Review - os três resultados que importam. In Review significa que as verificações automáticas sinalizaram algo que uma pessoa precisa resolver. Veja o que cada status de sessão significa.

Aviso (warning) - um motivo específico e nomeado pelo qual uma verificação sinalizou algo, como DOCUMENT_EXPIRED ou LOW_FACE_MATCH_SIMILARITY. Os avisos são o motivo pelo qual uma sessão recebeu seu status. São o que você deve ler quando quer saber o que realmente aconteceu.

Reenvio (resubmission) - pedir para um usuário refazer apenas as etapas que falharam, mantendo a mesma sessão e o mesmo histórico de auditoria.

Decidida - existe um veredito: Approved, Declined ou Kyc Expired. Não é o mesmo que imutável - um revisor pode reabrir uma decisão e o monitoramento contínuo de AML pode mover uma sessão aprovada mais tarde, então continue tratando as atualizações.

#Identificadores

session_id - o identificador da Didit para uma sessão. Use-o ao contatar o suporte; é a forma mais rápida de qualquer pessoa ver exatamente o que você está vendo.

vendor_data - seu identificador para o usuário, que você define ao criar a sessão. Ele volta em todo webhook, e é assim que a Didit agrupa várias sessões sob um usuário consolidado. Defina-o como o ID interno do seu usuário.

vendor_business_data - a mesma ideia, mas para uma empresa em KYB.

txn_id - seu identificador para uma transação no monitoramento de transações, diferente do transaction_id da Didit.

#Conceitos de verificação

KYC (know your customer) - verificar que uma pessoa é quem diz ser.

KYB (know your business) - verificar uma empresa: que ela existe, os dados de registro dela, e quem a possui e controla.

AML (anti-money laundering) - checar uma pessoa ou empresa em listas de sanções, PEP e mídia adversa.

KYT (know your transaction) - monitorar transações em busca de risco depois do onboarding, incluindo a triagem de carteiras de criptomoedas.

PEP - pessoa politicamente exposta. Alguém em uma função pública de destaque, que carrega risco maior e geralmente precisa de diligência reforçada em vez de uma recusa automática.

RCA - parente ou associado próximo de um PEP, checado pelo mesmo motivo.

UBO - beneficiário final (ultimate beneficial owner). A pessoa física que, no fim das contas, possui ou controla uma empresa. Encontrá-la é o objetivo do KYB.

Liveness (prova de vida) - provar que a selfie veio de um humano vivo na frente da câmera, e não de uma foto, uma tela reproduzindo um vídeo, ou uma máscara. Passiva não exige nenhuma ação do usuário; ativa pede um movimento ou usa uma sequência de luzes.

Face match 1:1 - comparar a selfie com a foto do documento. Gera uma pontuação de similaridade.

Face search 1:N - comparar a selfie com todos os rostos já verificados por você, para identificar contas duplicadas e pessoas na blocklist.

Biometric authentication - reverificar um usuário recorrente apenas pelo rosto, sem refazer o documento.

MRZ - a zona de leitura mecânica: as duas ou três linhas de texto monoespaçado na parte inferior de um passaporte ou documento de identidade. Ela carrega checksums, então uma falha no MRZ é um forte sinal de adulteração.

NFC - ler o chip assinado criptograficamente dentro de um ePassport ou documento de identidade com chip usando um celular. A verificação de documento mais forte disponível.

PoA (proof of address) - comprovante de endereço: verificar onde alguém mora a partir de uma conta de consumo, extrato bancário, ou documento similar.

Database validation - checar os dados que um usuário informou contra uma fonte oficial, em vez de contra o documento dele.

Document AI - extrair dados estruturados de um documento de apoio qualquer que não seja um documento de identidade.

#Casos e investigações

Sua caixa de entrada: A Caixa de entrada é o segundo item da barra lateral.

O feed de Eventos: Eventos, na barra lateral, é um único feed ao vivo de todos os seus produtos: sessões de verificação, transações, ações automatizadas e eventos personalizados que você envia com a Events API, como logins, saques ou chargebacks.

Trabalhando com casos: Abra Verificação de identidade → Casos.

Redes de fraude: Abra Verificação de identidade → Redes.

O Investigador da Didit: O Investigador lê cada item que entra em revisão (uma verificação, uma correspondência AML, um alerta de transação ou um caso), compara com a sua política e escreve um relatório recomendando aprovar, recusar ou encaminhar.

Modo de observação - o estágio em que o Investigador escreve um relatório para cada item e se avalia comparando com as decisões da sua equipe, mas não decide nada. Nunca é cobrado.

Nível de autonomia (também nível de automação) - quanto o Investigador pode fazer em uma fila: Desligado, Sugerir, Automático ou Totalmente automático. Veja o Investigador da Didit.

Segmento - condições, como países, risco, fluxos de trabalho ou uma faixa de valores, que reduzem o nível de autonomia de uma fila ou aumentam o limiar de confiança dela para os itens que correspondem. Veja controlar e supervisionar o Investigador.

Bloqueio - uma regra sua de que um item correspondente nunca é aprovado automaticamente, ou nunca é decidido sem uma pessoa.

Proteção - uma das regras fixas do Investigador que ninguém pode desativar, nem mesmo os proprietários: por exemplo, correspondências com sanções sempre vão para uma pessoa.

Conjunto de referência (golden set) - itens de referência com o resultado que você espera para cada um. Cada mudança na política é conferida com eles antes de ser publicada. Veja configurar o Investigador e a sua política.

Desvio - uma queda na frequência com que o Investigador concorda com a sua equipe, ou uma mudança no tipo de itens que ele recebe. Com a proteção contra desvio ativada, a fila desce um nível de autonomia.

Verificação de consistência - o Investigador revisa os mesmos itens de novo, três vezes cada por padrão, para medir com que frequência ele repete a recomendação. Gratuita.

Pedido de informação (também RFI) - uma conversa privada em que o Investigador pede à pessoa que você verifica o que está faltando, com um prazo e lembretes. Veja o Investigador, as pessoas que você verifica e os dados delas.

Rascunho de SAR (também rascunho de STR) - uma comunicação de atividade suspeita ou de transação suspeita que o Investigador redige, com um arquivo goAML, para uma pessoa assinar e enviar à sua unidade de inteligência financeira. A Didit nunca a envia.

Precedente - uma decisão anterior da sua equipe sobre um item com as mesmas situações na mesma fila, que um relatório mostra ao lado da recomendação.

Como o Didit Copilot funciona: O Didit Copilot aparece como Pergunte à Didit na borda direita, ou abre com Cmd+J (Ctrl+J no Windows e Linux).

#Termos de integração

Verification link (link de verificação) - uma URL hospedada (e um QR code) que roda um workflow sem nenhum código do seu lado.

Reusable link (também chamado de uni-link) - um único link de longa duração que cria uma nova sessão a cada visitante, em vez de um link por usuário.

Webhook - a Didit chamando seu servidor quando algo muda. A forma recomendada de obter resultados. Veja como obter resultados com webhooks.

Signing secret - o segredo por destino que você usa para verificar a assinatura HMAC de um webhook. Não é a mesma coisa que sua chave de API.

Environment - sandbox ou live, presente em todo webhook para que você diferencie tráfego de teste de tráfego real.

White label - rodar o fluxo de verificação com a sua própria marca, opcionalmente no seu próprio subdomínio.

Ainda com dúvida? Fale com uma pessoa.

Inclua o ID da sua organização e o ID da sessão sobre a qual você está perguntando.

Contatar o suporte