Guides
Expédiez rapidement votre premier flux de signature électronique avec Firma : un guide de démarrage pour les développeurs
Êtes-vous un développeur et avez-vous déjà votre compte Firma ? Parfait. Ce guide vous accompagne de « clé API en main » à un flux de signature intégré actif. Nous allons rester concis, nous concentrer sur les décisions, et vous lier directement à des extraits fonctionnels dans la documentation.
Vous recherchez le guide non technique ? Cliquez ici.
Ce que vous allez faire
Modéliser l'isolation client avec des Workspaces
Créer un Modèle réutilisable
Envoyer une Demande de signature
Intégrer l'expérience de signature ou rediriger
Tout suivre avec des Webhooks
La tarification est simple. C’est €0,029 par enveloppe, avec vos 25 premières enveloppes gratuites pour que vous puissiez construire et tester de bout en bout.
Prérequis
Clé API de l'entreprise ou de l'espace de travail depuis votre tableau de bord
Un PDF que vous pouvez transformer en modèle
Un endroit pour exécuter du code serveur pour la génération JWT et les webhooks
Besoin d'un rafraîchissement sur le flux global ? Voir le Guide d'installation complet.
1) Créer un espace de travail pour chaque client
Les espaces de travail offrent à chaque client un espace privé et partagé avec des modèles, des documents et une utilisation isolés. C’est la manière la plus propre de créer une séparation multi-locataires de style SaaS sans fuite de données entre les clients.
Utile : les paramètres de l'espace de travail, comme la copie des e-mails et le fuseau horaire, sont par espace de travail.
2) Créer un modèle réutilisable
Les modèles contiennent le PDF ainsi que des rôles et des champs, de sorte que vous pouvez envoyer le même document plusieurs fois avec différents destinataires.
Option A : Permettre aux utilisateurs de concevoir des modèles dans votre application
Intégrer l'éditeur de modèles avec un JWT de courte durée.
Générez le jeton côté serveur.
3) Créer la demande de signature
Transformez votre modèle en transaction active. Vous pouvez également créer à partir d'un PDF brut si vous préférez. La référence traite les destinataires, les champs, les rappels et les règles de validation.
Optionnel : permettre aux utilisateurs professionnels de remplir les détails et d'envoyer depuis votre interface
Intégrer l'éditeur de demande de signature avec un JWT de 7 jours.
Générez le JWT côté serveur.
4) Envoyer la demande de signature
Lorsque vous êtes prêt, déclenchez l'envoi.
5) Livrer la signature dans votre produit ou via redirection
Signature intégrée
Chaque destinataire signe à une URL unique qui suit ce schéma :
https://app.firma.dev/signing/{signing_request_user_id}.
Vous récupérerez le signing_request_user_id de l'API.
Redirection de signature
Alternativement, vous pouvez envoyer les destinataires vers l'interface de signature hébergée. Voir le même guide ci-dessus pour plus de détails.
6) Tout suivre avec les webhooks
Écoutez les événements tels que créé, envoyé, visualisé, signé et complété pour mettre à jour votre système en temps réel. Le guide inclut la vérification HMAC, la rotation, les réessais, et un checklist de production.
Notes rapides sur l'architecture
JWT. Générez-les côté serveur. Les jetons de l'éditeur de modèle sont de courte durée ; les jetons de l'éditeur de demande de signature expirent après 7 jours.
Espaces de travail pour SaaS. Gardez les clients totalement compartimentés. Vos opérateurs travaillent toujours à partir d'une seule API.
Tarification et déploiement. Démarrez avec les enveloppes gratuites incluses, puis passez en production. Pas de minimum. €0,029 par enveloppe.
Quelle est la prochaine étape ?
Connecter votre premier espace de travail
Ajouter un modèle
Envoyer votre première demande
Choisir intégration ou redirection
Connecter les webhooks
👉 Obtenir la clé API - sans carte de crédit 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.
