Êtes-vous développeur et avez-vous déjà votre compte Firma ? Parfait. Ce guide vous mène de « clé API en main » à un flux de signature intégré en direct. Nous resterons concis, nous concentrerons sur les décisions et vous renverrons directement à des extraits fonctionnels dans les documents.

Cherchez-vous le guide non technique ? Cliquez ici.

Ce que vous allez faire

1. Modéliser l'isolement des clients avec les 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. Suivre tout 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 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 de JWT et les webhooks

Besoin d'un rappel sur le flux général ? Voir le Guide de configuration complète.

1) Créer 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 type 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 d'espace de travail comme la copie d'email et le fuseau horaire sont par espace de travail.

Workspace settings guide
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 champs, afin que vous puissiez envoyer le même document plusieurs fois avec des destinataires différents.

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

Option A : Laisser les utilisateurs concevoir les modèles dans votre application

Intégrez l'éditeur de modèles avec un JWT de courte durée.

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éer 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 le 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 : laisser les utilisateurs métier remplir les détails et envoyer depuis votre interface utilisateur

Intégrez l'éditeur de demandes 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) Envoyer 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) Fournir la signature dans votre produit ou par redirection

Signature intégrée

Chaque destinataire signe à une URL unique qui suit 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 allez récupérer 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 vers l'interface de signature hébergée. Voir le même guide ci-dessus pour les détails.

6) Suivre tout avec les webhooks

Écoutez les événements tels que créés, envoyés, vus, signés et complétés 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 rapides sur l'architecture

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

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

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

Quelles sont les prochaines étapes ?

1. Connecter votre premier espace de travail

2. Ajouter un modèle

3. Envoyer votre première demande

4. Choisir l'intégration ou la redirection

5. Connecter les webhooks

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