> ## 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. # API de verificação de empresas (KYB): registro e UBO > A Didit verifica empresas com consulta a registros, identificação de UBO, triagem de diretores e AML. A partir de $2.00 por verificação, sem contratos. A Verificação de empresas (KYB) da Didit permite verificar empresas e pessoas jurídicas antes de integrá-las à sua plataforma. O sistema automatiza consultas a registros de empresas, identifica beneficiários finais e diretores, faz a triagem de todas as partes contra listas de vigilância AML e coleta documentos de apoio, tudo em um único fluxo de verificação (workflow). Cada empresa verificada é acompanhada como um [perfil de empresa](https://docs.didit.me/business-verification/business-profiles.md), que agrega os resultados de várias sessões. Esta aula da Didit Academy acompanha uma verificação de empresa do início ao fim: o painel de KYB, a consulta ao registro, acionistas e UBOs, a triagem AML e o que o representante da empresa vê do lado dele. [Verificar uma empresa (KYB), do início ao fim — Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1) Novo no KYB da Didit? Comece pelo [início rápido](https://docs.didit.me/pt-br/business-verification/quickstart.md) para um passo a passo completo de 10 minutos e depois leia o [guia de integração](https://docs.didit.me/business-verification/integration-guide.md) para padrões de produção. Para o modelo de entidade Empresa em si (vínculo com Usuários, listas de bloqueio, importação/exportação), veja [Empresas](https://docs.didit.me/entities/businesses/overview.md). ## Como funciona **1. Crie uma sessão de empresa** Inicie uma verificação de empresa criando uma sessão com um **fluxo de KYB**. Quando o tipo do fluxo é KYB, a Didit cria automaticamente uma sessão de empresa: ```bash theme={null} curl -X POST https://verification.didit.me/v3/session/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "workflow_id": "your-kyb-workflow-id", "vendor_data": "company-123" }' ``` O tipo da sessão é determinado pelo fluxo, sem necessidade de campos extras. Os fluxos de KYB criam automaticamente sessões de empresa com os recursos específicos de empresas ativados. **2. Consulta ao registro da empresa** A Didit consulta os registros oficiais de empresas no nível **Lite**, **Shareholders** ou **UBOs**, cada um com preço por país; veja [preços de registros](https://docs.didit.me/getting-started/kyb-registry-pricing.md). O nível Lite obtém: | Dado | Descrição | | - | - | | **Nome da empresa** | Razão social como registrada | | **Número de registro** | Número oficial de registro da empresa | | **País** | País de constituição | | **Situação** | Ativa, dissolvida, baixada etc. | | **Tipo de empresa** | Ltd, LLC, PLC, SA, GmbH etc. | | **Data de constituição** | Data em que a empresa foi registrada | | **Endereço registrado** | Endereço oficial da sede registrada | | **Número fiscal** | Número de identificação fiscal (quando disponível) | Os dados do registro são cruzados com as informações fornecidas para detectar inconsistências. **3. Pessoas-chave - UBOs, acionistas, diretores e representantes** O sistema identifica toda pessoa e toda entidade corporativa vinculada à empresa dentro do modelo unificado de **Pessoas-chave**: * **UBOs** - pessoas físicas que, em última instância, possuem ou controlam a empresa, com percentuais de participação e de voto * **Acionistas** (pessoas físicas e jurídicas) - cada um com o seu percentual de participação * **Diretores, representantes, secretários, signatários autorizados e outras funções de administração** - com a etiqueta da função específica * **Camadas de propriedade corporativa** - empresas controladoras na cadeia de propriedade, com KYB aninhado opcional Uma mesma pessoa pode ter várias etiquetas de função (por exemplo, diretor **e** acionista). Cada função é configurada individualmente no fluxo: quais funções exigem KYC, qual fluxo de KYC usar e se o usuário final pode pular a verificação. Saiba mais em [Pessoas-chave](https://docs.didit.me/business-verification/key-people.md) e [Propriedade](https://docs.didit.me/business-verification/ownership.md). **4. Triagem AML** Todas as partes identificadas passam automaticamente pela triagem contra listas de vigilância AML globais: * **AML da empresa** - faz a triagem da entidade empresarial contra sanções, mídia negativa e listas de ações regulatórias * **AML de pessoas** - faz a triagem individual de cada pessoa-chave (UBO, acionista, diretor, representante etc.) * Usa o mesmo [sistema de duas pontuações de risco](https://docs.didit.me/pt-br/core-technology/aml-screening/overview.md) (pontuação de correspondência + pontuação de risco) da verificação de usuários **5. Coleta de documentos** Colete e verifique documentos de apoio: | Tipo de documento | Exemplos | | - | - | | **Certificado de constituição** | Certificado de formação da empresa | | **Contrato social** | Estatuto, memorando de associação | | **Comprovante de endereço** | Contas de serviços, extratos bancários do endereço registrado | | **Registro de acionistas** | Registro oficial de acionistas | | **Demonstrações financeiras** | Contas anuais, relatórios de auditoria | | **Certidões fiscais** | Certificados de registro ou de regularidade fiscal | | **Documentos personalizados** | Quaisquer documentos adicionais exigidos pelo seu processo de conformidade | Os analistas podem solicitar documentos adicionais à empresa durante o processo de revisão. **6. Revise e decida** A sessão da empresa recebe um status geral baseado em todas as verificações: | Status | Significado | | - | - | | **Aprovada** | Todas as verificações passaram - a empresa está verificada | | **Em revisão** | Uma ou mais verificações exigem revisão manual | | **Recusada** | Uma verificação crítica falhou (por exemplo, empresa dissolvida, entidade sancionada) | Os analistas podem revisar todos os dados coletados no Business Console, adicionar comentários, solicitar documentos adicionais e tomar a decisão final. ## Ciclo de vida da sessão de empresa Cada verificação de empresa roda dentro de uma **sessão de empresa** que acompanha o progresso pelos seguintes status: | Status | Descrição | | - | - | | `NOT_STARTED` | Sessão criada, mas a verificação ainda não começou | | `IN_PROGRESS` | A verificação está em andamento - consultas a registros, triagem AML ou coleta de documentos em curso | | `APPROVED` | Todas as verificações passaram - a empresa está verificada | | `DECLINED` | Uma verificação crítica falhou (por exemplo, empresa dissolvida, entidade sancionada) | | `IN_REVIEW` | Uma ou mais verificações exigem revisão manual de um analista | | `RESUBMITTED` | Sessão anteriormente recusada, reenviada com dados atualizados | Cada sessão tem um `session_id` único, um `session_number` sequencial e um `session_token` para o link de verificação hospedado. Quando uma sessão é criada com um identificador `vendor_data`, a Didit a vincula automaticamente ao [perfil de empresa](https://docs.didit.me/business-verification/business-profiles.md) correspondente. ## Status por recurso A verificação de empresas acompanha o status de cada componente de forma independente: | Recurso | Descrição | | - | - | | **Verificação de registro** | Consulta ao registro da empresa e extração de dados | | **AML da empresa** | Triagem AML no nível da empresa contra sanções e listas de vigilância | | **Documentos** | Coleta de documentos, OCR e verificação cruzada | | **Pessoas-chave** | Identificação de beneficiários finais e diretores, AML e KYC | Cada recurso pode estar em: `NOT_FINISHED`, `APPROVED`, `DECLINED`, `IN_REVIEW` ou `RESUB_REQUESTED`. O status geral da sessão agrega os status individuais dos recursos - a sessão só fica `APPROVED` quando todos os recursos obrigatórios passam. ## Eventos de webhook As sessões de empresa geram os seguintes eventos de webhook: | Evento | Gatilho | | - | - | | `status.updated` | O status da sessão mudou. O payload traz `session_kind: "business"` para sessões de KYB. | | `data.updated` | Os dados da sessão mudaram (registro, pessoas-chave, documentos, AML). O payload traz `session_kind: "business"`. | | `business.status.updated` | O status da [entidade Empresa](https://docs.didit.me/entities/businesses/overview.md) vinculada mudou (`ACTIVE` / `FLAGGED` / `BLOCKED`). | | `business.data.updated` | Os campos de perfil ou os contadores agregados da entidade Empresa vinculada mudaram. | Os payloads de webhook incluem `session_kind: "business"` e o `business_session_id` para distingui-los dos eventos de verificação de usuários. Veja [Webhooks](https://docs.didit.me/integration/webhooks.md) para a verificação de assinatura e detalhes de entrega. ## Principais capacidades | Capacidade | Descrição | | - | - | | **Consultas automáticas a registros** | Consulte registros oficiais de empresas nos países compatíveis no nível Lite, Shareholders ou UBOs, [com preço por país](https://docs.didit.me/getting-started/kyb-registry-pricing.md) | | **Identificação de UBO** | Extraia automaticamente estruturas de beneficiários finais com percentuais | | **Triagem de diretores** | Identifique e verifique diretores, secretários e outros administradores | | **AML da empresa** | Faça a triagem da entidade empresarial contra sanções e listas de vigilância | | **AML de pessoas** | Faça a triagem individual de todos os UBOs e diretores identificados | | **Vínculo com KYC** | Vincule cada pessoa identificada a uma sessão de Verificação de usuários (KYC) para a verificação de identidade | | **Coleta de documentos** | Solicitações estruturadas de documentos com acompanhamento de uploads | | **Verificação cruzada por OCR** | Extraia dados de documentos enviados e cruze-os com os dados do registro | | **Perfis de empresa** | Criação automática de perfis e agregação de sessões para cada empresa verificada | | **Status por recurso** | Acompanhamento independente de status para registro, AML, documentos e pessoas-chave | | **Avaliação de risco** | Nível de risco geral baseado na situação da empresa, nos resultados de AML e na complexidade da estrutura societária | | **Webhooks** | Receba eventos do ciclo de vida da sessão e de atualização de dados em tempo real por [webhooks](https://docs.didit.me/integration/webhooks.md) | ## Sessões de empresa vs. sessões de usuário | Recurso | Sessão de usuário | Sessão de empresa | | - | - | - | | **Alvo** | Pessoa física | Empresa ou pessoa jurídica | | **Tipo de sessão** | `user` (padrão) | `business` | | **Verificações principais** | Documento, prova de vida, correspondência facial, AML | Consulta ao registro, UBO, diretores, AML da empresa | | **Verificações adicionais** | Telefone, e-mail, comprovante de endereço, NFC | Coleta de documentos, AML de pessoas, vínculo com KYC | | **Payloads de webhook** | Eventos de sessão padrão | Incluem `session_kind: "business"` e `business_session_id` | ## Próximos passos > **[Perfis de empresa](https://docs.didit.me/business-verification/business-profiles.md)** > > Acompanhe empresas entre sessões com perfis, tags e operações em massa. > **[Dados da empresa](https://docs.didit.me/business-verification/company-data.md)** > > Consultas a registros, situação da empresa e verificação cruzada de dados. > **[Estrutura de propriedade](https://docs.didit.me/business-verification/ownership.md)** > > Identificação de UBO, acionistas corporativos e cadeias de propriedade. > **[Diretores e administradores](https://docs.didit.me/business-verification/officers.md)** > > Identificação de diretores, funções e vínculo com KYC. > **[Triagem AML](https://docs.didit.me/business-verification/aml.md)** > > Verificações AML no nível da empresa e das pessoas. > **[Documentos](https://docs.didit.me/business-verification/documents.md)** > > Coleta de documentos, solicitações e verificação por OCR. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.