Guides
Expédiez rapidement votre premier flux de signature électronique avec Firma : un guide de démarrage pour les développeurs
Êtes-vous développeur et avez-vous déjà votre compte Firma ? Parfait. Ce guide vous fait passer de « clé API en main » à un flux de signature intégré en production. Nous resterons concis, nous nous concentrerons sur les décisions et vous renverrons directement vers des extraits de code prêts à l’emploi dans la documentation.
Vous cherchez le guide non technique ? Cliquez ici.
Ce que vous allez faire
Modéliser l’isolation des clients avec les espaces de travail
Créer un modèle réutilisable
Envoyer une demande de signature
Intégrer l’expérience de signature ou rediriger
Tout suivre avec les webhooks
La tarification est simple. C’est €0.029 par enveloppe, avec vos 25 premières enveloppes gratuites afin que vous puissiez développer et tester de bout en bout.
Prérequis
Clé API de société ou d’espace de travail depuis votre tableau de bord
Un PDF que vous pouvez transformer en template
Un environnement pour exécuter du code serveur pour la génération de JWT et les webhooks
Besoin d’un rappel sur le flux global ? Consultez le Guide de configuration complet.
1) Créez un espace de travail pour chaque client
Les espaces de travail offrent à chaque client un espace privé et cloisonné, avec des modèles, des documents et une utilisation isolés. C’est la façon la plus propre de mettre en place une séparation multi-locataire de type SaaS sans fuite de données entre les clients.
Utile : les paramètres de l’espace de travail comme le texte des e-mails et le fuseau horaire sont propres à chaque espace de travail.
2) Créez un modèle réutilisable
Les modèles contiennent le PDF ainsi que les rôles et les champs, afin que vous puissiez envoyer le même document plusieurs fois à différents destinataires.
Option A : laissez les utilisateurs concevoir des modèles dans votre application
Intégrez l’éditeur de modèles avec un JWT à courte durée de vie.
Générez le jeton côté serveur.
3) Créez la demande de signature
Transformez votre modèle en transaction en production. Vous pouvez aussi créer à partir d’un PDF brut si vous préférez. La référence couvre les destinataires, les champs, les rappels et les règles de validation.
Facultatif : laissez les utilisateurs métier renseigner les détails et envoyer depuis votre interface
Intégrez l’éditeur de demande de signature avec un JWT valable 7 jours.
Générez le JWT côté serveur.
4) Envoyez la demande de signature
Quand vous êtes prêt, déclenchez l’envoi.
5) Proposez la signature dans votre produit ou via redirection
Signature intégrée
Chaque destinataire signe via une URL unique qui suit ce format :
https://app.firma.dev/signing/{signing_request_user_id}.
Vous récupérerez le signing_request_user_id depuis l’API.
Signature par redirection
Sinon, vous pouvez envoyer les destinataires vers l’interface de signature hébergée. Consultez le même guide ci-dessus pour plus de détails.
6) Suivez tout avec les webhooks
Écoutez les événements tels que créé, envoyé, consulté, signé et terminé afin de mettre à jour votre système en temps réel. Le guide inclut la vérification HMAC, la rotation, les tentatives de reprise et une liste de contrôle de production.
Notes rapides sur l’architecture
JWT. Générez-les côté serveur. Les jetons de l’éditeur de modèles sont à courte durée de vie ; ceux de l’éditeur de demande de signature expirent après 7 jours.
Espaces de travail pour SaaS. Gardez les clients totalement cloisonnés. Vos opérateurs travaillent toujours à partir d’une seule API.
Tarification et mise en production. Commencez avec les enveloppes gratuites incluses, puis passez en production. Aucun minimum. €0,029 par enveloppe.
Et ensuite ?
Connectez votre premier espace de travail
Ajoutez un modèle
Envoyez votre première demande
Choisissez l’intégration ou la redirection
Mettez en place les webhooks
👉 Obtenir la clé API - aucune carte bancaire requise.
Articles connexes
Notre plateforme est conçue pour permettre aux entreprises de toutes tailles de travailler plus intelligemment et d'atteindre leurs objectifs avec confiance.
