Expédiez rapidement votre premier flux de signature électronique avec Firma : un guide de démarrage pour les développeurs

Vous êtes développeur et disposez déjà de votre compte Firma ? Parfait. Ce guide vous accompagne de l'obtention de la clé API à l'intégration d'un parcours de signature en production. Nous irons droit au but, en nous concentrant sur les décisions clés et en proposant des liens directs vers les exemples de code de la documentation.

Vous recherchez le guide non technique ? Cliquez ici.

Ce que vous allez faire

1. Modéliser l'isolation des clients grâce aux espaces de travail (Workspaces)

2. Créer un modèle (Template) réutilisable

3. Envoyer une demande de signature (Signing Request)

4. Intégrer l'expérience de signature ou configurer une redirection

5. Tout suivre grâce aux Webhooks

La tarification est simple. C'est €0,049 par enveloppe, testez avec de vrais documents, gratuit pour vous permettre de créer et tester de bout en bout.

Prérequis

Clé API d'entreprise ou d'espace de travail depuis votre tableau de bord

• Un document PDF à transformer en modèle

• Un serveur pour exécuter le code de génération de JWT et gérer les webhooks

Besoin d'un rappel sur le flux global ? Consultez 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 cloisonné avec des modèles, des documents et un suivi d'utilisation isolés. C'est le moyen le plus propre de concevoir une architecture multi-locataire (multi-tenant) de type SaaS sans aucune fuite de données entre vos clients.

Créer un espace de travail
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Créer un espace de travail
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Créer un espace de travail
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Pratique : les paramètres de l'espace de travail, tels que le modèle d'e-mail et le fuseau horaire, sont configurables par espace de travail.

Guide des paramètres de l'espace de travail
https://docs.firma.dev/guides/workspace-settings

Guide des paramètres de l'espace de travail
https://docs.firma.dev/guides/workspace-settings

Guide des paramètres de l'espace de travail
https://docs.firma.dev/guides/workspace-settings

2) Créer un modèle réutilisable

Les modèles contiennent le PDF ainsi que les rôles et les champs, ce qui vous permet d'envoyer le même document à de nombreuses reprises avec des destinataires différents.

Créer un modèle (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Créer un modèle (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Créer un modèle (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Option A : Permettre aux utilisateurs de concevoir des modèles dans votre application

Intégrez l'éditeur de modèles à l'aide d'un jeton JWT à courte durée de vie.

Éditeur de modèles intégrable (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Éditeur de modèles intégrable (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Éditeur de modèles intégrable (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Générez le jeton côté serveur.

Générer un jeton JWT pour l'intégration de modèles
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Générer un jeton JWT pour l'intégration de modèles
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

Générer un jeton JWT pour l'intégration de modèles
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Créer la demande de signature

Transformez votre modèle en une transaction active. Vous pouvez également la créer à partir d'un simple PDF si vous préférez. Notre référence API détaille les destinataires, les champs, les rappels et les règles de validation.

Créer une demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Créer une demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Créer une demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Optionnel : laisser vos utilisateurs professionnels remplir les détails et envoyer depuis votre interface utilisateur

Intégrez l'éditeur de demandes de signature à l'aide d'un jeton JWT d'une validité de 7 jours.

Éditeur de demandes de signature intégrable (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Éditeur de demandes de signature intégrable (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Éditeur de demandes de signature intégrable (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Générez le jeton JWT côté serveur.

Générer un jeton JWT pour l'éditeur de demandes de signature
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Générer un jeton JWT pour l'éditeur de demandes de signature
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

Générer un jeton JWT pour l'éditeur de demandes de signature
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Envoyer la demande de signature

Dès que vous êtes prêt, déclenchez l'envoi.

Envoyer la demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Envoyer la demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

Envoyer la demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

5) Proposer la signature directement dans votre produit ou via redirection

Signature intégrée

Chaque destinataire signe via une URL unique construite selon ce modèle :

https://app.firma.dev/signing/{signing_request_user_id}.

Signature intégrée (modèle d'iframe et conseils)
https://docs.firma.dev/guides/embeddable-signing

Signature intégrée (modèle d'iframe et conseils)
https://docs.firma.dev/guides/embeddable-signing

Signature intégrée (modèle d'iframe et conseils)
https://docs.firma.dev/guides/embeddable-signing

Vous récupérerez le signing_request_user_id via l'API.

Obtenir les utilisateurs de la demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Obtenir les utilisateurs de la demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Obtenir les utilisateurs de la demande de signature
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Signature par redirection

Alternativement, vous pouvez rediriger les destinataires vers l'interface de signature hébergée. Consultez le même guide ci-dessus pour plus de détails.

6) Tout suivre grâce aux webhooks

Restez à l'écoute des événements tels que création, envoi, consultation, signature et finalisation pour mettre à jour votre système en temps réel. Le guide aborde la vérification HMAC, la rotation des clés, les tentatives de renvoi et une checklist pour la mise en production.

Guide des webhooks
https://docs.firma.dev/guides/webhooks

Guide des webhooks
https://docs.firma.dev/guides/webhooks

Guide des webhooks
https://docs.firma.dev/guides/webhooks

Créer un webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Créer un webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Créer un webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Notes rapides sur l'architecture

• Génération des JWTs : Générez-les côté serveur. Les jetons de l'éditeur de modèles ont une courte durée de vie ; ceux de l'éditeur de demandes de signature expirent après 7 jours.

• Espaces de travail pour le SaaS : Assurez un cloisonnement total de vos clients. Vos équipes opérationnelles continuent de travailler depuis une API unique.

• Tarification et déploiement : Démarrez avec les enveloppes gratuites incluses, puis passez en production. Aucun minimum requis. €0,049 par enveloppe.

Étapes suivantes

1. Configurez votre premier espace de travail

2. Ajoutez un modèle

3. Envoyez votre première demande de signature

4. Choisissez entre intégration ou redirection

5. Connectez vos webhooks

👉 Obtenir la clé API - aucune carte de crédit requise.