Intégration des vendeurs de marketplace avec KYB (FR)

Les marketplaces vivent et meurent par la qualité de leur offre. Intégrer rapidement les vendeurs permet de développer le catalogue — mais intégrer les mauvais vendeurs expose une plateforme à des amendes, des fraudes ou à être dé-bancarisée par son partenaire de paiement. Les vendeurs professionnels augmentent encore les enjeux : un vendeur qui est une entreprise enregistrée signifie que vous ne vérifiez pas seulement une personne, vous vérifiez une entité, identifiez qui la possède, la contrôlez pour les sanctions et vérifiez ses documents avant que l'argent ne commence à y circuler. Fait à la main, cela représente des jours de travail par vendeur. Fait uniquement par une simple recherche au registre, c'est une lacune de conformité qui n'attend que d'être exploitée.

L'API de vérification d'entreprise de Didit transforme l'intégration des vendeurs de marketplace en une seule session KYB. Vérifiez l'entreprise, identifiez et effectuez le KYC de chaque propriétaire, examinez l'entité et vérifiez les documents — le tout sur l'API unifiée /v3/, pour 2,00 $ par entreprise. Ce guide explique comment intégrer correctement les vendeurs professionnels sans ralentir le processus.

Points clés à retenir

• Une session par vendeur. Une seule session KYB couvre le registre, l'identification des bénéficiaires effectifs (UBO), le KYC du propriétaire, l'AML de l'entité et la vérification des documents.
• 2,00 $ par entreprise. La vérification complète est un prix forfaitaire par entité vendeuse, sans minimums — le coût évolue avec le volume de vendeurs.
• KYC de chaque propriétaire. Le KYB en boucle fermée génère une session KYC liée pour chaque UBO, de sorte que vous vérifiez les personnes derrière le vendeur avant les paiements — unique à Didit.
• Détecter les mauvaises entités. L'AML au niveau de l'entité (0,20 $) signale une entreprise vendeuse sanctionnée ou faisant l'objet de rapports défavorables, même si ses dirigeants semblent irréprochables.
• Vérifier les documents, pas seulement les stocker. Les documents KYB (0,20 $ chacun) sont lus par OCR et vérifiés contre la falsification.
• Conçu pour l'échelle. Les statuts par fonctionnalité vous permettent de router les resoumissions et les révisions sans faire échouer l'intégration complète ; les webhooks maintiennent vos dossiers de vendeurs synchronisés.

Ce que fait le KYB du vendeur

Pour une marketplace, un vendeur professionnel est une entité que vous êtes sur le point de payer. Le KYB répond aux questions qui protègent ces paiements : Est-ce une entreprise réelle et en règle ? Qui en est le propriétaire ultime ? L'entité ou l'un de ses propriétaires figure-t-il sur une liste de sanctions ? Ses documents sont-ils authentiques ? Le modèle de session de Didit répond aux quatre questions en un seul endroit via quatre fonctionnalités — kyb_registry, kyb_key_people, kyb_company_aml et kyb_documents — et, avec le KYC lié activé, vérifie également les identités réelles des propriétaires.

Le résultat est un vendeur en qui vous pouvez avoir suffisamment confiance pour le payer : une entreprise vérifiée, un organigramme de propriété résolu, une entité et des propriétaires contrôlés, et des documents vérifiés contre la falsification — produits à partir d'une seule session plutôt que de cinq outils.

Pourquoi c'est important

Les marketplaces qui gèrent les paiements sont de plus en plus traitées comme des flux monétaires réglementés. Les partenaires de paiement et les acquéreurs exigent une diligence raisonnable des vendeurs ; les régimes AML exigent l'identification et la vérification des bénéficiaires effectifs des contreparties commerciales ; et la réalité de la fraude est que les mauvais vendeurs se cachent derrière des sociétés écrans précisément parce que l'intégration dépasse rarement la ligne du registre. Une plateforme qui paie une entité vendeuse non vérifiée, sanctionnée ou fictive supporte la perte et l'exposition réglementaire.

La tension est la vitesse. Les vendeurs abandonnent l'intégration qui prend trop de temps, donc la vérification doit être approfondie et rapide. La façon d'obtenir les deux est d'effectuer toutes les vérifications en une seule session avec un routage précis par fonctionnalité — collecter ce qui est nécessaire, le vérifier automatiquement, et n'impliquer un humain que lorsqu'un véritable signal de risque apparaît.

Détails techniques

L'intégration du vendeur commence par une session KYB sur l'API unifiée /v3/, liée à votre enregistrement interne du vendeur via vendor_data.

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

Le résultat de la session vous donne tout ce dont vous avez besoin pour décider d'un paiement, y compris le KYC lié sur les propriétaires :

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

Statuts de session. NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, IN_REVIEW, RESUBMITTED, ABANDONED, EXPIRED.

Webhooks. Abonnez-vous à status.updated et data.updated (session_kind: business) pour la vérification du vendeur, et aux webhooks de session standard pour le KYC lié de chaque propriétaire. Utilisez business.status.updated pour suivre le statut de l'entité vendeuse après l'intégration.

