Demandes et signataires
Une demande de signature fait signer un ou plusieurs documents PDF par une ou plusieurs
personnes, chacune authentifiée par un code à usage unique. Le service se souscrit seul : une clé
porte la portée signature, et l’unité facturée est une demande complétée. Une demande
refusée, expirée ou annulée n’est pas facturée. Une clé sans la portée est refusée avec
key_scope_insufficient ; un service non souscrit, avec
service_not_subscribed.
La demande de signature
Section intitulée « La demande de signature »Une demande réunit des documents, des signataires et, pour chaque signataire, des
champs placés sur les pages. Elle se crée en un appel, documents en base 64 compris, et peut
partir dans le même appel ("activate": true) : c’est la forme recommandée.
Une demande activée ne se modifie plus : ni ses documents, ni ses signataires, ni ses champs. Pour corriger une clause, annulez-la et créez-en une autre ; la demande annulée reste consultable.
draft ──activate──► ongoing ──(le dernier signataire signe)──► completed │ ├── un signataire refuse ──────────────► declined │ ├── échéance dépassée ─────────────────► expired │ └── vous annulez ──────────────────────► cancelled └── vous supprimez le brouillonstatus |
Ce que cela veut dire |
|---|---|
draft |
Brouillon. Rien n’est envoyé. Seul un brouillon se supprime. |
ongoing |
Envoyée : documents figés, premiers signataires invités. |
completed |
Tous ont signé : le document signé et le fichier de preuve se téléchargent. |
declined |
Un signataire a refusé : la demande s’arrête pour tous. |
expired |
L’échéance est passée avant que tous aient signé. |
cancelled |
Vous l’avez annulée, avec un motif. |
L’échéance est de 30 jours par défaut, de 1 à 90 jours (expires_in_days). Elle court à partir
de l’activation. Un signataire ne peut plus signer une demande expirée, annulée ou refusée, même
s’il a ouvert la page avant. Une demande échue passe en expired dans la minute qui suit son
échéance, et vous recevez signature_request.expired.
Relances
Section intitulée « Relances »Tano relance de lui-même les signataires invités qui n’ont pas encore répondu, aux jours choisis
dans reminder_days : deux relances au plus, à J+2 et J+5 par défaut, comptées depuis
l’invitation. [] n’en envoie aucune. Une relance ne part jamais moins de vingt-quatre heures
après l’invitation, jamais entre 21 h et 7 h dans le fuseau du signataire (time_zone), et jamais
après l’échéance. Elle porte un nouveau lien, qui remplace le précédent. En bac à sable, aucune
relance n’est envoyée. Un signataire en delivery: none n’est jamais relancé, et vous pouvez
relancer à la main un signataire qui tarde.
Une organisation suspendue ne relance plus personne et ses liens de signature sont refusés ; ses demandes en cours expirent à leur échéance.
Le niveau est fixé à la création et ne change plus. Seul le niveau simple est disponible
aujourd’hui ; un autre niveau est refusé avec
signature_level_unavailable.
ordering |
Qui est invité, et quand |
|---|---|
sequential (par défaut) |
Chacun est invité quand ceux qui le précèdent (position) ont signé. |
parallel |
Tous sont invités à l’activation. |
Les documents
Section intitulée « Les documents »Des PDF, 10 au plus par demande, 20 Mo et 200 pages au plus chacun. Chaque document est
aplati dès son dépôt : formulaires figés, scripts, pièces jointes et contenus dynamiques
retirés. Un PDF qui ne peut pas l’être (illisible, chiffré) est refusé avec
document_not_flattenable.
La réponse donne, pour chaque document, son nombre de pages (pages) et l’empreinte SHA-256 du PDF
aplati (sha256) : c’est ce document-là que chaque signataire signe.
Les signataires
Section intitulée « Les signataires »Un signataire a un nom, un rôle, une méthode d’authentification et la coordonnée qui va avec. 20 signataires au plus par demande.
role |
Ce qu’on attend de lui |
|---|---|
signer (par défaut) |
Il signe le document. |
approver |
Il approuve ; son approbation est requise pour que la demande aboutisse. |
viewer |
Destinataire en copie : il n’est pas attendu. |
auth_method |
Comment il est authentifié | Coordonnée requise |
|---|---|---|
otp_email |
code à usage unique par courriel | email |
otp_sms |
code à usage unique par SMS | phone, au format international (+2250701021234) |
Le code à usage unique
Section intitulée « Le code à usage unique »Personne ne signe sans être authentifié. Le code a six chiffres, vaut dix minutes et admet trois essais ; le signataire peut en redemander un après soixante secondes, trois fois par heure au plus. Une fois authentifié, il a quinze minutes pour signer avant de devoir saisir un nouveau code.
Le lien seul ne suffit donc pas à signer : il faut aussi le code, reçu sur un second canal.
États d’un signataire
Section intitulée « États d’un signataire »status |
Ce que cela veut dire |
|---|---|
pending |
Pas encore invité : en ordre séquentiel, ce n’est pas son tour. |
notified |
Invité. |
opened |
Il a ouvert le document. |
authenticated |
Il a saisi un code valide. |
signed |
Il a signé. |
declined |
Il a refusé, avec un motif. |
released |
Libéré : un autre membre de son groupe a signé. Son lien ne vaut plus. |
Ce que l’API rend d’un signataire
Section intitulée « Ce que l’API rend d’un signataire »Les coordonnées sont rendues masquées (a••••@exemple.ci, +225 07 •• •• 12 34). Le nom
n’est rendu (name) qu’à une clé qui porte la permission personal_data ; sinon il vaut null.
Les webhooks, eux, ne portent jamais ni nom, ni adresse, ni téléphone.
Les champs
Section intitulée « Les champs »Un champ est une zone d’une page, affectée à un signataire : signature, initiales, date, texte, case à cocher ou mention imposée. Ses types, ce qui s’inscrit sur le document et le placement en points PDF sont décrits dans Placer les champs.
Le consentement
Section intitulée « Le consentement »Le signataire coche « J’ai lu le document et j’accepte de le signer électroniquement. », puis clique « Signer le document ». Le libellé est figé et sa version est conservée dans le fichier de preuve.
Le document signé et le fichier de preuve
Section intitulée « Le document signé et le fichier de preuve »À la complétion, Tano produit pour chaque document un PDF signé : les champs y sont incrustés, le fichier de preuve y est joint, et le tout est scellé par le cachet de Tano, horodaté. Il s’ouvre dans n’importe quel lecteur PDF, qui en montre l’intégrité.
Le fichier de preuve est un PDF scellé, distinct du document : il retrace, pour chaque signataire, l’invitation, l’ouverture, l’envoi du code (coordonnée masquée), l’authentification, le consentement avec la version du libellé, la signature, l’adresse IP, l’appareil et l’heure. Il n’est plus jamais modifié après la complétion.
La signature simple
Section intitulée « La signature simple »Au niveau simple, chaque signataire est authentifié par un code à usage unique et son geste est consigné dans le fichier de preuve ; le document final porte un cachet, celui de Tano, et non une signature cryptographique par signataire. C’est le fichier de preuve qui établit qui a signé, quand et comment.
Environnements
Section intitulée « Environnements »Une demande porte l’environnement de la clé qui l’a créée (environment : prod,
test ou sandbox). Une clé ne voit et n’agit que sur ceux de son environnement : les autres lui
répondent 404. Avec une clé de bac à sable, rien ne part, rien n’est facturé et le document
produit est un spécimen : voir Le bac à sable de la signature.
Étapes suivantes
Section intitulée « Étapes suivantes »- Faire signer un document, pas à pas.
- Le bac à sable de la signature, pour l’essayer sans rien envoyer.
- La référence de la signature : routes, champs et réponses.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]