Verificação de Vendedores Empresariais em Marketplaces (KYB) (PT-PT)
Integre vendedores empresariais da forma certa — verifique a empresa, identifique e faça KYC de todos os proprietários, analise a entidade e verifique documentos — tudo numa única sessão KYB de 2,00 $ construída para marketplaces.

Os marketplaces prosperam ou falham pela qualidade do seu lado da oferta. Integrar vendedores rapidamente é o que faz o catálogo crescer — mas integrar os vendedores errados é o que leva a plataforma a ser multada, defraudada ou a ter as suas contas bancárias encerradas pelo seu parceiro de pagamentos. Os vendedores empresariais aumentam ainda mais os riscos: um vendedor que é uma empresa registada significa que não está apenas a verificar uma pessoa, está a verificar uma entidade, a identificar quem a possui, a rastreá-la para sanções e a verificar os seus documentos antes que o dinheiro comece a fluir para ela. Feito manualmente, isso são dias de trabalho por vendedor. Feito apenas como uma consulta de registo, é uma lacuna de conformidade à espera de ser explorada.
A API de Verificação de Empresas da Didit transforma a integração de vendedores de marketplace numa única sessão KYB. Verifique a empresa, identifique e faça KYC de todos os proprietários, analise a entidade e verifique os documentos — tudo na API unificada /v3/, por 2,00 $ por empresa. Este guia explica como integrar vendedores empresariais adequadamente sem tornar o processo lento.
Principais pontos
- Uma sessão por vendedor. Uma única sessão KYB abrange o registo, 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, para que verifique os humanos por trás do vendedor antes dos pagamentos — exclusivo da Didit.
- Detete as entidades problemáticas. O AML ao nível da entidade (0,20 $) sinaliza uma empresa vendedora sancionada ou com relatórios adversos, mesmo quando os seus diretores parecem limpos.
- Verifique documentos, não apenas os armazene. Os documentos KYB (0,20 $ cada) são lidos com OCR e verificados quanto a adulterações.
- Construído para escalar. Os estados por funcionalidade permitem direcionar reenvios e revisões sem falhar toda a integração; os webhooks mantêm os registos dos seus vendedores sincronizados.
O que faz o KYB do vendedor
Para um marketplace, um vendedor empresarial é uma entidade à qual está prestes a pagar. O KYB responde às perguntas que protegem esses pagamentos: Esta é uma empresa real e em boa situação? Quem a possui em última instância? A entidade ou algum proprietário está numa lista de sanções? Os seus documentos são genuínos? O modelo de sessão da Didit responde a todas estas quatro perguntas num 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 pode confiar o suficiente para pagar: uma empresa verificada, um gráfico de propriedade resolvido, entidade e proprietários rastreados, e documentos verificados quanto a adulterações — produzidos a partir de uma única sessão em vez de cinco ferramentas.
Porque é que isto importa
Os marketplaces que gerem pagamentos são cada vez mais tratados como fluxos de dinheiro regulamentados. Parceiros de pagamento e adquirentes exigem a devida diligência do vendedor; os regimes AML exigem a identificação e verificação dos beneficiários efetivos das contrapartes empresariais; e a realidade da fraude é que os maus vendedores escondem-se atrás de entidades fantasmas precisamente porque a integração raramente vai além da linha de registo. Uma plataforma que paga a uma entidade vendedora não verificada, sancionada ou fictícia suporta a perda e a exposição regulamentar.
A tensão é a velocidade. Os vendedores abandonam a integração que demora muito, por isso a verificação tem de ser minuciosa e rápida. A forma de obter ambos é executar todas as verificações numa única sessão com roteamento preciso por funcionalidade — recolher o que é necessário, verificá-lo automaticamente e envolver um humano apenas onde um sinal de risco real aparece.
Detalhes técnicos
A integração do vendedor começa com uma sessão KYB na API unificada /v3/, ligada ao seu registo 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 dá-lhe 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" } }
]
}
}
Estados da sessão. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.
Webhooks. Subscreva 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 acompanhar 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 gratuito, KYC do proprietário vinculado às taxas padrão de Verificação de Utilizador.
Fluxo de integração para um marketplace
- O vendedor inicia a integração. Cria uma sessão KYB associada ao seu ID de vendedor.
- A empresa é verificada. O registo confirma que a entidade é real e
ACTIVE; os documentos são recolhidos, lidos por OCR e verificados quanto a adulterações. - Os proprietários são identificados e verificados. Pessoas-Chave resolve os UBOs, e uma sessão KYC vinculada verifica cada um — fechando o ciclo entre a entidade e os humanos.
- Todos são rastreados. O AML da entidade rastreia a empresa; o AML no KYC de cada proprietário rastreia as pessoas.
- Decide sobre os pagamentos. Uma sessão
APPROVEDcom proprietários verificados e rastreamento limpo autoriza o vendedor para pagamentos; uma funcionalidadeIN_REVIEWouRESUB_REQUESTEDdireciona precisamente para o que precisa de atenção.
Após a integração, o vendedor torna-se uma entidade gerida que pode manter ACTIVE, FLAGGED ou BLOCKED através da API de negócios à medida que a sua situação muda.
Casos de uso
- Marketplaces de produtos que integram vendedores comerciantes verificam a entidade comerciante e os seus proprietários antes de permitir o pagamento.
- Marketplaces de serviços e trabalho temporário com prestadores empresariais executam KYB em prestadores constituídos para satisfazer a devida diligência do parceiro de pagamento.
- Plataformas de criadores e comércio que pagam a contas empresariais confirmam que a entidade e os seus beneficiários efetivos são reais e rastreados.
- Marketplaces B2B e grossistas verificam as empresas contrapartes e os seus proprietários antes de estender termos comerciais ou pagamentos.
Como integrar com a Didit
- Construa o fluxo de trabalho. Na Consola de Negócios, crie um fluxo de trabalho KYB com registo, AML da empresa, documentos e pessoas-chave ativados, mais KYC vinculado para UBOs.
- Crie a sessão.
POST /v3/session/com o seuworkflow_idKYB e uma referênciavendor_dataque corresponda ao seu ID de vendedor. - Lide com os webhooks. Ouça 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. - Gira o vendedor. Use
GET /v3/businesses/{vendor_data}/ePATCH .../update-status/para manter o vendedorACTIVE,FLAGGEDouBLOCKEDà medida que a sua situação muda.
Como está tudo na API unificada /v3/, verificar a empresa vendedora, fazer KYC dos seus proprietários e monitorizá-la posteriormente é um fluxo contínuo — uma plataforma de identidade e fraude, de ponta a ponta.
Perguntas frequentes
Quanto custa integrar um vendedor empresarial?
2,00 $ por empresa para a verificação KYB completa. As sessões KYC do proprietário são faturadas às taxas padrão de Verificação de Utilizador; o AML da empresa e os documentos KYB custam 0,20 $ cada se os comprar separadamente.
Tenho de verificar os proprietários do vendedor, ou apenas a empresa?
Pode fazer ambos num único fluxo. O KYB de ciclo fechado identifica os UBOs e gera uma sessão KYC vinculada para cada um — para que verifique os humanos por trás do vendedor antes de pagar.
Isto detetará uma empresa vendedora sancionada?
Sim. O AML ao nível da entidade (kyb_company_aml) rastreia a própria empresa, detetando uma empresa designada mesmo quando os seus diretores parecem limpos.
A integração é lenta se fizer tudo isto?
Não. Cada verificação é executada numa única sessão, e os estados por funcionalidade permitem direcionar 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 torna-se uma entidade gerida que pode ser definida como ACTIVE, FLAGGED ou BLOCKED através da API de gestão 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 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 por 2,00 $ por empresa.