Prix. 2,00 $ par entreprise. Désagrégé : AML entreprise 0,20 $, documents KYB 0,20 $ chacun, Personnes Clés gratuit, KYC propriétaire lié aux tarifs standard de vérification d'utilisateur.

Flux d'intégration pour une marketplace

1. Le vendeur commence l'intégration. Vous créez une session KYB liée à votre identifiant vendeur.
2. L'entreprise est vérifiée. Le registre confirme que l'entité est réelle et ACTIVE ; les documents sont collectés, lus par OCR et vérifiés contre la falsification.
3. Les propriétaires sont identifiés et vérifiés. Les Personnes Clés résolvent les UBO, et une session KYC liée vérifie chacun d'eux — bouclant la boucle entre l'entité et les personnes.
4. Tout le monde est contrôlé. L'AML de l'entité contrôle l'entreprise ; l'AML sur le KYC de chaque propriétaire contrôle les personnes.
5. Vous décidez des paiements. Une session APPROVED avec des propriétaires vérifiés et un contrôle propre autorise le vendeur pour les paiements ; une fonctionnalité IN_REVIEW ou RESUB_REQUESTED route précisément vers la seule chose qui nécessite une attention.

Après l'intégration, le vendeur devient une entité gérée que vous pouvez maintenir ACTIVE, FLAGGED ou BLOCKED via l'API des entreprises à mesure que son statut change.

Cas d'utilisation

• Les marketplaces de produits qui intègrent des vendeurs marchands vérifient l'entité marchande et ses propriétaires avant d'autoriser le règlement.
• Les marketplaces de services et de petits boulots avec des prestataires professionnels effectuent un KYB sur les prestataires incorporés pour satisfaire la diligence raisonnable des partenaires de paiement.
• Les plateformes de créateurs et de commerce qui paient des comptes professionnels confirment que l'entité et ses bénéficiaires effectifs sont réels et contrôlés.
• Les marketplaces B2B et de gros vérifient les entreprises contreparties et leurs propriétaires avant d'accorder des conditions commerciales ou des paiements.

Comment s'intégrer à Didit

1. Construire le workflow. Dans la console d'entreprise, créez un workflow KYB avec le registre, l'AML de l'entreprise, les documents et les personnes clés activés, ainsi que le KYC lié pour les UBO.
2. Créer la session. POST /v3/session/ avec votre workflow_id KYB et une référence vendor_data correspondant à votre identifiant vendeur.
3. Gérer les webhooks. Écoutez les webhooks status.updated / data.updated du vendeur (session_kind: business) et les webhooks KYC liés de chaque propriétaire ; bloquez les paiements en fonction du résultat combiné.
4. Gérer le vendeur. Utilisez GET /v3/businesses/{vendor_data}/ et PATCH .../update-status/ pour maintenir le vendeur ACTIVE, FLAGGED ou BLOCKED à mesure que son statut change.

Parce que tout est sur l'API unifiée /v3/, la vérification de l'entreprise vendeuse, le KYC de ses propriétaires et son suivi sont un flux continu — une seule plateforme d'identité et de fraude, de bout en bout.

Foire aux questions

Combien coûte l'intégration d'un vendeur professionnel ?

2,00 $ par entreprise pour la vérification KYB complète. Les sessions KYC des propriétaires sont facturées aux tarifs standard de vérification d'utilisateur ; l'AML de l'entreprise et les documents KYB coûtent 0,20 $ chacun si vous les achetez séparément.

Dois-je vérifier les propriétaires du vendeur, ou seulement l'entreprise ?

Vous pouvez faire les deux en un seul flux. Le KYB en boucle fermée identifie les UBO et génère une session KYC liée pour chacun — ainsi vous vérifiez les personnes derrière le vendeur avant d'effectuer les paiements.

Dépistera-t-il une entreprise vendeuse sanctionnée ?

Oui. L'AML au niveau de l'entité (kyb_company_aml) contrôle l'entreprise elle-même, détectant une entreprise désignée même lorsque ses dirigeants semblent irréprochables.

L'intégration est-elle lente si elle fait tout cela ?

Non. Chaque vérification s'exécute en une seule session, et les statuts par fonctionnalité vous permettent de router une seule resoumission ou révision sans faire échouer l'intégration complète — approfondie et rapide.

Comment maintenir le statut d'un vendeur à jour après l'intégration ?

Le vendeur devient une entité gérée que vous pouvez définir comme ACTIVE, FLAGGED ou BLOCKED via l'API de gestion des entreprises, avec des webhooks business.status.updated à chaque changement.

Prêt à commencer ?

Lisez l'aperçu de la vérification d'entreprise dans la documentation, voyez comment cela s'intègre au reste de la plateforme sur la page produit de vérification d'entreprise, et consultez les tarifs transparents par appel sur la page des prix. Quand vous êtes prêt, commencez gratuitement — 500 vérifications KYC gratuites chaque mois, et la vérification d'entreprise à 2,00 $ par entreprise.