Dans votre application : iOS, Android, Flutter, React Native

Les SDK mobiles affichent le parcours dans votre application et vous en rapportent l’avancement. Votre serveur crée la session et transmet son url à l’application. La caméra n’est accordée qu’au parcours, et rien n’en est gardé sur le téléphone une fois l’écran fermé.

Installer et afficher

iOS

Swift Package Manager, adresse https://github.com/Qalebasse/tano-sdk, produit TanoSDK (iOS 15 et plus). Ajoutez NSCameraUsageDescription à l’Info.plist.

import TanoSDK

let verification = TanoVerificationViewController(url: sessionURL) { event in
    switch event {
    case .completed: self.showThankYou()
    case .ended(let reason): self.offerRetry(reason)
    default: break
    }
}
present(UINavigationController(rootViewController: verification), animated: true)

Android

app/build.gradle.kts

implementation("africa.tano:tano-android:0.1.0")

private val verification = registerForActivityResult(TanoVerification()) { outcome ->
    when (outcome) {
        is TanoEvent.Completed -> showThankYou()
        is TanoEvent.Ended -> offerRetry(outcome.reason)
        else -> Unit
    }
}

verification.launch(sessionUrl)

Android 7.0 (API 24) et plus. Le SDK demande la caméra au moment où le parcours en a besoin.

Flutter

flutter pub add tano_flutter

Flutter 3.24 et plus, Android API 24 et iOS 15 et plus. Ajoutez NSCameraUsageDescription à l’Info.plist et demandez la permission CAMERA sur Android avant d’ouvrir le parcours.

TanoVerification(
  url: Uri.parse(session.url),
  onEvent: (event) => switch (event) {
    TanoCompleted() => showThankYou(),
    TanoEnded(:final reason) => offerRetry(reason),
    _ => null,
  },
)

React Native

npm install @tano-africa/react-native react-native-webview

<TanoVerification
  url={session.url}
  onEvent={(event) => {
    if (event.type === "completed") navigation.replace("Merci");
    if (event.type === "ended") showRetry(event.reason);
  }}
/>

Les événements

Événement	Quand
prêt	le parcours est affiché
étape	une étape commence : consent, document, face, uploading…
terminé	la personne a tout envoyé ; lisez le dossier côté serveur
arrêté	declined, expired, invalid_link, later, ou cancelled si la personne ferme l’écran

Aucun événement ne porte de résultat ni de donnée personnelle : la décision se lit côté serveur.