Aller au contenu

KYB multi-liens

Pour un dossier entreprise, une seule personne ne devrait pas fournir les pièces et selfies de tous les autres. Avec le KYB multi-liens :

  1. Le représentant légal remplit le dossier de la société et déclare ses personnes (nom, rôles, pourcentage, téléphone, e-mail).
  2. À l’envoi, RegulaLink crée une session KYC guidée par personne requise : bénéficiaires effectifs (25 % ou plus, ou rôle déclaré) et représentant légal.
  3. Chaque personne reçoit son lien (e-mail automatique si l’adresse est connue, sinon partage par le représentant).
  4. Le dossier société ne peut être approuvé qu’une fois toutes les personnes requises vérifiées.

Partez du modèle « KYB multi-liens — KYC guidé des UBO » dans l’éditeur de formulaire, ou ajoutez le bloc kybParties au schéma :

"kybParties": {
"enabled": true,
"kycFormCode": "kyc-client-wallet",
"sources": [{ "arrayFieldKey": "personnes" }],
"requiredRoles": ["ubo", "representant_legal"],
"uboThreshold": 25,
"expiresInDays": 7,
"emailInvites": true
}
CléDéfautRôle
kycFormCode1er formulaire guidé de l’organisationFormulaire KYC utilisé pour chaque personne
sourcesToutes les listes de personnesListes à lire dans le dossier société
requiredRolesubo, representant_legalRôles qui doivent faire le KYC
uboThreshold25Pourcentage à partir duquel une personne devient bénéficiaire effectif
expiresInDays7Validité des liens personnels (1 à 7 jours)
emailInvitestrueEnvoi automatique du lien quand l’e-mail est connu

Une personne saisie deux fois (même nom, même avec une casse différente) n’est vérifiée qu’une seule fois, avec ses rôles cumulés.

Chaque personne a sa propre session : vous recevez donc les webhooks kyc.session.completed et kyc.session.decided pour chaque bénéficiaire effectif, avec dans metadata :

{
"kybParentSessionId": "a91f…",
"kybPartyId": "52c7…",
"kybCompanyName": "SARL Kivu Logistics",
"kybPersonName": "Marie Mukendi",
"kybRoles": ["actionnaire", "ubo"],
"kybRolesLabel": "Actionnaire · Bénéficiaire effectif"
}

L’externalRef d’une session personne reprend celui du dossier société, suivi de la position de la personne (client-123:personnes:1).