Integração de Vendedores em Marketplaces com KYB: Guia Completo (PT-BR)

Marketplaces prosperam ou falham pela qualidade de seus fornecedores. Integrar vendedores rapidamente impulsiona o catálogo — mas integrar vendedores inadequados pode resultar em multas, fraudes ou no cancelamento do serviço pela parceira de pagamentos. Vendedores empresariais elevam ainda mais o risco: uma empresa registrada significa que você não está apenas verificando uma pessoa, mas uma entidade, identificando seus proprietários, rastreando sanções e verificando documentos antes de liberar pagamentos. Feito manualmente, isso pode levar dias por vendedor. Feito apenas com uma consulta de registro, é uma lacuna de conformidade esperando para ser explorada.

A API de Verificação de Empresas da Didit transforma a integração de vendedores em marketplaces em uma única sessão KYB. Verifique a empresa, identifique e faça o KYC de cada proprietário, analise a entidade e confira os documentos — tudo na API unificada /v3/, por $2.00 por empresa. Este guia explica como integrar vendedores empresariais corretamente sem lentidão.

Principais pontos

• Uma sessão por vendedor. Uma única sessão KYB abrange registro, identificação de UBO, KYC do proprietário, AML da entidade e verificação de documentos.
• $2.00 por empresa. A verificação completa tem um preço fixo por entidade vendedora, sem mínimos — o custo escala com o volume de vendedores.
• KYC de cada proprietário. O KYB de ciclo fechado gera uma sessão KYC vinculada para cada UBO, permitindo verificar os humanos por trás do vendedor antes dos pagamentos — exclusivo da Didit.
• Detecte entidades problemáticas. O AML em nível de entidade ($0.20) sinaliza uma empresa vendedora sancionada ou com histórico adverso, mesmo que seus diretores pareçam idôneos.
• Verifique documentos, não apenas armazene-os. Documentos KYB ($0.20 cada) são lidos com OCR e verificados contra adulterações.
• Feito para escalar. Status por funcionalidade permitem rotear reenvios e revisões sem falhar toda a integração; webhooks mantêm seus registros de vendedores sincronizados.

O que o KYB para vendedores faz

Para um marketplace, um vendedor empresarial é uma entidade à qual você está prestes a pagar. O KYB responde às perguntas que protegem esses pagamentos: Esta é uma empresa real e em situação regular? Quem é o proprietário final? A entidade ou algum proprietário está em uma lista de sanções? Seus documentos são autênticos? O modelo de sessão da Didit responde a todas essas quatro perguntas em um só lugar, através de quatro funcionalidades — kyb_registry, kyb_key_people, kyb_company_aml e kyb_documents — e, com o KYC vinculado ativado, também verifica as identidades reais dos proprietários.

O resultado é um vendedor em quem você pode confiar para pagar: uma empresa verificada, um gráfico de propriedade resolvido, entidade e proprietários rastreados, e documentos verificados contra adulterações — produzidos a partir de uma única sessão em vez de cinco ferramentas.

Por que isso importa

Marketplaces que lidam com pagamentos são cada vez mais tratados como fluxos monetários regulamentados. Parceiros de pagamento e adquirentes exigem a devida diligência do vendedor; os regimes de AML exigem a identificação e verificação dos beneficiários finais de contrapartes comerciais; e a realidade da fraude é que maus vendedores se escondem atrás de entidades de fachada precisamente porque a integração raramente vai além da linha de registro. Uma plataforma que paga uma entidade vendedora não verificada, sancionada ou fictícia assume a perda e a exposição regulatória.

A tensão é a velocidade. Vendedores abandonam a integração que leva muito tempo, então a verificação deve ser minuciosa e rápida. A maneira de obter ambos é executar todas as verificações em uma única sessão com roteamento preciso por funcionalidade — coletar o que é necessário, verificá-lo automaticamente e envolver um humano apenas quando um sinal de risco real aparecer.

Detalhes técnicos

A integração do vendedor começa com uma sessão KYB na API unificada /v3/, vinculada ao seu registro interno de vendedor via vendor_data.

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": "seller_44120",
    "callback": "https://yourmarketplace.com/sellers/kyb/callback"
  }'

O resultado da sessão oferece tudo o que é necessário para decidir sobre um pagamento, incluindo KYC vinculado aos proprietários:

{
  "session_id": "kyb_91ab30c4",
  "status": "APPROVED",
  "vendor_data": "seller_44120",
  "kyb_registry": { "status": "APPROVED", "company_status": "ACTIVE" },
  "kyb_company_aml": { "status": "APPROVED" },
  "kyb_documents": { "status": "APPROVED" },
  "kyb_key_people": {
    "status": "APPROVED",
    "ubos": [
      { "name": "Ana Ferreira", "ownership_percentage": 70.0,
        "linked_kyc": { "session_id": "kyc_aa10", "status": "APPROVED" } },
      { "name": "Bruno Costa", "ownership_percentage": 30.0,
        "linked_kyc": { "session_id": "kyc_aa11", "status": "APPROVED" } }
    ]
  }
}

