B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERComment utiliser SumSub
Découvrez comment connecter et configurer SumSub comme fournisseur de KYC et KYT dans B2CORE, notamment la configuration des documents, les niveaux de vérification, les flux et les paramètres de webhook
Cet article fournit des instructions sur la configuration de B2CORE pour utiliser le fournisseur KYC et KYT, SumSub.
Avant de suivre les instructions, vous devez vous être inscrit à SumSub et disposer d’un compte actif. Pour les contrôles KYT, SumSub Fraud Prevention doit également être activé et correctement configuré.
Comment configurer une connexion à SumSub
Seuls les administrateurs disposant des autorisations pour gérer les connexions externes peuvent configurer une connexion à SumSub.
Pour configurer une connexion :
Dans le Back Office B2CORE, accédez à System > External connections.
Cliquez sur +Create dans l’angle supérieur droit de la page.
Sur la page Create connection, renseignez les champs suivants :
- Dans le champ Name, saisissez le nom que vous souhaitez utiliser pour la connexion.
- Dans le champ Caption, saisissez une légende qui sera appliquée à la connexion dans le Back Office.
- Dans la liste déroulante Provider, sélectionnez SumSubstance.
Cliquez sur Save pour créer la connexion.
Dans la liste des connexions, recherchez la connexion SumSub que vous avez créée et cliquez sur Edit pour saisir les détails de la connexion.
Sur la page Edit connection, spécifiez les paramètres suivants :
- Dans le champ Service Location, indiquez
https://api.sumsub.com/. - Dans le champ Client ID, indiquez le nom de votre compte SumSub. Pour afficher le nom de votre compte, dans l’interface SumSub, accédez à Settings > Account Details.
- Dans le champ Webhook Secret Key, indiquez un secret de webhook. Vous devez générer le webhook dans l’interface SumSub. Pour ce faire, dans l’interface SumSub, accédez à Dev space > Webhooks (pour la configuration requise du webhook, consultez Configuration du webhook SumSub).
- Laissez les champs Login et Password vides.
- Dans les champs Token et Token Secret, indiquez un jeton et une valeur de clé secrète générés dans l’interface SumSub. Pour les générer, dans l’interface SumSub, accédez à Dev space > App Tokens.
- Pour appliquer différents flux de vérification aux clients particuliers et professionnels, sélectionnez Enabled dans la liste déroulante Client Resetting Mode.
Lorsque l’option Client Resetting Mode est activée, cela signifie qu’une vérification répétée est requise pour les clients dont le type est passé de particulier à professionnel, ou inversement. Après la modification d’un type, les événements suivants se produisent :
- Dans le Back Office B2CORE, le niveau de vérification d’un client est réinitialisé à
Level 0, qui est le niveau de vérification par défaut. - Toutes les demandes du client en attente visant à obtenir un niveau de vérification supérieur sont automatiquement rejetées.
- Dans le système SumSub, un demandeur revient au niveau initial et tous les documents précédemment chargés pour ce demandeur sont invalidés.
Tous les fichiers et documents précédemment chargés pour ce client dans le Back Office B2CORE resteront disponibles.
Dans la section Transaction monitoring, configurez les paramètres des contrôles KYT à l’aide de SumSub Fraud Prevention. Ces contrôles sont actuellement pris en charge pour les dépôts et retraits fiat et crypto.
-
Dans la liste déroulante Enabled, sélectionnez :
- Yes — pour activer la surveillance des transactions via SumSub et recevoir les résultats dans B2CORE.
- No — pour désactiver la surveillance des transactions via SumSub.
-
Dans la liste déroulante Currency Filter :
- Sélectionnez une ou plusieurs devises pour surveiller les transactions uniquement dans les devises sélectionnées.
- Laissez la liste vide pour surveiller les transactions dans toutes les devises.
Cliquez sur Save pour appliquer les paramètres.
Comment créer des groupes de documents pour la vérification SumSub
Créez des groupes de documents pour permettre aux clients de soumettre différents documents pris en charge par SumSub pour la vérification. Pour chaque document (comme une carte d’identité, un passeport, un permis de conduire et autres) que vous souhaitez rendre disponible pour la vérification, créez un groupe de documents distinct portant le nom approprié.
Pour créer un groupe de documents :
Dans le Back Office B2CORE, accédez à Verification > Document groups.
Cliquez sur +Create dans l’angle supérieur droit de la page.
Sur la page Create document group, renseignez les champs suivants :
- Dans le champ Name, indiquez le nom d’un groupe de documents.
Veillez à indiquer les noms des groupes de documents exactement comme les noms des types de documents pris en charge par SumSub, tels que ID_CARD, PASSPORT, DRIVERS, RESIDENCE_PERMIT, etc.
Par exemple, si vous souhaitez que vos clients soumettent leur carte d’identité pour la vérification des documents, créez un groupe de documents nommé ID_CARD.
- Dans le champ Caption, indiquez une légende du groupe de documents qui sera affichée dans l’interface B2CORE.
- Dans la liste déroulante Type, sélectionnez One.
- Dans le champ Description, indiquez une description du groupe de documents qui est utilisée dans le Back Office.
Assurez-vous que Yes est sélectionné dans la liste déroulante Enabled.
Cliquez sur Save pour créer le groupe de documents.
Comment créer des types de documents pour la vérification SumSub
Pour chaque groupe de documents que vous avez créé, créez un type de document.
Pour créer un type de document :
Dans le Back Office B2CORE, accédez à Verification > Document types.
Cliquez sur +Create dans l’angle supérieur droit de la page.
Sur la page Create document type, renseignez les champs suivants :
- Dans le champ Name, indiquez le nom d’un type de document.
Les noms des types de documents doivent être identiques aux noms des groupes de documents précédemment créés. Par exemple, ID_CARD, PASSPORT, DRIVERS, RESIDENCE_PERMIT, etc.
- Dans le champ Caption, indiquez une légende du type de document qui sera affichée dans l’interface B2CORE.
- Dans le champ Description, indiquez une description du type de document qui sera affichée dans l’interface B2CORE.
- Dans la liste déroulante Group, sélectionnez le groupe de documents auquel ce type de document doit être associé.
- Dans le champ Max files, indiquez le nombre maximal de fichiers que les clients peuvent charger pour ce type de document.
Dans la liste déroulante Status, sélectionnez Enabled.
Cliquez sur Save pour créer le type de document.
Comment créer des niveaux de vérification pour SumSub dans le Back Office B2CORE
Vous pouvez créer des niveaux de vérification ou modifier les niveaux existants pour utiliser SumSub pour la vérification.
Pour créer un niveau de vérification :
Dans le Back Office B2CORE, accédez à Verification > Levels.
Cliquez sur +Create dans l’angle supérieur droit de la page.
Sur la page Create verification level, renseignez les champs suivants :
-
Dans le champ Index, indiquez une valeur entière non nulle.
L’index zéro (
0) est toujours attribué au niveau de vérification par défaut. Pour les autres niveaux de vérification, l’index doit être supérieur à zéro, par exemple1pour le niveau 1,2pour le niveau 2, etc. -
Dans la liste déroulante Wizard, sélectionnez
SnsWizardSDK. -
Dans le champ Caption, indiquez un nom de niveau qui sera affiché dans l’interface B2CORE et l’application mobile, par exemple
Level 1. Si nécessaire, spécifiez les propriétés de localisation de ce champ en cliquant sur le bouton situé à droite du champ. -
Dans le champ Desktop Description, indiquez une description du niveau à afficher dans l’interface B2CORE. Cette description peut inclure les autorisations accordées aux clients lorsqu’ils obtiennent ce niveau.
La description pour l’interface B2CORE peut être spécifiée au format HTML. Si nécessaire, spécifiez les propriétés de localisation de ce champ.
-
Dans le champ Mobile Description, indiquez une description du niveau à afficher dans l’application mobile.
La description pour l’application mobile peut être spécifiée au format JSON. Si nécessaire, spécifiez les propriétés de localisation de ce champ.
-
Dans la liste déroulante Visible, sélectionnez Yes.
-
Dans la liste déroulante Default, sélectionnez No. (
Level 0est toujours le niveau de vérification par défaut). -
Dans la liste déroulante Assigned Client Right, sélectionnez un niveau d’autorisation définissant l’ensemble des autorisations que vous souhaitez accorder à vos clients après l’obtention de ce niveau de vérification (pour plus de détails, consultez Droits des clients).
-
Dans la liste déroulante Document groups, sélectionnez un ou plusieurs groupes de documents requis. Par exemple, vous pouvez sélectionner
ID_CARDetRESIDENCE_PERMITsi vous souhaitez que vos clients soumettent leurs cartes d’identité et permis de séjour pour vérification afin d’obtenir ce niveau. -
Dans la liste déroulante Client tests, sélectionnez éventuellement un ou plusieurs tests d’accréditation si vous souhaitez obliger vos clients à réussir ces tests avant de pouvoir soumettre leurs documents pour vérification. La liste des tests disponibles comprend tous les tests dont la visibilité est définie sur Yes, qui sont affichés sur la page Tests client.
Cliquez sur Save pour créer le niveau.
Comment créer des niveaux et des flux dans l’interface SumSub
Le Back Office B2CORE prend en charge deux types de clients : particulier et professionnel. Le système SumSub permet de configurer un flux de vérification distinct pour chaque type. Pour utiliser cette option, assurez-vous d’avoir activé le Client Resetting Mode lors de la configuration d’une connexion à SumSub.
Pour ajouter un nouveau niveau :
Dans l’interface SumSub, accédez à Integrations > Applicant Levels.
Cliquez sur Add new level.
Sélectionnez les étapes requises.
Les noms de niveaux doivent être indiqués dans les formats suivants :
- Pour les clients particuliers :
level1,level2, etc. - Pour les clients professionnels :
level3corporate,level4corporate, etc.
Ces formats garantissent une correspondance correcte entre les niveaux dans SumSub et B2CORE. La correspondance est basée sur l’Index attribué à chaque niveau de vérification dans B2CORE. Vous pouvez trouver les index dans la colonne correspondante de la page Verification > Levels du Back Office B2CORE et les utiliser dans les noms de niveaux pour SumSub. Par exemple :
level1dans SumSub correspond au niveau dont l’Index = 1 dans B2CORElevel2dans SumSub correspond au niveau dont l’Index = 2 dans B2CORElevel3corporatedans SumSub correspond au niveau dont l’Index = 3 dans B2CORElevel4corporatedans SumSub correspond au niveau dont l’Index = 4 dans B2CORE, etc.
Pour ajouter un nouveau flux :
Dans l’interface SumSub, accédez à Integrations > Verification Flow.
Cliquez sur Add new.
Sélectionnez les options requises. Pour chaque flux, sélectionnez un niveau compatible.
Configuration du webhook SumSub
Reviewed
- Nom :
REVIEWED - Récepteur :
HTTP Endpoint - Cible :
https://{your-Back-Office-URL}/api/v1/verification-sns/handle - Type :
Applicant reviewed (applicantReviewed) - Clé secrète : la clé secrète générée dans SumSub
Veillez à remplacer {your-Back-Office-URL} par le domaine de votre Back Office B2CORE, et non celui de l’interface B2CORE. Par exemple, la cible des webhooks peut se présenter ainsi : https://example.com/api/v1/verification-sns/handle.
Dernière mise à jour le