> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Status de KYB: referência de sessão, recurso e AML > Status exatos do Didit para sessões KYB, recursos, consultas a registros e triagens AML. A partir de $2.00 por verificação, por país e nível. A Verificação de empresas acompanha o status em vários níveis: a **sessão**, cada **recurso**, a **consulta ao registro** e o **resultado AML**. Esta página é a referência para todos os estados. A API retorna os valores de status como rótulos exatos, que diferenciam maiúsculas de minúsculas, como `"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. | Status | Significado | | - | - | | `"Not Started"` | A sessão foi criada, mas a empresa ainda não abriu o link hospedado. | | `"In Progress"` | O fluxo hospedado está ativo: consultas ao registro, envio de documentos ou análise AML em andamento. | | `"Awaiting User"` | Aguardando uma ação do usuário final (normalmente enviar as pessoas-chave ou responder a uma solicitação de reenvio). Muda automaticamente assim que o usuário conclui a ação pendente. | | `"Approved"` | Todos os recursos obrigatórios foram aprovados. A empresa está verificada. | | `"Declined"` | Uma verificação crítica falhou (empresa dissolvida, entidade sancionada, presença na lista de bloqueio) ou uma regra do fluxo de verificação (workflow) recusou a sessão. | | `"In Review"` | Um ou mais recursos exigem revisão manual por um analista. | | `"Resubmitted"` | Uma sessão anteriormente recusada ou com reenvio solicitado foi reenviada com dados atualizados. | | `"Abandoned"` | A empresa nunca concluiu o fluxo (tempo esgotado). | | `"Expired"` | A sessão expirou antes de a empresa concluí-la. | > [!NOTE] > > `"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. | Status | Significado | | - | - | | `"Not Finished"` | O recurso ainda não foi iniciado ou está em execução. | | `"Approved"` | O recurso foi aprovado. | | `"Declined"` | O recurso falhou (crítico). | | `"In Review"` | O recurso exige a atenção de um analista. | | `"Resub Requested"` | A empresa precisa reenviar as informações deste recurso (por exemplo, enviar novamente um documento). | | `"Awaiting User"` | O recurso está aguardando uma ação do usuário final. Aplica-se ao recurso de pessoas-chave enquanto o usuário precisa cadastrar as partes. O status muda automaticamente após o envio. | ### Nomes dos recursos de KYB Estes são os valores de `features` 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 em `company.registry_status`. | Status | Significado | | - | - | | `ACTIVE` | A empresa está ativa e regular. | | `DISSOLVED` | A empresa foi dissolvida. | | `DEREGISTERED` | O registro da empresa foi cancelado. | | `STRUCK_OFF` | A empresa foi excluída do registro. | | `CLOSED` | A empresa foi encerrada. | | `INACTIVE` | A empresa está inativa (sem atividade comercial). | | `AUTHORISED` | Autorizada (normalmente para entidades reguladas). | | `APPOINTED_REPRESENTATIVE` | Representante nomeado de outra empresa autorizada. | | `UNAUTHORISED` | Anteriormente autorizada, agora não autorizada. | | `NO_LONGER_AUTHORISED` | Autorização revogada. | | `SEE_FULL_DETAILS` | O status exige inspeção manual. | > [!NOTE] > > 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 em `company.verification_status`. | Status | Significado | | - | - | | `verified` | A empresa parece ativa e válida. | | `failed` | A empresa parece inativa ou dissolvida, ou foram identificados problemas. | | `unknown` | Não há informações suficientes ou o status é ambíguo. | ## 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 em `company.fetch_status`. | Status | Significado | | - | - | | `pending` | Nesta etapa, apenas informações parciais ou básicas da empresa foram obtidas. | | `resolved` | Os dados completos da empresa foram obtidos com sucesso de fontes oficiais. | ## Status da verificação AML Retornado para cada análise (de empresa ou de pessoa). | Status | Significado | | - | - | | `"Approved"` | Nenhuma ocorrência acima do limiar. | | `"Declined"` | Ocorrência de alta gravidade (sanção confirmada ou correspondência com PEP). | | `"In Review"` | Foi encontrada uma ocorrência que exige revisão de um analista. | | `"Not Finished"` | A análise não foi concluída. | ## 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](https://docs.didit.me/pt-br/business-verification/warnings.md) 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](https://docs.didit.me/pt-br/business-verification/response-schema.md). ## Próximos passos > [card] [Esquema de resposta](https://docs.didit.me/pt-br/business-verification/response-schema.md) > > Onde cada status aparece no payload. > [card] [Avaliação de risco](https://docs.didit.me/pt-br/business-verification/risk-assessment.md) > > O que determina o resultado de uma verificação KYB. > [card] [Webhooks](https://docs.didit.me/pt-br/business-verification/webhooks.md) > > Eventos disparados nas mudanças de status. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.