Status da sessão. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.

Webhooks. Assine status.updated e data.updated (session_kind: business) para a verificação do vendedor e os webhooks de sessão padrão para o KYC vinculado de cada proprietário. Use business.status.updated para rastrear a situação da entidade vendedora após a integração.

Preço. $2.00 por empresa. Desagregado: AML da empresa $0.20, documentos KYB $0.20 cada, Pessoas-chave grátis, KYC do proprietário vinculado às tarifas padrão de Verificação de Usuário.

Fluxo de integração para um marketplace

1. Vendedor inicia a integração. Você cria uma sessão KYB vinculada ao seu ID de vendedor.
2. A empresa é verificada. O registro confirma que a entidade é real e ACTIVE; documentos são coletados, lidos por OCR e verificados contra adulterações.
3. Proprietários são identificados e verificados. Pessoas-chave resolvem os UBOs, e uma sessão KYC vinculada verifica cada um — fechando o ciclo entre a entidade e os humanos.
4. Todos são rastreados. O AML da entidade rastreia a empresa; o AML no KYC de cada proprietário rastreia as pessoas.
5. Você decide sobre os pagamentos. Uma sessão APPROVED com proprietários verificados e rastreamento limpo libera o vendedor para pagamentos; uma funcionalidade IN_REVIEW ou RESUB_REQUESTED direciona precisamente para o que precisa de atenção.

Após a integração, o vendedor se torna uma entidade gerenciada que você pode manter ACTIVE, FLAGGED ou BLOCKED através da API de negócios à medida que sua situação muda.

Casos de uso

• Marketplaces de produtos que integram comerciantes verificam a entidade comercial e seus proprietários antes de habilitar a liquidação.
• Marketplaces de serviços e freelancers com provedores empresariais executam KYB em provedores incorporados para satisfazer a devida diligência do parceiro de pagamento.
• Plataformas de criadores e comércio que pagam contas comerciais confirmam que a entidade e seus beneficiários finais são reais e rastreados.
• Marketplaces B2B e atacadistas verificam empresas contrapartes e seus proprietários antes de estender termos comerciais ou pagamentos.

Como integrar-se com a Didit

1. Crie o fluxo de trabalho. No Console de Negócios, crie um fluxo de trabalho KYB com registro, AML da empresa, documentos e pessoas-chave ativados, além de KYC vinculado para UBOs.
2. Crie a sessão. POST /v3/session/ com seu workflow_id KYB e uma referência vendor_data correspondente ao seu ID de vendedor.
3. Gerencie os webhooks. Monitore os webhooks status.updated / data.updated (session_kind: business) do vendedor e os webhooks KYC vinculados de cada proprietário; condicione os pagamentos ao resultado combinado.
4. Gerencie o vendedor. Use GET /v3/businesses/{vendor_data}/ e PATCH .../update-status/ para manter o vendedor ACTIVE, FLAGGED ou BLOCKED à medida que sua situação muda.

Como tudo está na API unificada /v3/, verificar a empresa vendedora, fazer o KYC de seus proprietários e monitorá-la depois é um fluxo contínuo — uma plataforma de identidade e fraude, de ponta a ponta.

Perguntas frequentes

Quanto custa para integrar um vendedor empresarial?

$2.00 por empresa para a verificação KYB completa. As sessões KYC dos proprietários são cobradas pelas tarifas padrão de Verificação de Usuário; AML da empresa e documentos KYB custam $0.20 cada se comprados separadamente.

Preciso verificar os proprietários do vendedor, ou apenas a empresa?

Você pode fazer ambos em um único fluxo. O KYB de ciclo fechado identifica os UBOs e gera uma sessão KYC vinculada para cada um — assim você verifica os humanos por trás do vendedor antes de pagar.

Isso detectará uma empresa vendedora sancionada?

Sim. O AML em nível de entidade (kyb_company_aml) rastreia a própria empresa, detectando uma empresa designada mesmo quando seus diretores parecem idôneos.

A integração é lenta se faz tudo isso?

Não. Cada verificação é executada em uma única sessão, e os status por funcionalidade permitem rotear um único reenvio ou revisão sem falhar toda a integração — minucioso e rápido.

Como mantenho a situação de um vendedor atualizada após a integração?

O vendedor se torna uma entidade gerenciada que você pode definir como ACTIVE, FLAGGED ou BLOCKED através da API de gerenciamento de negócios, com webhooks business.status.updated em cada alteração.

Pronto para começar?

Leia a visão geral da Verificação de Empresas na documentação, veja como ela se encaixa no restante da plataforma na página do produto Verificação de Empresas e confira 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 por US$2.00 por empresa.