Aller au contenu

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.

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 brouillon
status 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.

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.

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.

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)

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.

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.

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.

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 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.

À 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.

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.

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.

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