Aller au contenu

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éthodeQuand l’utiliser
WebView dans votre appExpé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

Le parcours utilise la caméra (pièce et selfie). Dans une WebView :

  • Android : déclarez android.permission.CAMERA et acceptez la demande dans WebChromeClient.onPermissionRequest.
  • iOS : ajoutez NSCameraUsageDescription et activez allowsInlineMediaPlayback sur la configuration de la WKWebView.

À 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 });
}
}}
/>

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.