Du compte au PDF scellé, en bac à sable : aucun crédit consommé, aucune valeur juridique, exactement le même code qu’en production.

1. Un compte, une clé

Créez un compte (lien magique, pas de mot de passe). Dans Clés API, créez une clé en mode bac à sable avec envelopes:read et envelopes:write. La clé n’est affichée qu’une fois : seul son hash est stocké.

Note

Les clés sk_test_ ne consomment jamais de crédit ; les emails partent avec la mention [TEST]. Les clés sk_live_ facturent à la complétion.

2. Envoyer une enveloppe

Mettez votre propre adresse en signataire pour recevoir le lien.

●bash

curl -X POST https://preprod-app.signatik.com/api/v1/envelopes \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contrat de mission n°1234",
    "send": true,
    "signature_level": "simple",
    "documents": [{ "name": "contrat.pdf", "pdf_base64": "JVBERi0…" }],
    "signers":   [{ "email": "jean.dupont@exemple.fr", "name": "Jean Dupont" }]
  }'

# → 201 { "id": "env_…", "status": "sent",
#         "signers": [{ "sign_url": "https://preprod-app.signatik.com/sign/…" }] }

État attendu : réponse 201, status: "sent", un sign_url par signataire, et un email dans votre boîte.

3. Signer

Le lien mène à la page hébergée : parcours obligatoire du document, code à usage unique reçu par email (dix minutes, cinq tentatives), signature dessinée ou tapée. Chaque étape entre dans le journal chaîné.

4. Recevoir la complétion

Dans Webhooks, ajoutez une URL HTTPS. Le secret n’est affiché qu’une fois. Après scellement, vous recevez envelope.completed :

●POST https://votre-app.fr/webhooks/esign

X-Esign-Event: envelope.completed
X-Esign-Signature: sha256=3f1a…

{ "type": "envelope.completed",
  "envelope": { "id": "env_…", "name": "Contrat de mission n°1234", "status": "completed",
                "completed_at": "2026-09-02T14:33:07Z",
                "documents": [{ "name": "contrat.pdf", "sealed_download_url": "https://…" }],
                "evidence_download_url": "https://…" } }

État attendu : votre endpoint répond 2xx ; sinon, 8 nouvelles tentatives avec attente exponentielle.

5. Vérifier

●bash

sha256sum contrat-scelle.pdf
curl -X POST https://preprod-app.signatik.com/api/v1/verify -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" -d '{ "sha256": "<empreinte>" }'

État attendu : known: true, matches: "sealed_document", chain_valid: true. Cet endpoint fonctionne même après purge des documents.

Passer en production

Créez une clé sk_live_ ; les 5 crédits offerts couvrent vos premiers envois réels.
Renseignez raison sociale et SIREN dans « Organisation » : ils figurent dans les dossiers de preuve et les factures.
Choisissez la rétention (1 à 90 jours) : après, les PDF sont purgés, la preuve reste.

Authentification et bac à sable →Guide : signature avancée →