API d'intégration · bêta sur invitation

Faites signer depuis votre logiciel. Vos utilisateurs ne quittent pas votre tunnel.

Un appel serveur à serveur crée la demande, place les champs et envoie le document. Vos utilisateurs signent où vous le décidez : par e-mail comme aujourd'hui, ou sur une URL que vous ouvrez dans votre propre parcours. Vous apprenez l'issue par un webhook signé, sans surveiller aucune boîte mail.

Bêta sur invitation · premier mois offert · un interlocuteur direct

Le parcours, en trois temps Bêta
  1. 1
    POST /api/v1/requests Votre serveur envoie le PDF, les signataires et les champs. Un seul appel, réponse immédiate.
  2. 2
    Votre utilisateur signe Invitation par e-mail, ou URL de signature rendue dans la réponse — vous l'ouvrez dans votre parcours.
  3. 3
    request.completed Un webhook signé arrive sur votre serveur, avec le même objet que l'API vous rendrait.
Un seul appel
pour envoyer un document
Signature avancée eIDAS,
horodatage RFC 3161
Webhook signé
en HMAC-SHA256
Signataires illimités
sur chaque document
L'appel

Un seul appel, et le document part signer.

Le corps porte le PDF, les signataires et l'emplacement de leurs champs. Rien à créer d'avance, rien à téléverser en deux temps : la demande est créée, les champs posés et l'envoi déclenché dans la même requête.

La requêtevotre serveur → EasyParafe
POST /api/v1/requests HTTP/1.1
Host: easyparafe.fr
Authorization: Bearer pf_live_7f3a…
Idempotency-Key: 8f14e45f-1234-4c1b-9a5e-6d2f0b7c3e91
Content-Type: application/json

{
  "title": "Contrat de bail — 12 rue des Lilas",
  "document": "JVBERi0xLjQKJcfs…",
  "notify": false,
  "redirect_url": "https://mon-logiciel.fr/dossiers/4821/signe",
  "metadata": { "dossier": "4821" },
  "signers": [
    {
      "name": "Camille Durand",
      "email": "camille@exemple.fr",
      "fields": [
        { "kind": "signature", "page": 0, "x": 0.62, "y": 0.78, "w": 0.25, "h": 0.08 },
        { "kind": "date",      "page": 0, "x": 0.62, "y": 0.88, "w": 0.20, "h": 0.03 }
      ]
    }
  ]
}
La réponse201 Created
{
  "id": "9f1c8a2e-4b77-4e0d-9a1c-2f5b8d3e6a04",
  "status": "sent",
  "created_at": "2026-08-12T14:32:07+02:00",
  "metadata": { "dossier": "4821" },
  "signers": [
    {
      "order": 0,
      "name": "Camille Durand",
      "email": "camille@exemple.fr",
      "status": "pending",
      "sign_url": "https://easyparafe.fr/sign/9c1f…/"
    }
  ]
}
Le webhookEasyParafe → votre serveur
POST /hooks/easyparafe HTTP/1.1
X-EasyParafe-Event: request.completed
X-EasyParafe-Delivery: 3b1f8c2e-…
X-EasyParafe-Signature: t=1755001234,v1=9a7c…

{
  "event": "request.completed",
  "id": "9f1c8a2e-4b77-4e0d-9a1c-2f5b8d3e6a04",
  "status": "completed",
  "metadata": { "dossier": "4821" }
}
Un timeout ne signe rien deux fois

L'en-tête Idempotency-Key est exigé sur l'envoi. Rejouer la même requête rend la même réponse, sans créer de seconde demande ni consommer une seconde unité.

Deux façons d'amener le signataire

Avec notify: true, l'invitation part par e-mail comme aujourd'hui. Avec notify: false, aucun e-mail n'est envoyé et l'URL de signature vous est rendue : vous l'ouvrez dans votre propre parcours.

Le webhook est signé, et vérifiable

Chaque livraison porte un horodatage et un HMAC-SHA256 du corps, calculé avec le secret de votre point de réception. Trois événements : signer.signed, request.completed, request.declined.

Le tarif

Deux paliers, et le compteur ne coupe pas.

L'unité décomptée est le document envoyé, jamais la signature : un bail signé par quatre personnes compte pour un document. Les deux paliers donnent la même signature avancée, le même dossier de preuve et les mêmes webhooks.

Intégration Découverte
39 €
par mois
ou 390 € par an — deux mois offerts
  • 100 documents par mois, remis à zéro le 1er
  • Signataires illimités sur chaque document
  • Signature avancée eIDAS, horodatée RFC 3161
  • Dossier de preuve à chaque signature
  • Webhooks signés et clés d'API
