Começar
Integrar / SDKs
Verificação de utilizadores
Verificação de empresas
Monitorização de transações
Registo de alterações"In Progress" e "Not Finished", as mesmas strings que os webhooks transportam.
Faça a comparação com essas strings exatas, e não com nomes em maiúsculas.
Estado da sessão
O estado geral de uma sessão de Verificação de empresas (KYB), o campo que mais vezes vai usar para tomar decisões."Awaiting User" é transitório: não precisa de retirar manualmente as sessões deste estado. Assim que o utilizador final concluir a ação pendente (por exemplo, submeter a lista de pessoas-chave ou reenviar um documento pedido), a Didit reavalia a sessão e a passa automaticamente para "In Review", "Approved" ou "Declined", conforme o resultado.Estado da funcionalidade
Cada funcionalidade KYB tem o seu próprio estado, que se agrega no estado da sessão.Nomes das funcionalidades KYB
Estes são os valores defeatures numa sessão KYB e nos webhooks:
KYB_REGISTRY: consulta ao registo de empresas.AML: triagem AML ao nível da empresa.KYB_DOCUMENTS: recolha de documentos e OCR.KYB_KEY_PEOPLE: pessoas-chave, ou seja, UBOs, acionistas, administradores, representantes e outros responsáveis.
Estado do registo (do fornecedor)
A situação oficial da empresa, tal como obtida junto de fontes de registo oficiais. Reflete a situação jurídica ou regulamentar da entidade, conforme reportada pelo registo de cada jurisdição, pelo que os valores exatos variam consoante a fonte. Surge na decisão KYB emcompany.registry_status.
Como
registry_status reflete valores brutos do registo, use verification_status abaixo quando precisar de um indicador consistente e válido em todas as jurisdições para orientar a lógica do produto.Estado de verificação da empresa
Um estado padronizado, orientado para o negócio, por resultado da empresa. Normaliza os diferentes estados de registo e de empresa de vários países e fontes num indicador único e consistente, que pode ser interpretado diretamente no seu produto. Surge na decisão KYB emcompany.verification_status.
Estado de obtenção dos dados da empresa
Indica o progresso da obtenção dos dados de um registo de empresa específico junto de registos externos ou oficiais. Use-o para determinar quão completa está a informação obtida para uma determinada empresa. Surge na decisão KYB emcompany.fetch_status.
Estado da verificação AML
Devolvido por cada triagem (empresa ou pessoa).Como uma decisão se explica
A decisão KYB não inclui uma única cadeia de códigos de motivo. Cada array de funcionalidades (registry_checks[], document_verifications[], key_people_checks[], aml_screenings[]) inclui warnings[] com etiquetas KYB_* e AML, e decision_trace regista a forma como a decisão foi alcançada.
Consulte as etiquetas em Avisos KYB e registe-as junto ao estado da sessão.
Quando um revisor define o estado manualmente em oposição à própria agregação da plataforma, a decisão inclui status_override, com a 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 estado aparece no payload.
Avaliação de risco
O que determina o resultado de um KYB.
Webhooks
Eventos disparados nas alterações de estado.