Aller au contenu

Le parcours du signataire

Par défaut, Tano invite chaque signataire à son tour, par courriel ou par SMS selon la méthode de son code, le relance aux jours choisis, et lui montre l’issue sur la page de signature. Quatre réglages changent ce parcours. Chacun se donne sur la demande, pour tous, et sur un signataire, pour lui seul : le sien l’emporte, clé par clé.

delivery Ce qui se passe
email (par défaut) Tano envoie l’invitation et les relances, par courriel ou par SMS.
none Tano n’écrit pas au signataire. Vous obtenez son lien avec POST /v1/signature-requests/{id}/signers/{signer_id}/link et le lui remettez : dans votre application, par votre propre messagerie, ou en affichant la signature dans votre page.

Avec none, le signataire est bien invité (notified, webhook signer.notified) : c’est le message qui ne part pas. Il ne reçoit pas de relance, automatique ou à la main. Le code à usage unique, lui, part toujours par la méthode choisie : c’est ce qui l’authentifie.

{
"name": "Bail — appartement Cocody",
"delivery": "none",
"signers": [
{"given_name": "Aya", "family_name": "Koné", "email": "[email protected]", "auth_method": "otp_email"},
{"given_name": "Koffi", "family_name": "Yao", "phone": "+2250701021234", "auth_method": "otp_sms", "delivery": "email"}
]
}

Ici, Aya reçoit son lien de vous ; Koffi, de Tano.

Clé Remplace Au plus
invitation_subject L’objet du courriel d’invitation. 200 caractères
invitation_body La phrase d’introduction de l’invitation. 2 000 caractères
reminder_subject L’objet d’une relance. 200 caractères
reminder_body La phrase d’introduction d’une relance. 2 000 caractères

{organisation}, {request} (le nom de la demande) et {given_name} (le prénom du signataire) y sont remplacés ; rien d’autre n’est interprété. Le lien, la date d’échéance et l’avertissement « ce lien est personnel » suivent toujours votre texte : il ne peut ni les faire oublier, ni faire passer le lien pour un autre. Par SMS, l’objet ne sert pas et le corps est coupé à 320 signes.

"custom_text": {
"invitation_subject": "Votre bail {request} est prêt",
"invitation_body": "Bonjour {given_name}, {organisation} vous invite à signer votre bail."
}

Les textes sont chiffrés avec les données de la demande : ils peuvent nommer quelqu’un.

Clé Quand
success Après sa signature.
decline Après son refus.
error Quand la demande n’est plus signable : expirée, annulée, déjà close.

Les adresses sont en HTTPS (ou http://localhost, pour développer), sans fragment, 500 caractères au plus ; sinon la demande est refusée avec invalid_redirect_url. La page de signature montre l’issue, puis renvoie le signataire au bout de deux secondes environ, en ajoutant à l’adresse :

https://agence.example/merci?signature_request_id=sr_…&signer_id=ss_…&reference=BAIL-2026-118

Ne prenez pas ce retour pour une preuve : quelqu’un peut l’ouvrir à la main. L’état de la demande se lit avec GET /v1/signature-requests/{id}, ou par le webhook signer.signed. Affichée dans votre page, la page de signature ne redirige jamais.

Une demande peut porter des documents qui ne regardent pas tout le monde : la caution signe l’acte de caution, pas l’état des lieux. Ce réglage-là est propre à chaque signataire : hidden_documents donne la liste des documents qu’il ne voit pas, par leur rang dans documents, à partir de 0 — comme fields[].document :

{
"documents": [
{"filename": "bail.pdf", "content": "…"},
{"filename": "etat-des-lieux.pdf", "content": "…"},
{"filename": "caution.pdf", "content": "…"}
],
"signers": [
{"given_name": "Aya", "family_name": "Koné", "email": "[email protected]", "auth_method": "otp_email"},
{"given_name": "Awa", "family_name": "Traoré", "email": "[email protected]", "auth_method": "otp_email", "hidden_documents": [1]}
]
}

Ici, Awa ne voit ni ne signe l’état des lieux ; Aya voit les trois documents.

Règle
Les rangs Ceux de documents de la demande, sans doublon ; sinon invalid_request sur signers[i].hidden_documents.
Au moins un document Un signataire ou un approbateur voit au moins un document : on ne consent pas à ce qu’on n’a pas vu. Un destinataire en copie (viewer) peut n’en voir aucun. Sinon, invalid_request.
Pas de champ Un champ sur un document caché à son signataire — placé par coordonnées ou par ancre — est refusé avec invalid_field.

En lecture, signers[].hidden_documents rend les identifiants des documents (sd_…), plus leurs rangs :

{"id": "ss_…", "position": 2, "role": "signer", "status": "pending", "hidden_documents": ["sd_…"]}

Sur la page de signature, un document caché n’est pas listé : le signataire ne lit, ne remplit et ne signe que les autres. Il ne peut pas non plus le télécharger, même en connaissant son identifiant : la page répond document_not_found.

Le fichier de preuve dit ce que chacun a eu sous les yeux : pour un signataire qui avait des documents cachés, une ligne « Documents présentés : 1, 3 » suit son nom, avec les numéros des documents qu’il a vus, à partir de 1. Sans document caché, pas de ligne : il a tout vu.

Dans un modèle, les documents cachés se règlent sur le rôle, de la même façon.

POST /v1/signature-requests/{id}/signers/{signer_id}/remind

Tano renvoie l’invitation au signataire, avec le texte de relance s’il y en a un et un nouveau lien, qui remplace le précédent. La réponse est la demande, avec reminded_at sur le signataire. Une relance à la main ne compte pas dans les relances automatiques.

Refus Pourquoi
reminder_too_soon Moins d’une heure depuis l’invitation ou la relance précédente.
signer_not_remindable Le signataire est en delivery: none : remettez-lui un nouveau lien vous-même.
signer_not_invited Ce n’est pas encore son tour, ou il a déjà répondu.

Les relances automatiques (reminder_days) sont décrites dans Demandes et signataires.

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