tano-sdk

La bibliothèque Python officielle de l'API de vérification d'identité Tano.

• Signature des requêtes (HMAC-SHA256, v2) et protection contre le rejeu, prises en charge
• Clé d'idempotence sur chaque écriture, conservée d'un réessai à l'autre
• Réessais automatiques sur coupure réseau, 429 et 5xx, en respectant Retry-After
• Vérification de la signature des webhooks
• Typée (py.typed), sans dépendance : la bibliothèque standard seulement

Prérequis

Python 3.9 ou plus récent.

Installation

pip install tano-sdk

Démarrage rapide

import os
from tano_sdk import Tano

tano = Tano(os.environ["TANO_API_KEY"])  # tano_sandbox_… ou tano_prod_…

case = tano.cases.create(
    flow_name="onboarding_individual_ci",
    country="CI",
    external_ref="customer-42",  # un seul dossier par intention, même rejouée
    declared={"surname": "KOUASSI", "given_names": "Awa"},
)

session = tano.sessions.create(
    case_id=case["id"],
    locale="fr",
    return_url="https://votre-site.example/verification/terminee",
)
print(session["url"])  # rendue une seule fois, ne la stockez pas

results = tano.cases.results(case["id"])
if results["state"] == "approved":
    ...

Configuration

Tano(
    api_key,  # obligatoire ; l'environnement se lit dans le préfixe de la clé
    base_url="https://api.tano.africa",
    timeout=30.0,  # secondes, par tentative
    max_retries=2,
    transport=urllib_transport,  # remplaçable : tout appelable HttpRequest -> HttpResponse
)

Référence de l'API

results["state"] vaut awaiting_applicant, processing, in_review, resubmission_requested (pas un refus), approved, rejected (définitif), expired ou abandoned.

Webhooks

Passez le corps brut (request.get_data(), await request.body()).

from flask import Flask, abort, request
from tano_sdk import WebhookSignatureError, verify_webhook

app = Flask(__name__)


@app.post("/webhooks/tano")
def tano_webhook():
    try:
        event = verify_webhook(
            request.get_data(), request.headers, os.environ["TANO_WEBHOOK_SECRET"]
        )
    except WebhookSignatureError:
        abort(401)
    # Écartez les doublons avec event["delivery_id"], mettez en file, répondez vite.
    return "", 204

Erreurs

Support

Documentation : https://docs.tano.africa · Support : support@tano.africa · Sécurité : security@tano.africa

Licence

MIT © Qalebasse