Coleta de Documentos KYB e OCR por Apenas R$1 por Documento (PT-BR)

Dados de registro informam que uma empresa existe. Documentos informam o que ela realmente é. Uma certidão de incorporação, os artigos de associação, um comprovante de endereço recente, demonstrações financeiras — esses são os artefatos que transformam um item de linha de registro em um relacionamento comercial verificado. O problema é que a coleta deles sempre foi a parte mais manual e propensa a erros do KYB: documentos chegam por e-mail em dezenas de formatos, alguém insere os detalhes em um sistema manualmente e ninguém verifica se o PDF foi editado antes de chegar à caixa de entrada.

A API de Verificação de Negócios da Didit integra o tratamento de documentos à sessão. O recurso kyb_documents coleta os documentos de suporte, os lê com OCR e executa uma verificação de adulteração — assim, um documento não é apenas arquivado, ele é verificado. Documentos KYB custam R$1 por documento, dentro de uma sessão KYB cuja verificação completa da empresa custa R$10.

Este guia descreve o que a coleta de documentos abrange, como funcionam o OCR e a detecção de adulteração, e como integrá-lo.

Principais pontos

• Coleta e verificação. O recurso kyb_documents coleta documentos de suporte e os verifica — ele não apenas armazena um upload.
• OCR integrado. Os documentos são lidos automaticamente, então os dados dentro deles são estruturados, não presos em um PDF.
• Verificação de adulteração. Cada documento é analisado em busca de sinais de edição ou falsificação antes de ser aceito.
• R$1 por documento. A verificação de documentos é precificada por documento, dentro de uma sessão KYB cuja verificação completa custa R$10.
• Status rastreado. kyb_documents reporta NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER — incluindo um caminho claro para reenvio.
• Uma sessão. Os documentos ficam junto com o registro, pessoas-chave e AML da entidade na mesma sessão KYB na API unificada /v3/.

O que a coleta de documentos KYB faz

A integração de negócios quase sempre exige documentos que o registro não possui: prova de que a entidade está incorporada, as regras que a governam, evidência de onde opera e prova de sua situação financeira. O recurso kyb_documents lida com todo o ciclo de vida desses documentos dentro da sessão — solicitando-os, recebendo-os, lendo-os com OCR e verificando-os quanto a adulteração.

Documentos KYB típicos incluem:

• Certidão de incorporação — prova de que a empresa está legalmente registrada.
• Estatuto social / contrato social — as regras e a estrutura de governança da empresa.
• Comprovante de endereço — evidência do endereço registrado ou operacional.
• Demonstrativos financeiros — contas e situação financeira.

Cada documento passa por seu próprio status, de modo que um solicitante que envia uma digitalização borrada ou o arquivo errado é direcionado para reenviar, em vez de falhar silenciosamente toda a verificação.

Por que isso importa

A verificação de documentos é onde muitos processos KYB vazam risco. Uma consulta ao registro é difícil de falsificar; um PDF enviado por e-mail não é. Certificados editados, comprovantes de endereço reciclados e falsificações diretas são vetores de ataque comuns ao integrar entidades comerciais, e um processo que meramente armazena um documento sem verificá-lo dá uma falsa sensação de segurança.

A leitura de documentos com OCR também remove a etapa de digitação manual que introduz erros de transcrição e retarda a integração. Em vez de uma pessoa ler um certificado e digitar o número de registro em um formulário, os dados são extraídos automaticamente e podem ser cruzados com o registro na mesma sessão.

Detalhes técnicos

A verificação de documentos é um recurso de uma sessão KYB criada contra a API unificada /v3/.

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": "vendor_corp_7720",
    "callback": "https://yourapp.com/kyb/callback"
  }'

O bloco kyb_documents relata a verificação de cada documento coletado:

{
  "kyb_documents": {
    "status": "APPROVED",
    "documents": [
      {
        "type": "CERTIFICATE_OF_INCORPORATION",
        "status": "APPROVED",
        "ocr": { "registration_number": "B12345678", "company_name": "Acme Logistics S.L." },
        "tamper_check": "PASSED"
      },
      {
        "type": "PROOF_OF_ADDRESS",
        "status": "RESUB_REQUESTED",
        "reason": "Document older than accepted window"
      }
    ]
  }
}

