API de Verificação Empresarial: Registro, Sócio Oculto, Diretores e AML por US$2 (PT-BR)

Conhecer seus clientes individuais é apenas metade da história. No momento em que você integra um negócio — um comerciante, um vendedor de marketplace, uma conta corporativa, uma VASP contraparte — você precisa responder a um conjunto de perguntas mais difíceis. É uma empresa real e registrada? Quem realmente a possui? Quem pode agir em seu nome? E há alguém por trás dela em uma lista de sanções ou observação? Know Your Business (KYB) é a disciplina que responde a todas as quatro perguntas, e historicamente significava extrair extratos de registro manualmente, buscar documentos de acionistas por e-mail e verificar nomes em uma ferramenta de triagem separada.

A API de Verificação Empresarial da Didit condensa isso em uma única sessão. Você cria uma sessão KYB, e ela retorna dados de registro verificados, identifica os beneficiários finais (UBOs) e diretores, e verifica a entidade em relação a listas de observação globais — tudo na API unificada /v3/, por US$ 2,00 por verificação de empresa sem mínimos.

Este guia explica o que uma sessão KYB contém, como ela é precificada e como integrá-la.

Principais pontos

• Uma sessão, quatro verificações. Uma única sessão KYB agrupa kyb_registry, kyb_company_aml, kyb_documents e kyb_key_people — consulta de registro, AML da entidade, verificação de documentos e identificação de beneficiário final.
• US$ 2,00 por empresa. A verificação completa — registro + identificação de UBO + triagem de diretores + AML da entidade — tem um preço fixo, cobrado por empresa, sem mínimos.
• SKUs desagregados. Precisa apenas de uma parte? A triagem AML da empresa custa US$ 0,20 por verificação, os documentos KYB custam US$ 0,20 por documento, e a extração de Pessoas Chave (UBOs + diretores) é gratuita — você só paga as taxas de Verificação de Usuário quando executa KYC vinculado em um UBO.
• Dados de registro reais. Nome da empresa, número de registro, país, status, tipo, data de incorporação, endereço registrado e número de identificação fiscal, extraídos de registros oficiais.
• Ciclo fechado, exclusivo da Didit. Uma sessão KYB pode gerar uma sessão KYC vinculada para cada UBO na mesma API /v3/ — integre a empresa e verifique os humanos por trás dela em um único fluxo.
• Gerenciável. Uma API de gerenciamento completa e webhooks business.status.updated / business.data.updated mantêm seus registros sincronizados.

O que a verificação de negócios faz

Uma verificação KYB confirma que um negócio existe, está em situação regular e é controlado pelas pessoas que você pensa que o controlam. O modelo de sessão da Didit divide isso em quatro recursos, cada um com seu próprio status para que você sempre saiba exatamente onde uma verificação se encontra:

• kyb_registry — pesquisa a empresa no registro oficial e retorna seu registro principal: nome legal, número de registro, país, status, tipo de entidade, data de incorporação, endereço registrado e número de identificação fiscal.
• kyb_company_aml — verifica a própria empresa em relação a sanções, listas de observação e fontes de mídia adversa em nível de entidade.
• kyb_documents — coleta e lê documentos de suporte (certificado de incorporação, artigos, comprovante de endereço, finanças) com OCR e verificação de adulteração.
• kyb_key_people — extrai as pessoas importantes: UBOs com porcentagens de propriedade, acionistas, diretores, executivos e representantes — incluindo camadas aninhadas de propriedade corporativa.

Cada recurso possui um destes status: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER.

Por que isso importa

Empresas regulamentadas são obrigadas a verificar os negócios que atendem, identificar beneficiários finais acima do limite de propriedade e verificar entidades e seus controladores contra listas de sanções. As diretivas AML da UE, o US Corporate Transparency Act e regimes equivalentes em todo o mundo transformam o KYB de um 'bom ter' em um requisito legal — e as penalidades por integrar uma empresa de fachada ou uma entidade sancionada são severas.

O problema operacional é igualmente real. A maioria das equipes monta o KYB a partir de um fornecedor de dados de registro, um processo manual de coleta de documentos e uma ferramenta de triagem separada, para depois unir o gráfico de UBOs em uma planilha. A Didit colapsa essa pilha em uma única sessão e um único console — registro, propriedade, documentos e triagem no mesmo lugar, precificado por empresa para que o custo seja dimensionado com o volume de integração em vez de licenças de assento.

Detalhes técnicos

Uma verificação KYB é criada da mesma forma que qualquer outra sessão Didit: você POST para /v3/session/ com um fluxo de trabalho que tenha os recursos KYB habilitados.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "your_kyb_workflow_id",
    "vendor_data": "merchant_8842",
    "callback": "https://yourapp.com/kyb/callback"
  }'

A sessão resulta em um resultado estruturado com o registro, pessoas chave e status dos recursos:

{
  "session_id": "kyb_5f2a90c1",
  "status": "APPROVED",
  "vendor_data": "merchant_8842",
  "kyb_registry": {
    "status": "APPROVED",
    "company_name": "Acme Logistics S.L.",
    "registration_number": "B12345678",
    "country": "ES",
    "company_status": "ACTIVE",
    "company_type": "LIMITED_LIABILITY",
    "incorporation_date": "2019-03-14",
    "registered_address": "Calle Mayor 1, 28013 Madrid, ES",
    "tax_number": "ESB12345678"
  },
  "kyb_company_aml": { "status": "APPROVED" },
  "kyb_documents": { "status": "APPROVED" },
  "kyb_key_people": {
    "status": "APPROVED",
    "ubos": [
      { "name": "María García", "ownership_percentage": 55.0 },
      { "name": "Holdco Ventures B.V.", "ownership_percentage": 45.0, "is_corporate": true }
    ]
  }
}

