Comment ajouter des signatures électroniques à votre application Wasp

Wasp est un framework full-stack pour React, Node.js et Prisma qui vous permet de définir l'authentification, les actions du serveur et les entités de base de données dans un fichier de configuration déclaratif. Leur modèle Open SaaS est livré clé en main avec l'authentification, les paiements et une base de données, et c'est l'un des boilerplates SaaS les plus populaires sur GitHub avec plus de 10 000 étoiles. Si vous construisez un produit SaaS sur Wasp, l'ajout de signatures électroniques est une étape suivante naturelle pour tout ce qui concerne le juridique, les RH, le conseil ou l'immobilier.

Firma.dev s'intègre directement aux actions serveur de Wasp et aux modèles Prisma. Vous définissez une action Wasp, appelez l'API de Firma.dev depuis votre code côté serveur et suivez tout dans votre base de données existante. Pas d'infrastructure externe, pas de nouveaux services à gérer.

Comment ça marche (la version courte)

L'architecture de Wasp rend cela propre. Vous déclarez une action serveur dans votre fichier de configuration .wasp, l'implémentez en TypeScript et l'appelez depuis n'importe quel composant React. L'action s'exécute côté serveur (ainsi votre clé d'API ne touche jamais le navigateur), crée une demande de signature via l'API de Firma.dev et stocke le résultat dans votre base de données Prisma. Le signataire reçoit le document par e-mail ou via une iframe intégrée dans votre application.

Lorsque le document est signé, Firma.dev envoie un webhook à une route API Wasp qui met à jour le statut de la demande de signature dans votre base de données. Votre frontend récupère automatiquement le changement grâce aux requêtes réactives de Wasp.

Si vous utilisez déjà Open SaaS, vous avez l'authentification, une base de données et des actions serveur prêtes à l'emploi. L'intégration de Firma.dev ajoute peut-être 100 lignes de code réparties sur deux fichiers.

Sous le capot

Pour les développeurs qui souhaitent comprendre l'architecture avant de se plonger dans la documentation :

L'intégration comporte quatre éléments. Tout d'abord, une entité Prisma SigningRequest qui suit chaque demande de signature avec son identifiant Firma.dev, son modèle, l'e-mail du signataire et son statut. Deuxièmement, une action Wasp sendSigningRequest qui lit votre clé d'API depuis .env.server, appelle le point de terminaison create-and-send de Firma.dev et écrit le résultat dans votre base de données. Wasp gère automatiquement le RPC client-serveur, de sorte que votre composant React appelle simplement l'action comme une fonction asynchrone classique.

Troisièmement, un gestionnaire de webhook déclaré comme une route api Wasp (avec auth: false puisque les webhooks ne contiennent pas de jetons de session) qui écoute les événements comme signing_request.completed et met à jour vos enregistrements Prisma. Quatrièmement, un composant de signature intégré optionnel : une iframe pointant vers https://app.firma.dev/signing/{id} qui permet aux signataires de remplir les documents sans quitter votre application.

Le tout fonctionne avec la sécurité de typage de Wasp. Vous typez l'entrée et la sortie de votre action, et Wasp déduit automatiquement les types sur le frontend.

Vous pouvez également connecter le serveur MCP Docs de Firma.dev à Cursor ou Claude pendant le développement, afin que votre assistant IA puisse se référer à la documentation complète de l'API lorsqu'il génère le code d'intégration.

Ce que vous obtenez

Une fois connectée, votre application Wasp peut envoyer des documents pour signature à partir de n'importe quel modèle Firma.dev, suivre les mises à jour de statut en temps réel via des webhooks et Prisma, intégrer la signature directement dans votre interface utilisateur et déclencher des flux de travail en aval lorsque les documents sont finalisés.

Chaque signature est juridiquement contraignante en vertu de la loi ESIGN, d'UETA et d'eIDAS (SES et AdES). Toutes les données des documents sont stockées dans l'UE sur l'infrastructure AWS à Paris et Stockholm.

Si vous construisez un SaaS multi-locataire, les Espaces de travail client de Firma.dev offrent à chacun de vos clients leur propre environnement de signature isolé avec des modèles et un suivi de l'utilisation distincts. Cela s'associe parfaitement aux modèles multi-locataires de Wasp.

Des tarifs adaptés aux créateurs de SaaS

Open SaaS existe parce que payer de 300 $ à 2 000 $ pour du code de boilerplate semblait déraisonnable. La même logique s'applique aux signatures électroniques. La plupart des fournisseurs facturent de 25 $ à 50 $ par utilisateur et par mois, ce qui grimpe rapidement lorsque la signature n'est qu'une fonctionnalité parmi d'autres dans votre produit.

Firma.dev facture 0,049 € (environ 5 centimes de dollar) par enveloppe. Aucun frais mensuel, aucun frais par utilisateur, aucun contrat. Vous déployez la fonctionnalité et ne payez que lorsque les enveloppes sont envoyées. Pour un SaaS en phase de démarrage sur Open SaaS, cela signifie que vous pouvez vous lancer avec des signatures électroniques dès le premier jour sans ajouter une ligne de dépenses de 300 $/mois à votre budget.

Commencer

Le guide complet d'intégration de Wasp sur docs.firma.dev détaille chaque étape : définir l'entité Prisma, créer l'action serveur, configurer les webhooks et intégrer l'expérience de signature. Si vous avez déjà créé une action Wasp auparavant, vos demandes de signature fonctionneront en moins d'une heure.

Commencez à utiliser Firma.dev gratuitement, sans carte de crédit requise.