Aller au contenu

Côté serveur : Node.js et Python

Les deux bibliothèques ont la même forme. Elles signent les requêtes, posent une clé d’idempotence sur chaque écriture et la gardent d’un réessai à l’autre, et réessaient d’elles-mêmes après une coupure réseau, un 429 ou un 5xx. Aucune dépendance.

Node.js 20 ou plus récent.

Fenêtre de terminal
npm install @tano-africa/node
import { Tano } from "@tano-africa/node";
const tano = new Tano({ apiKey: process.env.TANO_API_KEY! });
const kase = await tano.cases.create({
flow_name: "onboarding_particulier_ci",
country: "CI",
external_ref: "client-42",
});
const session = await tano.sessions.create({
case_id: kase.id,
return_url: "https://votre-site.example/verification/terminee",
});
// session.url : le lien du parcours, rendu une seule fois.

L’environnement se déduit de la clé : une clé tano_sandbox_… travaille dans le bac à sable, une clé tano_prod_… en production.

const results = await tano.cases.results(kase.id);
switch (results.state) {
case "approved":
// ouvrir le compte
break;
case "rejected":
// refus définitif : results.decision.reason_code
break;
case "resubmission_requested":
// la personne doit reprendre results.resubmission.steps
break;
}

La liste des états et le détail des résultats sont dans la référence de l’API. Les données personnelles (cases.data) et les images (cases.image) demandent une clé avec la permission personal_data ; trancher un dossier en revue (cases.decide), la permission decisions.

Depuis la version 0.2.0. Les PDF s’envoient en octets : le SDK les encode en base 64. Les champs se placent en points PDF depuis le coin bas gauche de la page : voir Placer les champs.

import { readFile, writeFile } from "node:fs/promises";
const demande = await tano.signatureRequests.create({
name: "Bail — appartement Cocody",
reference: "BAIL-2026-118",
documents: [{ filename: "bail.pdf", content: await readFile("bail.pdf") }],
signers: [
{
given_name: "Aya",
family_name: "Koné",
auth_method: "otp_email",
fields: [{ document: 0, kind: "signature", page: 1, x: 60, y: 80, width: 170, height: 50 }],
},
],
activate: true,
});
// Le lien d'un signataire, pour l'ouvrir dans votre application.
const { url } = await tano.signatureRequests.link(demande.id, demande.signers[0].id);
// En bac à sable : signer à sa place.
await tano.sandbox.sign(demande.id, demande.signers[0].id);
// À `signature_request.completed` : le document signé et la preuve.
const signe = await tano.signatureRequests.download(demande.id, demande.documents[0].id);
const preuve = await tano.signatureRequests.auditTrail(demande.id);
await writeFile("bail-signe.pdf", signe.data); // signe.sha256, signe.signed, signe.sandbox

Le reste : retrieve, list (status, reference, limit), activate pour un brouillon, cancel avec un motif, delete pour un brouillon, et sandbox.decline pour simuler un refus.

const profil = (await tano.seals.profiles()).find((p) => !p.revoked);
const cachet = await tano.seals.create({
profile_id: profil.id,
document: await readFile("attestation.pdf"),
reference: "ATT-2026-0042",
});
const scelle = await tano.seals.download(cachet.id);
const verification = await tano.documents.verify(scelle.data);
console.log(verification.sound); // intègre, juste, reconnu

Passez toujours le corps brut de la requête : un objet relu puis réécrit ne correspond plus à la signature.

import express from "express";
import { verifyWebhook, WebhookSignatureError } from "@tano-africa/node";
app.post("/webhooks/tano", express.raw({ type: "application/json" }), (req, res) => {
try {
const event = verifyWebhook(req.body, req.headers, process.env.TANO_WEBHOOK_SECRET!);
// écarter les doublons avec event.delivery_id, mettre le traitement en file
res.sendStatus(204);
} catch (error) {
if (error instanceof WebhookSignatureError) return res.sendStatus(401);
throw error;
}
});

Une erreur de l’API lève TanoApiError, avec son code : c’est lui qu’il faut tester, il ne change pas (voir la liste des erreurs). TanoConnectionError signale une absence de réponse après les réessais ; rejouer avec la même clé d’idempotence est alors sans risque.

© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]