Aller au contenu

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

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.

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.

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.

Une adresse refusée (signer.notification_failed), un numéro qui a changé :

PATCH /v1/signature-requests/{id}/signers/{signer_id}
{"email": "[email protected]"}
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.

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

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