Gérer une demande en cours
Une demande envoyée ne change plus de documents ni de champs : ce qui a été montré au signataire reste ce qu’il signe. Le reste se gère en cours de route, sans annuler la demande pour la refaire — et sans perdre ce qui est déjà signé.
Vos métadonnées
Section intitulée « Vos métadonnées »Attachez à la demande ce qui vous permet de la retrouver chez vous : un numéro de dossier, un identifiant de client, un canal.
"metadata": {"dossier": "D-2026-0042", "agence": "cocody"}| Règle | |
|---|---|
| Clés | 20 au plus ; lettres, chiffres, ., -, _ ; 40 signes au plus. |
| Valeurs | Un texte ou un nombre, 500 caractères au plus ; 4 Ko en tout. |
| Données personnelles | Refusées. Elles voyagent dans les webhooks, qui n’en portent jamais : une valeur qui ressemble à une adresse, un numéro de téléphone ou de pièce est refusée avec invalid_request sur metadata. Mettez-y un identifiant. |
Elles sont rendues par l’API (metadata) et jointes à chaque webhook de la demande, dans
object, avec votre référence et l’environnement :
{ "type": "signer.signed", "object": { "type": "signature_request", "id": "sr_…", "reference": "BAIL-2026-118", "environment": "prod", "metadata": {"dossier": "D-2026-0042", "agence": "cocody"} }, "data": {"signer_id": "ss_…", "reference": "BAIL-2026-118"}}Pour les changer, à tout moment :
PATCH /v1/signature-requests/{id}
{"metadata": {"agence": null, "canal": "web"}}Les clés données remplacent, null retire une clé, les autres restent.
Reporter l’échéance
Section intitulée « Reporter l’échéance »PATCH /v1/signature-requests/{id}
{"expires_at": "2027-01-10T23:59:00+00:00"}Sur une demande en cours seulement. La nouvelle échéance n’est pas dans le passé, et la demande ne vit pas plus de 90 jours après son envoi. Les liens déjà envoyés valent jusqu’à la nouvelle date : personne n’a rien à redemander.
Faire repartir une demande expirée
Section intitulée « Faire repartir une demande expirée »POST /v1/signature-requests/{id}/reactivate
{"expires_in_days": 30}La demande redevient ongoing, avec une nouvelle échéance de 1 à 90 jours. Ce qui est signé le
reste. Ceux qui avaient été invités et n’avaient pas répondu reçoivent un lien neuf — les
anciens ont été révoqués à l’expiration —, par Tano s’il leur écrit (delivery). Vous recevez
signature_request.reactivated, et la réponse porte reactivated_at.
Seule une demande expirée se réactive ; une demande annulée, refusée ou complétée, non.
Corriger un signataire
Section intitulée « Corriger un signataire »Une adresse refusée (signer.notification_failed), un numéro qui a changé :
PATCH /v1/signature-requests/{id}/signers/{signer_id}
| Champ | |
|---|---|
given_name, family_name |
Son nom. |
email, phone |
Ses coordonnées ; le numéro au format international. |
auth_method |
otp_email ou otp_sms ; la coordonnée correspondante doit exister. |
Possible tant qu’il n’a pas répondu (signer_not_editable
sinon). S’il était déjà invité, il repart de l’invitation vers ses nouvelles coordonnées : un
nouveau lien lui part, l’ancien cesse de valoir, et un code envoyé à l’ancienne adresse
n’authentifie plus personne. Vous recevez signer.updated.
Suivre ce qui se passe
Section intitulée « Suivre ce qui se passe »| Événement | Quand |
|---|---|
signer.notification_failed |
Une invitation ou une relance n’a pas pu être remise : data.channel, data.failure (email_refused, sms_refused, provider_unreachable). Corrigez le signataire. |
signer.reminded |
Un signataire est relancé, automatiquement ou à la main (data.manual). |
signer.updated |
Ses coordonnées ont été corrigées. |
signature_request.reactivated |
Une demande expirée repart. |
Le catalogue complet est dans les événements.
Étapes suivantes
Section intitulée « Étapes suivantes »- Le parcours du signataire : envoi, textes, relances à la main.
- La référence de la signature.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]