Documentation développeur

Construire avec l'API Tano

Guides, référence et exemples pour vérifier l'identité de vos clients depuis votre serveur, du bac à sable à la production.

Démarrage rapide Référence de l'API

cURLNode.jsPython

# Ouvrir un dossier — les créations sont signées
curl https://api.tano.africa/v1/cases \
  -H "Authorization: Bearer $TANO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "X-Tano-Timestamp: $TS" \
  -H "X-Tano-Signature: v2=$SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{"flow_name":"identite_ci","country":"CI"}'

// creer() signe et envoie : voir « Signer les requêtes »
const dossier = await creer("/v1/cases", {
  flow_name: "identite_ci",
  country: "CI",
  external_ref: "client-4821",
});

const lien = await creer("/v1/sessions", {
  case_id: dossier.id,
  locale: "fr",
});
// → envoyez lien.url à la personne

# creer() signe et envoie : voir « Signer les requêtes »
dossier = creer("/v1/cases", {
    "flow_name": "identite_ci",
    "country": "CI",
    "external_ref": "client-4821",
})

lien = creer("/v1/sessions", {"case_id": dossier["id"], "locale": "fr"})
# → envoyez lien["url"] à la personne

201{"id": "case_01J9…", "status": "created"}

Comment ça marche

1
Ouvrir un dossier
Votre serveur crée un dossier pour la personne à vérifier.
POST /v1/cases
2
Envoyer le lien
Il demande un lien de parcours et l'envoie par SMS, courriel ou redirection.
POST /v1/sessions
3
La personne se vérifie
Sur son téléphone : le pays et la pièce, la photo de chaque face, puis un selfie.
verify.tano.africa
4
Recevoir la décision
Tano vous notifie par webhook : approved, rejected ou manual_review.
case.decided

Par où commencer

Essayer la démoLe vrai parcours sur votre téléphone, sans clé ni compte.

Démarrage rapideUn dossier, un lien, une décision : l'intégration de bout en bout.

Essayer un parcoursUn script prêt à l'emploi avec votre clé de bac à sable.

Signer les requêtesLa signature HMAC des créations, et l'idempotence.

Recevoir les webhooksVérifier la signature, écarter les doublons, répondre vite.

Bac à sable et clésObtenir une clé de test, puis passer aux clés de production.

Référence

APILes routes, leurs paramètres et leurs réponses.

ÉvénementsCe que portent les webhooks, événement par événement.

ErreursChaque code d'erreur, ce qu'il signifie et comment le corriger.

Passer en productionLa liste de ce qu'il faut vérifier avant d'ouvrir le parcours.

Construire avec l'API Tano

Comment ça marche

Ouvrir un dossier

Envoyer le lien

La personne se vérifie

Recevoir la décision

Par où commencer

Référence