Quand utiliser WebView
Utilisez l’intégration WebView uniquement lorsque :- Vous développez sur une plateforme sans SDK natif (par exemple Xamarin, Cordova ou d’autres frameworks de niche)
- Vous avez besoin d’un prototype rapide ou d’une preuve de concept avant d’intégrer le SDK natif
- Vous migrez depuis le web et souhaitez une passerelle temporaire vers une intégration native
Fonctionnement
1
Créer une session
Votre backend appelle l’API de création de session et reçoit une
url hébergée.2
Ouvrir dans WebView
Votre application charge la
url dans un composant WebView.3
L'utilisateur termine la vérification
L’utilisateur suit le flux de vérification dans la WebView.
4
Intercepter le rappel
Une fois la vérification terminée, WebView accède à votre URL de rappel. Votre application intercepte cette navigation et en extrait le résultat.
5
Récupérer les résultats complets via webhook
Votre backend reçoit les données de décision complètes via le webhook.
Créer une session
Avant d’ouvrir le flux de vérification, créez une session depuis votre backend :201, l’url intègre le session_token de 12 caractères, et non le session_id) :
url dans WebView, sans jamais le construire manuellement à partir de session_token.
React Native
Installez le package WebView :Implémentation
Démo React Native
Exemple de vérification Expo + WebView
Flutter
Ajoutez les packages requis àpubspec.yaml :
Implémentation
Démo Flutter
Exemple de vérification Flutter WebView
Configuration essentielle
Agent utilisateur (obligatoire)
Vous devez définir un agent utilisateur mobile générique pour que WebView fonctionne correctement :Paramètres multimédias (obligatoires)
Gestion du rappel
Après la vérification, WebView redirige vers votre URL de rappel avec des paramètres de requête :Dépannage
La caméra ne fonctionne pas
La caméra ne fonctionne pas
- Vérifiez que
mediaPlaybackRequiresUserGestureestfalse - Vérifiez que les autorisations de la caméra sont accordées au niveau du système d’exploitation
- Vérifiez que la chaîne de l’agent utilisateur est correctement définie
Écran blanc ou problèmes de chargement
Écran blanc ou problèmes de chargement
- Vérifiez que l’URL de la session est valide et n’a pas expiré
- Vérifiez la connexion Internet
- Vérifiez que JavaScript est activé dans les paramètres de WebView
Le rappel ne se déclenche pas
Le rappel ne se déclenche pas
- Vérifiez que votre URL de rappel correspond à celle que vous avez définie lors de la création de la session
- Vérifiez que le délégué ou l’écouteur de navigation est correctement configuré
- Essayez de définir
callback_methodsur"both"lors de la création de la session