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 emmène de « clé API en main » à un flux de signature intégré en direct. Nous garderons cela concis, nous concentrerons sur les décisions, et vous relierons directement à des extraits fonctionnels dans la documentation.

Vous cherchez le guide non technique ? Cliquez ici.

Ce que vous allez faire

1. Modéliser l'isolement des clients avec des espaces de travail

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

3. Envoyer une demande de signature

4. Intégrer l'expérience de signature ou rediriger

5. Tout suivre avec les 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 d'entreprise ou d'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 de JWT et les webhooks

Besoin d'une remise à niveau sur le flux global ? Consultez le Guide de configuration complet.

1) Créez un espace de travail pour chaque client

Les espaces de travail donnent à chaque client un espace privé et partitionné avec des modèles, des documents et une utilisation isolés. C'est la façon la plus propre de construire une séparation multi-locataires de style SaaS sans fuite de données entre les clients.

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Utile : les paramètres de l'espace de travail comme la copie des emails et le fuseau horaire sont par espace de travail.

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

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

Les modèles contiennent le PDF plus les rôles et les champs, pour que vous puissiez envoyer le même document plusieurs fois à différents destinataires.

Create Template (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

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.

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

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

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Créez la demande de signature

Transformez votre modèle en une transaction en direct. Vous pouvez également 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.

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

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

Intégrez l'éditeur de demande de signature avec un JWT de 7 jours.

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

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

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Envoyez la demande de signature

Lorsque vous êtes prêt, déclenchez l'envoi.

Send signing request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

5) Livraison de la signature à l'intérieur de votre produit ou par redirection

Signature intégrée

Chaque destinataire signe à une URL unique suivant ce modèle :

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

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

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

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Signature par redirection

Alternativement, vous pouvez envoyer les destinataires à l'interface d'hébergement de signature. Consultez le même guide ci-dessus pour les détails.

6) Tout suivre avec les webhooks

Écoutez les événements comme créé, envoyé, vu, signé, et complété pour mettre à jour votre système en temps réel. Le guide inclut la vérification HMAC, la rotation, les nouvelles tentatives, et une liste de contrôle de production.

Webhooks guide
https://docs.firma.dev/guides/webhooks

Create webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Notes d'architecture rapides

• JWTs. Générez-les côté serveur. Les jetons d'éditeur de modèles sont de courte durée ; les jetons d'éditeur de demande de signature expirent après 7 jours.

• Espaces de travail pour SaaS. Gardez les clients complètement séparés. Vos opérateurs travaillent toujours à partir d'une seule API.

• Tarification et lancement. Commencez avec les enveloppes gratuites incluses, puis entrez en production. Pas de minimum. $0,029 par enveloppe.

Quelle est la suite ?

1. Connectez votre premier espace de travail

2. Ajoutez un modèle

3. Envoyez votre première demande

4. Choisissez intégrer ou rediriger

5. Connectez les webhooks

👉 Obtenez votre clé API maintenant - pas de carte de crédit requise.