Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alterações"In Progress" e "Not Finished", as mesmas strings enviadas pelos webhooks.
Faça a correspondência usando essas strings, não nomes em maiúsculas.
Status da sessão
O status geral de uma sessão de Verificação de empresas (KYB), o campo que você usará com mais frequência para decidir o que fazer."Awaiting User" é transitório: você não precisa tirar as sessões desse status manualmente. Assim que o usuário final conclui a ação pendente (por exemplo, envia a lista de pessoas-chave ou envia novamente um documento solicitado), a Didit reavalia a sessão e a muda automaticamente para "In Review", "Approved" ou "Declined", conforme o resultado.Status do recurso
Cada recurso de KYB tem seu próprio status, que é consolidado no status da sessão.Nomes dos recursos de KYB
Estes são os valores defeatures em uma sessão de KYB e nos webhooks:
KYB_REGISTRY: consulta ao registro de empresas.AML: análise AML no nível da empresa.KYB_DOCUMENTS: coleta de documentos e OCR.KYB_KEY_PEOPLE: pessoas-chave: UBOs, acionistas, diretores, representantes e outros administradores.
Status do registro (do provedor)
O status oficial da empresa, obtido de fontes de registro oficiais. Reflete a situação legal ou regulatória da entidade conforme informada pelo registro de cada jurisdição, por isso os valores exatos variam conforme a fonte. Aparece na decisão de KYB emcompany.registry_status.
Como
registry_status reflete os valores brutos do registro, use verification_status, descrito abaixo, quando precisar de um indicador consistente entre jurisdições para orientar a lógica do seu produto.Status de verificação da empresa
Um status padronizado, voltado para empresas, para cada resultado de empresa. Normaliza os diferentes status de registro e de empresa de vários países e fontes em um único indicador consistente, que pode ser interpretado diretamente no seu produto. Aparece na decisão de KYB emcompany.verification_status.
Status de obtenção dos dados da empresa
Indica o andamento da obtenção de dados de um registro específico de empresa em registros externos ou oficiais. Use-o para determinar o nível de completude das informações obtidas de uma empresa. Aparece na decisão de KYB emcompany.fetch_status.
Status da verificação AML
Retornado para cada análise (de empresa ou de pessoa).Como uma decisão se explica
A decisão de KYB não traz uma única string de código de motivo. Cada array de recursos (registry_checks[], document_verifications[], key_people_checks[], aml_screenings[]) traz warnings[] com tags KYB_* e de AML, e decision_trace registra como a decisão foi tomada.
Consulte as tags em Avisos de KYB e registre-as junto ao status da sessão.
Quando um revisor define o status manualmente, contrariando a agregação da própria plataforma, a decisão traz status_override com a data e hora overridden_at e o automatic_status que a plataforma teria definido.
Consulte o esquema de resposta.
Próximos passos
Esquema de resposta
Onde cada status aparece no payload.
Avaliação de risco
O que determina o resultado de uma verificação KYB.
Webhooks
Eventos disparados nas mudanças de status.