API de Verificação de Empresas: Registo, UBO, Administradores e AML a 2€ (PT-PT)

Conhecer os seus clientes individuais é apenas metade da informação. No momento em que integra uma empresa — um comerciante, um vendedor de marketplace, uma conta corporativa, um VASP contraparte — tem de responder a um conjunto de perguntas mais difíceis. É uma empresa real e registada? Quem é o verdadeiro proprietário? Quem pode agir em seu nome? E há alguém por trás dela numa lista de sanções ou de vigilância? O Know Your Business (KYB) é a disciplina que responde a estas quatro questões, e historicamente tem significado puxar extratos de registo manualmente, perseguir documentos de acionistas por e-mail e passar nomes por uma ferramenta de triagem separada.

A API de Verificação de Empresas da Didit condensa isso numa única sessão. Cria uma sessão KYB, e ela devolve dados de registo verificados, identifica os beneficiários efetivos (UBOs) e administradores, e faz a triagem da entidade contra listas de vigilância globais — tudo na API /v3/ unificada, por 2,00 € por verificação de empresa sem mínimos.

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

Principais conclusões

• 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 registo, AML de entidade, verificação de documentos e identificação de beneficiários efetivos.
• 2,00 € por empresa. A verificação completa — registo + identificação de UBO + triagem de administradores + AML de entidade — tem um preço fixo, faturado por empresa, sem mínimos.
• SKUs desagregados. Precisa apenas de uma parte? A triagem AML de empresas custa 0,20 € por verificação, os documentos KYB custam 0,20 € por documento, e a extração de Pessoas Chave (UBOs + administradores) é gratuita — paga apenas as taxas de Verificação de Utilizador quando executa KYC ligado a um UBO.
• Dados de registo reais. Nome da empresa, número de registo, país, estado, tipo, data de incorporação, endereço registado e número fiscal, obtidos de registos oficiais.
• Ciclo fechado, exclusivo da Didit. Uma sessão KYB pode gerar uma sessão KYC ligada para cada UBO na mesma API /v3/ — integre a empresa e verifique os humanos por trás dela num único fluxo.
• Gerenciável. Uma API de gestão completa e webhooks business.status.updated / business.data.updated mantêm os seus registos sincronizados.

O que faz a verificação de empresas

Uma verificação KYB confirma que uma empresa existe, está em bom estado e é controlada pelas pessoas que pensa que a controlam. O modelo de sessão da Didit divide isso em quatro funcionalidades, cada uma com o seu próprio estado para que saiba sempre exatamente onde uma verificação se encontra:

• kyb_registry — procura a empresa no registo oficial e devolve o seu registo principal: nome legal, número de registo, país, estado, tipo de entidade, data de incorporação, endereço registado e número fiscal.
• kyb_company_aml — faz a triagem da própria empresa contra sanções, listas de vigilância e fontes de média adversa ao nível da entidade.
• kyb_documents — recolhe e lê documentos de suporte (certificado de incorporação, estatutos, comprovativo de morada, financeiro) com OCR e verificação de adulteração.
• kyb_key_people — extrai as pessoas importantes: UBOs com percentagens de propriedade, acionistas, diretores, administradores e representantes — incluindo camadas de propriedade corporativa aninhadas.

Cada funcionalidade tem um destes estados: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER.

Porque é que é importante

As empresas reguladas são obrigadas a verificar as empresas a que servem, identificar os beneficiários efetivos acima do limiar de propriedade e fazer a triagem de entidades e dos seus controladores contra listas de sanções. As diretivas AML da UE, a Lei de Transparência Corporativa dos EUA e regimes equivalentes em todo o mundo transformam o KYB de um "bom de ter" numa exigência 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 equipas monta o KYB a partir de um fornecedor de dados de registo, um processo manual de recolha de documentos e uma ferramenta de triagem separada, e depois junta o grafo UBO numa folha de cálculo. A Didit colapsa essa pilha numa única sessão e uma única consola — registo, propriedade, documentos e triagem no mesmo local, precificado por empresa para que o custo aumente com o volume de integração em vez de licenças por posto.

Detalhes técnicos