Demander un accès

Premier mois offert, le temps de brancher votre intégration

Le palier des éditeurs
Intégration
99 €
par mois
ou 990 € par an — deux mois offerts
  • 500 documents par mois, remis à zéro le 1er
  • Signataires illimités sur chaque document
  • Signature avancée eIDAS, horodatée RFC 3161
  • Dossier de preuve à chaque signature
  • Accompagnement direct pendant l'intégration
Demander un accès

Premier mois offert, le temps de brancher votre intégration

500 documents par mois, pas par an.

Les forfaits d'API comparables du marché annoncent leur volume inclus à l'année — de l'ordre de 500 signatures pour douze mois — pour un abonnement mensuel supérieur. Et ce qui y est inclus est la signature simple : l'avancée, celle qu'EasyParafe produit en standard, y est facturée en supplément, à l'acte.

Ici, le volume se compte au mois, la signature avancée est le standard, et les signataires ne sont pas facturés à l'unité. C'est ce qui explique l'écart de prix : il n'y a ni siège à payer, ni niveau de signature à racheter.

Relevé public des grilles d'éditeurs, août 2026.

Prix nets, pour un usage professionnel — TVA non applicable, art. 293 B du CGI. Le dépassement ne coupe rien : nous vous prévenons et nous en parlons — une intégration arrêtée en production, c'est votre client qui s'arrête. Au-delà de 2 000 documents par mois, écrivez-nous, le tarif se négocie.

Questions fréquentes

Ce qu'un intégrateur veut savoir avant de brancher.

Comment obtient-on une clé ?

L'API est en bêta sur invitation. Écrivez-nous en décrivant votre logiciel et le volume que vous prévoyez : nous ouvrons les accès un par un, et nous accompagnons chaque intégration. La clé vous est remise avec sa documentation, et le premier mois est offert, le temps de brancher.

Qu'est-ce qui est décompté, exactement ?

Le document envoyé. Un contrat signé par quatre personnes compte pour un document, pas pour quatre signatures : les signataires sont illimités, et les paraphes reportés sur toutes les pages ne comptent pour rien de plus. Le compteur repart au premier jour du mois.

Quel niveau de signature, et que verra mon client dans son lecteur PDF ?

Une signature électronique avancée (AES) au sens du règlement eIDAS : liée au signataire de manière univoque, permettant de l'identifier, et rendant détectable toute modification postérieure du document. Le fichier est scellé et horodaté par une autorité tierce (jeton RFC 3161), et un dossier de preuve accompagne chaque signature.

Une précision que nous préférons écrire ici plutôt que vous laisser la découvrir : le certificat de signature est celui de la plateforme, et il n'est pas encore inscrit dans les listes de confiance des lecteurs de PDF. Adobe Reader affiche donc un avertissement de validité tant que ce certificat n'y est pas ajouté, alors même que le scellement et l'horodatage sont, eux, parfaitement vérifiables. L'entrée dans une chaîne de confiance reconnue est à notre programme, et nous en parlons volontiers avant que vous ne vous engagiez.

Mon utilisateur peut-il rester dans mon parcours ?

Oui. Vous choisissez à chaque envoi : nous adressons l'invitation par e-mail comme pour n'importe quel document, ou nous n'envoyons rien et l'URL de signature vous est rendue dans la réponse — vous y redirigez votre utilisateur depuis votre propre écran.

À la fin, il voit sa confirmation de signature : c'est ce que nous vendons, une preuve, et elle doit s'afficher. Si vous nous donnez l'adresse de retour de votre site, un bouton l'y ramène.

Que se passe-t-il si je dépasse mon palier ?

Nous vous prévenons, et nous n'arrêtons rien. Une intégration coupée en production, ce n'est pas vous qui vous arrêtez : c'est votre client, au milieu de sa signature. Le dépassement se règle entre nous, par un avenant ou par le palier au-dessus.

Qu'est-ce qui n'est pas encore là ?

Le portail développeur, le bac à sable, la spécification générée et l'écran de gestion des clés en libre-service viendront ; ils ne sont pas là. En bêta, la documentation est écrite à la main et remise avec la clé, les accès sont ouverts par nos soins, et vous avez un interlocuteur direct plutôt qu'un formulaire de support.

C'est aussi pour cela que le premier mois est offert : il remplace le bac à sable.

Bêta sur invitation

Dites-nous ce que vous voulez faire signer.

Décrivez votre logiciel et le volume que vous prévoyez. Nous répondons sous 24 h ouvrées, et nous ouvrons les accès un par un — avec le premier mois offert.