Status da sessão. A sessão geral passa por NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED e EXPIRED.

Webhooks. Assine status.updated e data.updated (com session_kind de "business") para manter seu registro sincronizado à medida que a verificação avança e os dados são enriquecidos.

Preço. US$ 2,00 por verificação de empresa para o pacote completo. Desagregado: AML da empresa US$ 0,20 por verificação, documentos KYB US$ 0,20 por documento, extração de Pessoas Chave gratuita, e KYC vinculado em um UBO cobrado pelas taxas padrão de Verificação de Usuário.

O que está incluído na verificação

Consulta de registro (kyb_registry). O registro autoritativo — nome legal, número de registro, país, status atual, tipo de entidade, data de incorporação, endereço registrado e número de identificação fiscal — extraído da fonte oficial em vez de autoatestado pelo solicitante.

Pessoas Chave (kyb_key_people). O panorama completo do controle: UBOs com suas porcentagens de propriedade, acionistas, diretores, executivos e representantes. Onde a propriedade passa por outras empresas, a Didit resolve as camadas corporativas aninhadas para que você veja quem, em última instância, controla a entidade.

AML da empresa (kyb_company_aml). Triagem em nível de entidade contra sanções, listas de observação e fontes de mídia adversa — para que uma empresa que é sancionada ou reportada adversamente nunca passe despercebida porque apenas seus diretores foram verificados.

Documentos (kyb_documents). Documentos de apoio são coletados, lidos com OCR e submetidos a uma verificação de adulteração, para que um certificado de incorporação ou comprovante de endereço seja verificado, e não apenas arquivado.

Casos de uso

• Marketplaces que integram vendedores empresariais verificam se o vendedor é uma empresa real e em situação regular e identificam as pessoas por trás dela antes do início dos pagamentos.
• Plataformas de fintech e bancos que abrem contas corporativas realizam registro, UBO e AML da entidade em uma única sessão para cumprir as obrigações de KYB.
• Provedores de empréstimos que analisam tomadores de empréstimos empresariais confirmam a incorporação, propriedade e situação antes de conceder crédito.
• Plataformas de cripto B2B que integram VASPs contrapartes e clientes corporativos verificam a entidade e a triam contra sanções em uma única chamada.

Como integrar com a Didit

1. Construa o fluxo de trabalho. No Business Console, crie um fluxo de trabalho com os recursos KYB que você precisa — registro, AML da empresa, documentos, pessoas chave — e ative o KYC vinculado para UBOs se você quiser verificar os humanos também.
2. Crie a sessão. POST /v3/session/ com seu workflow_id KYB e uma referência vendor_data que vincula a verificação ao seu registro interno de negócios.
3. Lide com webhooks. Ouça status.updated e data.updated (session_kind: business) para reagir à medida que a verificação é concluída e os dados são enriquecidos.
4. Gerencie a entidade. Use a API de gerenciamento — POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/ e PATCH .../update-status/ — para rastrear e atualizar cada negócio como ACTIVE, FLAGGED ou BLOCKED.

Como tudo está na API unificada /v3/, uma sessão KYB pode gerar as sessões KYC para seus UBOs, essas pessoas entram no monitoramento contínuo, e uma transação sinalizada pode gerar uma verificação de remediação — uma plataforma de identidade e fraude, de ponta a ponta.

Perguntas frequentes

Quanto custa a verificação de negócios?

US$ 2,00 por empresa para a verificação completa — consulta de registro, identificação de UBO, triagem de diretores e AML da entidade. Você também pode comprar as partes: AML da empresa por US$ 0,20 por verificação, documentos KYB por US$ 0,20 por documento, e extração de Pessoas Chave gratuita, com KYC de UBO vinculado cobrado pelas taxas padrão de Verificação de Usuário.

Quais dados de registro eu recebo de volta?

Nome da empresa, número de registro, país, status da empresa, tipo de entidade, data de incorporação, endereço registrado e número de identificação fiscal — extraídos do registro oficial.

Pode identificar beneficiários finais?

Sim. O recurso kyb_key_people extrai UBOs com porcentagens de propriedade, além de acionistas, diretores, executivos e representantes, resolvendo camadas corporativas aninhadas ao longo do caminho.

Verifica a empresa em relação a sanções?

Sim. kyb_company_aml verifica a própria entidade em relação a sanções, listas de observação e fontes de mídia adversa em nível de empresa.

Posso verificar as pessoas que são donas da empresa também?

Sim. Na API unificada /v3/, uma sessão KYB pode gerar uma sessão KYC vinculada para cada UBO — verificação de ciclo fechado da entidade e dos humanos por trás dela em um único fluxo.

Pronto para começar?

Leia a visão geral da Verificação Empresarial na documentação, veja como ela se encaixa no resto da plataforma na página do produto Verificação Empresarial e verifique os preços transparentes por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e verificação de negócios por US$ 2,00 por empresa.