Uma verificação KYB é criada da mesma forma que qualquer outra sessão Didit: faz um POST para /v3/session/ com um fluxo de trabalho que tem as funcionalidades KYB ativadas.

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 resolve-se num resultado estruturado com o registo, as pessoas chave e os estados das funcionalidades:

{
  "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 }
    ]
  }
}

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

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

Preço. 2,00 € por verificação de empresa para o pacote completo. Desagregado: AML de Empresa 0,20 € por verificação, documentos KYB 0,20 € por documento, extração de Pessoas Chave gratuita, e KYC ligado a um UBO faturado às taxas padrão de Verificação de Utilizador.

O que inclui a verificação

Consulta de registo (kyb_registry). O registo autoritativo — nome legal, número de registo, país, estado atual, tipo de entidade, data de incorporação, endereço registado e número fiscal — obtido da fonte oficial em vez de auto-declarado pelo requerente.

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

AML de Empresa (kyb_company_aml). Triagem ao nível da entidade contra sanções, listas de vigilância e fontes de média adversa — para que uma empresa que é ela própria sancionada ou adversamente reportada nunca passe despercebida porque apenas os seus administradores foram verificados.

Documentos (kyb_documents). Os documentos de suporte são recolhidos, lidos com OCR e submetidos a uma verificação de adulteração, para que um certificado de incorporação ou comprovativo de morada seja verificado, e não apenas arquivado.

Casos de uso

• Marketplaces que integram vendedores empresariais verificam se o vendedor é uma empresa real e em bom estado e identificam as pessoas por trás dela antes de os pagamentos começarem.
• Plataformas de fintech e bancárias que abrem contas corporativas executam registo, UBO e AML de entidade numa única sessão para satisfazer as obrigações KYB.
• Fornecedores de empréstimos que subscrevem empréstimos empresariais confirmam a incorporação, propriedade e situação antes de conceder crédito.
• Plataformas Crypto B2B que integram VASPs contrapartes e clientes corporativos verificam a entidade e fazem a sua triagem contra sanções numa única chamada.

Como integrar com a Didit

1. Construa o fluxo de trabalho. Na Consola Empresarial, crie um fluxo de trabalho com as funcionalidades KYB de que precisa — registo, AML de empresa, documentos, pessoas chave — e ative o KYC ligado para UBOs se quiser verificar também os humanos.
2. Crie a sessão. POST /v3/session/ com o seu workflow_id KYB e uma referência vendor_data que liga a verificação ao seu registo empresarial interno.
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 gestão — POST /v3/businesses/create/, GET /v3/businesses/, GET /v3/businesses/{vendor_data}/, e PATCH .../update-status/ — para rastrear e atualizar cada empresa como ACTIVE, FLAGGED ou BLOCKED.

Porque está tudo na API /v3/ unificada, uma sessão KYB pode gerar as sessões KYC para os seus UBOs, essas pessoas fluem para a monitorização contínua, 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 empresas?

2,00 € por empresa para a verificação completa — consulta de registo, identificação de UBO, triagem de administradores e AML de entidade. Também pode comprar as partes: AML de empresa a 0,20 € por verificação, documentos KYB a 0,20 € por documento, e extração de Pessoas Chave gratuita, com KYC de UBO ligado faturado às taxas padrão de Verificação de Utilizador.

Que dados de registo recebo de volta?

Nome da empresa, número de registo, país, estado da empresa, tipo de entidade, data de incorporação, endereço registado e número fiscal — obtidos do registo oficial.

Pode identificar os beneficiários efetivos?

Sim. A funcionalidade kyb_key_people extrai UBOs com percentagens de propriedade, além de acionistas, diretores, administradores e representantes, resolvendo camadas de propriedade corporativa aninhadas ao longo do processo.

A empresa é verificada contra sanções?

Sim. kyb_company_aml faz a triagem da própria entidade contra sanções, listas de vigilância e fontes de média adversa ao nível da empresa.

Posso verificar as pessoas que são proprietárias da empresa também?

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

Pronto para começar?

Leia a visão geral da Verificação de Empresas na documentação, veja como se encaixa no resto da plataforma na página do produto Verificação de Empresas, 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 empresas a 2,00 € por empresa.