Aller au contenu
signatik
Créer un compte

Signature simple, de bout en bout

Devis, bons de commande, PV, relevés d’heures : eIDAS niveau 1, code à usage unique par email, preuve complète.

1. Créer l’enveloppe avec des champs placés

Coordonnées en pourcentage de la page, origine en haut à gauche. Un champ date sans valeur est rempli à la signature.

curl -X POST https://preprod.signatik.com/api/v1/envelopes -H "Authorization: Bearer sk_live_…" -H "Content-Type: application/json" -d '{
  "name": "Devis n°2026-0912", "send": true, "expires_in_days": 15, "retention_days": 30,
  "documents": [{ "name": "devis.pdf", "pdf_base64": "JVBERi0…" }],
  "signers": [
    { "email": "jean.dupont@exemple.fr", "name": "Jean Dupont", "order": 1 },
    { "email": "marie.leroy@exemple.fr", "name": "Marie Leroy", "order": 2 }
  ],
  "fields": [
    { "document_index": 0, "signer_index": 0, "type": "signature", "page": 1, "x": 10, "y": 82, "width": 35, "height": 8 },
    { "document_index": 0, "signer_index": 0, "type": "date",      "page": 1, "x": 10, "y": 91, "width": 20, "height": 4 },
    { "document_index": 0, "signer_index": 1, "type": "signature", "page": 1, "x": 55, "y": 82, "width": 35, "height": 8 }
  ]
}'

order : 0 = parallèle (tous notifiés en même temps) ; 1, 2, 3… = séquentiel (le 2 est notifié quand le 1 a signé). Jusqu’à 5 PDF de 10 Mo et 10 signataires par enveloppe.

2. Suivre

curl https://preprod.signatik.com/api/v1/envelopes/env_… -H "Authorization: Bearer sk_live_…"
# signers[].status : pending → notified → signed ; envelope.status : sent → completed

Ou attendez envelope.completed par webhook. Pour relancer un signataire, la console propose une relance (une par dix minutes) ; par l’API, renvoyez-lui son sign_url par votre propre canal.

3. Télécharger

Une fois sealed_at renseigné, chaque document expose sealed_download_url et l’enveloppe evidence_download_url — liens valables une heure, à régénérer par un nouveau GET. Le PDF scellé porte les champs aplatis et le cachet PAdES ; le dossier de preuve, la chronologie chaînée.

4. Rétention et purge

Note
retention_days (1 à 90, défaut : réglage de l’organisation) court à partir de la complétion. Passé ce délai, les PDF sont purgés (documents_available: false, liens null) ; empreintes, journal et jetons restent, et POST /verify continue de répondre. Téléchargez et conservez les PDF de votre côté : vous en êtes propriétaire.

5. Annuler, expirer

POST /envelopes/:id/cancel en draft ou sent : liens désactivés (410), crédits réservés rendus. L’expiration (expires_in_days, 1 à 90) produit envelope.expired et rend aussi les crédits.

Référence : enveloppes →Guide : signature avancée →