Dans votre page : web et React

Le parcours s’affiche dans votre page, dans un cadre. Il ne s’affiche qu’après une poignée de main avec votre page, dont le navigateur atteste l’origine : celle-ci doit figurer parmi vos domaines autorisés, réglés dans la console, page Développeurs.

Installer

JavaScript

npm install @tano-africa/web

React

npm install @tano-africa/react

Afficher le parcours

Votre serveur crée la session et rend son url à la page.

JavaScript

import { mount } from "@tano-africa/web";

const journey = mount("#verification", {
  url: session.url,
  onCompleted: () => showThankYou(),
  onEnded: (reason) => offerRetry(reason),
  onExpired: () => fetch("/api/verification/link").then((r) => r.json()).then((j) => j.url),
});

React

import { TanoVerification } from "@tano-africa/react";

<TanoVerification
  url={session.url}
  onCompleted={() => router.push("/verification/merci")}
  onExpired={() => fetch("/api/verification/link").then((r) => r.json()).then((j) => j.url)}
/>

Quand le lien expire, onExpired rend un nouveau lien (créé par votre serveur pour le même dossier) et le parcours reprend dans le même cadre.

Les événements

Rappel	Quand
onReady	le parcours est affiché
onStep	une étape commence : consent, document, face, uploading…
onCompleted	la personne a tout envoyé
onEnded	arrêt sans envoi : declined, expired, invalid_link, later

Aucun événement ne porte de résultat : lisez la décision sur votre serveur.

Sans cadre : fenêtre ou redirection

launch({ url }) ouvre le parcours dans une fenêtre, ou dans l’onglet si la fenêtre est bloquée. Créez alors la session avec une return_url sur votre site, et appelez handleReturn() sur cette page : elle prévient l’onglet d’origine et la fenêtre se ferme.