Le bac à sable de la signature
Une demande de signature ou un cachet créé avec une clé tano_sandbox_… suit les chemins de la
production : mêmes états, mêmes webhooks, mêmes erreurs. Quatre choses changent :
| En production | En bac à sable |
|---|---|
| Les invitations et les codes partent par courriel ou par SMS. | Aucun message ne part. Le lien s’obtient par l’API. |
| Le code à usage unique est envoyé au signataire. | Le code est toujours 000000. |
| La demande complétée et le document scellé sont facturés. | Rien n’est facturé, ni décompté de votre quota. |
| Le document est scellé par Tano ou par votre organisation. | Le document est un spécimen : bandeau rouge « SPÉCIMEN » sur chaque page, aucun cachet. |
Un document d’essai qui porterait un vrai cachet aurait l’air valable : il n’en porte jamais.
POST /v1/verify le dit d’ailleurs non signé ("signed": false).
Reconnaître un essai
Section intitulée « Reconnaître un essai »- Le corps d’une demande ou d’un cachet porte
"environment": "sandbox". - Les téléchargements (document, fichier de preuve, document scellé) portent l’en-tête
X-Tano-Sandbox: true. - Le fichier de preuve est marqué « SPÉCIMEN », comme le document.
- La page de signature annonce qu’il s’agit d’un essai.
Chaque clé ne voit que son environnement : une demande de bac à sable lue, annulée ou
téléchargée avec une clé de production répond 404
(signature_request_not_found), et l’inverse aussi.
Signer soi-même sur la vraie page
Section intitulée « Signer soi-même sur la vraie page »- Créez la demande avec votre clé de bac à sable, comme dans Faire signer un document. Les adresses et numéros des signataires ne reçoivent rien : mettez-y ce que vous voulez, au bon format.
- Demandez le lien du premier signataire :
POST /v1/signature-requests/{id}/signers/{signer_id}/link. - Ouvrez le lien, demandez un code et saisissez
000000, puis signez.
Simuler la réponse d’un signataire
Section intitulée « Simuler la réponse d’un signataire »Pour éprouver vos webhooks et votre traitement de fin de demande sans ouvrir la page :
POST /v1/sandbox/signature-requests/{id}/signers/{signer_id}/signPOST /v1/sandbox/signature-requests/{id}/signers/{signer_id}/declineLes deux requêtes sont signées. Tano rejoue le chemin réel : ouverture du document, code connu, consentement, puis signature ou refus. Les champs libres reçoivent « Bac à sable », les cases sont cochées. La réponse donne l’état de la demande :
{"id": "sr_01J9ZK7B2M4Q8R6T0V3W5X7Y9Z", "status": "ongoing"}Après la signature du dernier signataire, status vaut completed, et signer.signed puis
signature_request.completed partent vers vos webhooks. Un refus simulé arrête la demande
(declined), comme un vrai.
Seul un signataire invité se simule : en ordre séquentiel, faites signer le premier avant le
second (signer_not_invited sinon). Ces routes sont refusées à une
clé qui n’est pas de bac à sable (sandbox_only).
Un essai complet
Section intitulée « Un essai complet »# 1. Créer et envoyer la demande (clé tano_sandbox_…)POST /v1/signature-requests → 201, status: ongoing, environment: sandbox
# 2. Faire signer chaque signataire, dans l'ordrePOST /v1/sandbox/signature-requests/{id}/signers/{premier}/sign → status: ongoingPOST /v1/sandbox/signature-requests/{id}/signers/{second}/sign → status: completed
# 3. Recevoir signer.signed puis signature_request.completed, puis télécharger le spécimenGET /v1/signature-requests/{id}/documents/{document_id}/download → X-Tano-Sandbox: trueGET /v1/signature-requests/{id}/audit-trail → X-Tano-Sandbox: trueLe bac à sable du cachet est décrit avec le scellement, celui des dossiers dans Vérification d’identité, et la forme des clés dans Clés et environnements.
© 2026 Qalebasse · Tano, plateforme de confiance numériquetano.africaDemander un accès[email protected]