Status do recurso. kyb_documents reporta NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, RESUB_REQUESTED ou AWAITING_USER. O estado RESUB_REQUESTED é o que torna a coleta de documentos viável em escala — um documento rejeitado solicita um reenvio limpo, em vez de falhar toda a sessão.

Webhooks. Assine data.updated (session_kind: business) para receber dados de documentos extraídos e status.updated para reagir quando um documento for aprovado ou um reenvio for solicitado.

Preço. R$1 por documento. A verificação completa da empresa KYB — registro, UBO, diretores e AML da entidade — custa R$10.

OCR e detecção de adulteração

Duas coisas acontecem com cada documento. Primeiro, o OCR o lê, estruturando o conteúdo para que um número de registro, nome da empresa ou endereço se torne dados que seu sistema pode usar e verificar — não pixels em um PDF. Segundo, uma verificação de adulteração analisa o documento em busca de sinais de edição ou falsificação, para que um certificado manipulado ou um comprovante de endereço adulterado seja detectado antes de ser aceito.

Juntos, eles transformam a coleta de documentos de um exercício de arquivamento em uma etapa de verificação. A saída do OCR pode ser conciliada com o registro kyb_registry — o número de registro no certificado corresponde ao do registro? — e a verificação de adulteração protege contra documentos que, de outra forma, passariam despercebidos por um olhar humano.

Casos de uso

• Marketplaces que integram vendedores comerciais coletam documentos de incorporação e endereço, verificam-nos automaticamente e rejeitam uploads adulterados antes dos pagamentos.
• Plataformas Fintech e bancárias que abrem contas corporativas reúnem estatutos e dados financeiros com dados extraídos por OCR alimentando diretamente seus registros.
• Provedores de empréstimos que avaliam mutuários comerciais verificam demonstrações financeiras e documentos de incorporação como parte da mesma sessão KYB.
• Plataformas B2B de cripto que integram clientes corporativos coletam e verificam a documentação que os reguladores esperam em arquivo.

Como integrar com a Didit

1. Construa o fluxo de trabalho. No Business Console, crie um fluxo de trabalho KYB com kyb_documents habilitado e configure quais tipos de documentos você exige.
2. Crie a sessão. POST /v3/session/ com seu workflow_id KYB e uma referência vendor_data para seu registro comercial interno.
3. Manipule webhooks. Ouça data.updated e status.updated (session_kind: business) para receber dados extraídos por OCR e reagir a aprovações ou solicitações de reenvio.
4. Conclua e resolva. Faça a verificação cruzada da saída do OCR com o registro e direcione documentos RESUB_REQUESTED de volta ao solicitante para um reenvio limpo.

Como os documentos vivem na mesma sessão KYB que o registro, pessoas-chave e AML da entidade, você verifica a empresa inteira — não quatro verificações desconectadas costuradas após o fato.

Perguntas frequentes

Quanto custa a verificação de documentos KYB?

R$1 por documento. A verificação completa da empresa — registro, UBO, diretores e AML da entidade — custa R$10.

Que documentos ela pode coletar?

Documentos de suporte KYB, como certidões de incorporação, estatutos sociais, comprovantes de endereço e demonstrações financeiras.

Ela lê os documentos ou apenas os armazena?

Ela os lê com OCR, então os dados internos — números de registro, nomes de empresas, endereços — são estruturados e podem ser verificados em relação ao registro.

Ela detecta documentos falsificados ou editados?

Sim. Cada documento passa por uma verificação de adulteração que o analisa em busca de sinais de edição ou falsificação antes de ser aceito.

O que acontece se um documento for rejeitado?

O documento passa para RESUB_REQUESTED, solicitando ao requerente que envie uma versão limpa, em vez de falhar toda a sessão.

Pronto para começar?

Leia a visão geral da Verificação de Negócios na documentação, veja como ela se encaixa no restante da plataforma na página do produto Verificação de Negócios 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 documentos KYB por R$1 cada.