Comment utiliser Persona

Cet article explique comment configurer B2CORE pour utiliser le fournisseur KYC Persona. Avec Persona, les clients vérifient leur identité dans le parcours Persona qui s’ouvre dans l’interface de B2CORE ou dans l’application mobile : ils photographient une pièce d’identité officielle et prennent un selfie, que Persona vérifie ensuite. B2CORE reçoit le résultat, télécharge les photos des documents dans le profil du client, met à jour ses données et approuve ou refuse la demande de vérification.

Fonctionnement de la vérification

1. Un client lance la vérification pour un niveau qui utilise Persona. B2CORE crée une demande Persona à l’aide du modèle de demande attribué à ce niveau et préremplit le nom, l’adresse e-mail et le numéro de téléphone du client.
2. Le parcours Persona s’ouvre dans l’interface de B2CORE ou dans l’application mobile. Le client téléverse ses documents et prend un selfie directement dans Persona : les fichiers ne transitent pas par B2CORE.
3. Une fois le parcours terminé, B2CORE crée une demande de vérification pour ce niveau.
4. Persona prend une décision concernant la demande (automatiquement avec un Workflow Persona, ou manuellement par votre équipe de conformité) et envoie un webhook à B2CORE.
5. B2CORE télécharge les photos des documents, met à jour le profil du client et approuve ou refuse la demande. Si la demande est approuvée, le client obtient le niveau de vérification.

Si le client ferme le navigateur ou l’application avant que le parcours ne revienne à B2CORE, le webhook finalise tout de même la demande : aucune donnée n’est perdue.

Configurer Persona

Effectuez les étapes suivantes dans le tableau de bord Persona. Vous aurez besoin des valeurs obtenues pour configurer la connexion dans B2CORE.

Créer des modèles de demande

Créez un modèle de demande pour chaque niveau de vérification B2CORE qui doit utiliser Persona. Ajoutez les étapes de vérification requises pour le niveau, comme la présentation d’une pièce d’identité officielle et la prise d’un selfie. Vous pouvez également créer un modèle distinct pour les clients professionnels.

Copiez l’identifiant de chaque modèle (il commence par itmpl_). Vous le trouverez dans les paramètres du modèle, dans le tableau de bord Persona.

Configurer la prise de décision

Créez un Workflow Persona qui approuve les demandes ayant passé toutes les vérifications et refuse celles qui y échouent. Sans cela, les demandes restent au statut completed ou failed dans Persona et ne sont jamais approuvées ni refusées.

Obtenir la clé API

Dans le tableau de bord Persona, créez une clé API. Les clés sandbox commencent par persona_sandbox_ et les clés de production par persona_production_. L’URL de l’API est la même pour les deux environnements ; la clé détermine l’environnement utilisé.

Obtenir l’identifiant de l’environnement

Copiez l’identifiant de l’environnement Persona que vous utilisez (il commence par env_). Pour le trouver, dans le tableau de bord Persona, accédez à Organisation > Informations.

Créer un webhook

Dans le tableau de bord Persona, créez un webhook avec les paramètres suivants :

• URL : https://{your-B2CORE-back-office-domain}/api/v2/my/verification-persona/webhook
• Événements :
  • inquiry.created
  • inquiry.completed
  • inquiry.failed
  • inquiry.approved
  • inquiry.declined
  • inquiry.marked-for-review

Après avoir créé le webhook, copiez son secret (il commence par wbhsec_).

Comment configurer une connexion à Persona

Seuls les administrateurs disposant des autorisations nécessaires pour gérer les connexions externes peuvent configurer une connexion à Persona.

Pour configurer une connexion :

Paramètres de connexion

Lorsque vous modifiez la connexion ultérieurement, laissez les champs Clé API et Secret du webhook vides pour conserver les valeurs enregistrées.

Approuver les vérifications terminées sans décision de Persona

• No (recommandé) — B2CORE attend que Persona approuve ou refuse la demande.
• Yes — une demande terminée par le client est approuvée et une demande ayant échoué est refusée, sans attendre de décision de Persona.

Préfixe de l’identifiant de référence

Persona considère qu’un identifiant de référence correspond à une personne. B2CORE envoie l’identifiant du client comme identifiant de référence. Par exemple, avec le préfixe brand-, le client dont l’identifiant est 454 est envoyé sous l’identifiant brand-454.

• Si plusieurs installations B2CORE utilisent la même organisation Persona (par exemple, un environnement de production et un environnement de test, ou deux marques), attribuez un préfixe unique à chaque installation. Sinon, des clients différents ayant le même identifiant sont fusionnés en une seule personne dans Persona.
• Si votre organisation Persona est utilisée uniquement par cette installation B2CORE, laissez le champ vide. B2CORE envoie alors l’identifiant du client sans préfixe.
• Le préfixe peut contenir jusqu’à 32 caractères : des lettres latines, des chiffres et les symboles _, ., :, -.

Synchroniser les selfies

• Yes (par défaut) — le selfie pris par le client dans Persona est enregistré parmi ses documents, à côté des photos de sa pièce d’identité.
• No — seules les photos de la pièce d’identité sont enregistrées. Le selfie reste dans Persona.

Comment créer des niveaux de vérification pour Persona

Vous pouvez créer des niveaux de vérification ou modifier les niveaux existants pour utiliser Persona.

Pour créer un niveau de vérification :

Les groupes et les types de documents ne sont pas nécessaires pour Persona : les documents que les clients doivent fournir sont définis dans le modèle de demande Persona.

Les niveaux qui utilisent d’autres assistants conservent leur fournisseur actuel.

Que se passe-t-il après la vérification ?

Persona envoie un webhook à B2CORE lorsqu’une demande change de statut. B2CORE traite le webhook comme suit :

Remarques :

• B2CORE enregistre les photos de la pièce d’identité et, si Synchroniser les selfies est défini sur Yes, le selfie parmi les documents du client.
• Après une approbation, B2CORE met à jour le prénom, le deuxième prénom, le nom de famille, la date de naissance, le pays et l’adresse du client à partir des données extraites des documents par Persona. Le numéro de téléphone n’est pas mis à jour.
• Si un responsable de la conformité prend une décision manuellement dans le Back Office, cette décision prévaut sur celle de Persona.
• Les webhooks reçus en double ou dans le désordre ne posent pas de problème : B2CORE lit toujours l’état actuel de la demande dans Persona.
• Si un webhook est perdu, B2CORE traite à nouveau les demandes qui attendent une décision depuis plus de 6 heures (la vérification est effectuée quotidiennement).
• Les demandes commencées mais non soumises par le client ne créent pas de demandes de vérification.

Migrer depuis SumSub

1. Configurez et activez la connexion Persona.
2. Pour chaque niveau qui doit utiliser Persona, sélectionnez le modèle de demande, puis définissez l’Assistant du niveau sur PersonaSDK.
3. Désactivez la connexion SumSub.

Les clients conservent leurs niveaux de vérification actuels.

Résolution des problèmes

• Les demandes restent en attente après que le client a terminé la vérification. Vérifiez qu’un Workflow Persona approuve ou refuse les demandes, ou activez Approuver les vérifications terminées sans décision de Persona. Vérifiez également que le webhook a été créé avec tous les événements requis.
• Les webhooks sont rejetés. Vérifiez que le Secret du webhook défini dans la connexion correspond au secret du webhook dans Persona.
• Le client voit une erreur lorsqu’il lance la vérification. Vérifiez qu’un modèle de demande est sélectionné pour le niveau (pour les clients professionnels, le modèle destiné aux particuliers est utilisé si le modèle pour les clients professionnels n’est pas renseigné).