Intégration mobile
Le parcours est une application web pensée pour le téléphone. Vous pouvez l’ouvrir de trois façons.
| Méthode | Quand l’utiliser |
|---|---|
| WebView dans votre app | Expérience intégrée, la personne ne quitte pas votre application |
| Navigateur (Custom Tabs, SFSafariViewController) | Le plus simple ; retour via redirectUrl avec un schéma d’app |
| Lien envoyé (SMS, WhatsApp, e-mail) | Vérification à distance, ou depuis un ordinateur avec passage au téléphone par QR code |
Autoriser la caméra
Section intitulée « Autoriser la caméra »Le parcours utilise la caméra (pièce et selfie). Dans une WebView :
- Android : déclarez
android.permission.CAMERAet acceptez la demande dansWebChromeClient.onPermissionRequest. - iOS : ajoutez
NSCameraUsageDescriptionet activezallowsInlineMediaPlaybacksur la configuration de laWKWebView.
Recevoir le résultat dans l’application
Section intitulée « Recevoir le résultat dans l’application »À la fin du parcours, la page envoie un message à l’application hôte, puis suit redirectUrl s’il existe :
{ "source": "regulalink-kyc", "type": "kyc.completed", "sessionId": "7c1e…", "status": "SUBMITTED", "decision": "REVIEW", "redirectUrl": "monapp://kyc/retour?…&signature=…"}Le message est envoyé sur tous les canaux disponibles :
<WebView source={{ uri: session.url }} mediaCapturePermissionGrantType="grant" onMessage={(e) => { const msg = JSON.parse(e.nativeEvent.data); if (msg.source === "regulalink-kyc" && msg.type === "kyc.completed") { navigation.replace("KycPending", { sessionId: msg.sessionId }); } }}/>// Le message arrive sur le handler « regulalinkKyc ».config.userContentController.add(self, name: "regulalinkKyc")
func userContentController(_ c: WKUserContentController, didReceive message: WKScriptMessage) { guard let body = message.body as? [String: Any], body["type"] as? String == "kyc.completed" else { return } showPendingScreen(sessionId: body["sessionId"] as? String)}// Le message arrive sur l'interface JavaScript « RegulaLinkKyc » (chaîne JSON).webView.addJavascriptInterface(object { @JavascriptInterface fun postMessage(json: String) { val msg = JSONObject(json) if (msg.optString("type") == "kyc.completed") showPendingScreen(msg.optString("sessionId")) }}, "RegulaLinkKyc")window.addEventListener("message", (e) => { if (e.data?.source === "regulalink-kyc" && e.data.type === "kyc.completed") { showPending(e.data.sessionId); }});Sur ordinateur
Section intitulée « Sur ordinateur »Si le lien est ouvert sur un ordinateur, la page affiche un QR code pour continuer sur le téléphone. Elle se met à jour automatiquement quand la vérification est terminée sur le téléphone.