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 :
- 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).
- À 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.
- Chaque personne reçoit son lien (e-mail automatique si l’adresse est connue, sinon partage par le représentant).
- Le dossier société ne peut être approuvé qu’une fois toutes les personnes requises vérifiées.
Activer sur un formulaire
Section intitulée « Activer sur un formulaire »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éfaut | Rôle |
|---|---|---|
kycFormCode | 1er formulaire guidé de l’organisation | Formulaire KYC utilisé pour chaque personne |
sources | Toutes les listes de personnes | Listes à lire dans le dossier société |
requiredRoles | ubo, representant_legal | Rôles qui doivent faire le KYC |
uboThreshold | 25 | Pourcentage à partir duquel une personne devient bénéficiaire effectif |
expiresInDays | 7 | Validité des liens personnels (1 à 7 jours) |
emailInvites | true | Envoi 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.
Suivre côté intégrateur
Section intitulée « Suivre côté intégrateur »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).