Aller au contenu

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

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

  1. 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.
  2. Demandez le lien du premier signataire : POST /v1/signature-requests/{id}/signers/{signer_id}/link.
  3. Ouvrez le lien, demandez un code et saisissez 000000, puis signez.

Pour éprouver vos webhooks et votre traitement de fin de demande sans ouvrir la page :

POST /v1/sandbox/signature-requests/{id}/signers/{signer_id}/sign
POST /v1/sandbox/signature-requests/{id}/signers/{signer_id}/decline

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

# 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'ordre
POST /v1/sandbox/signature-requests/{id}/signers/{premier}/sign → status: ongoing
POST /v1/sandbox/signature-requests/{id}/signers/{second}/sign → status: completed
# 3. Recevoir signer.signed puis signature_request.completed, puis télécharger le spécimen
GET /v1/signature-requests/{id}/documents/{document_id}/download → X-Tano-Sandbox: true
GET /v1/signature-requests/{id}/audit-trail → X-Tano-Sandbox: true

Le 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]