Como adicionar assinaturas eletrónicas à sua aplicação Wasp

O Wasp é uma framework full-stack para React, Node.js e Prisma que lhe permite definir autenticação, ações de servidor e entidades de base de dados num ficheiro de configuração declarativo. O modelo Open SaaS deles vem com autenticação, pagamentos e uma base de dados integrada, e é um dos boilerplates de SaaS mais populares no GitHub com mais de 10.000 estrelas. Se estiver a criar um produto SaaS no Wasp, adicionar assinaturas eletrónicas é um passo natural para qualquer projeto nas áreas jurídica, recursos humanos, consultoria ou imobiliária.

A Firma.dev integra-se diretamente com as ações de servidor do Wasp e com os modelos do Prisma. Define uma ação do Wasp, chama a API da Firma.dev a partir do seu código no lado do servidor e rastreia tudo na sua base de dados existente. Sem infraestrutura externa, sem novos serviços para gerir.

Como funciona (a versão curta)

A arquitetura do Wasp torna isto limpo. Declara uma ação de servidor no seu ficheiro de configuração .wasp, implementa-a em TypeScript e chama-a a partir de qualquer componente React. A ação é executada no lado do servidor (para que a sua chave de API nunca toque no navegador), cria um pedido de assinatura através da API da Firma.dev e guarda o resultado na sua base de dados do Prisma. O assinante recebe o documento por e-mail ou através de um iframe incorporado na sua aplicação.

Quando o documento é assinado, a Firma.dev envia um webhook para uma rota de API do Wasp que atualiza o estado do pedido de assinatura na sua base de dados. O seu frontend deteta a alteração automaticamente através das consultas reativas do Wasp.

Se já estiver a executar o Open SaaS, já tem a autenticação, uma base de dados e ações de servidor prontas a funcionar. A integração com a Firma.dev adiciona talvez umas 100 linhas de código distribuídas por dois ficheiros.

Por baixo do capot

Para os programadores que querem compreender a arquitetura antes de passarem para a documentação:

A integração tem quatro partes. Primeiro, uma entidade do Prisma SigningRequest que rastreia cada pedido de assinatura com o seu ID da Firma.dev, modelo, e-mail do assinante e estado. Segundo, uma ação do Wasp sendSigningRequest que lê a sua chave de API de .env.server, chama o endpoint create-and-send da Firma.dev e escreve o resultado na sua base de dados. O Wasp lida com o RPC cliente-servidor automaticamente, por isso o seu componente React apenas chama a ação como uma função assíncrona normal.

Terceiro, um manipulador de webhook declarado como uma rota de api do Wasp (com auth: false uma vez que os webhooks não transportam tokens de sessão) que escuta eventos como signing_request.completed e atualiza os seus registos do Prisma. Quarto, um componente opcional de assinatura incorporado: um iframe apontado para https://app.firma.dev/signing/{id} que permite aos assinantes preencherem os documentos sem saírem da sua aplicação.

Tudo isto funciona com a segurança de tipos do Wasp. Define os tipos de entrada e saída da sua ação, e o Wasp infere os tipos no frontend automaticamente.

Também pode ligar o servidor Docs MCP da Firma.dev ao Cursor ou ao Claude durante o desenvolvimento, para que o seu assistente de IA possa consultar a documentação completa da API enquanto gera o código de integração.

O que recebe

Uma vez ligado, a sua aplicação Wasp pode enviar documentos para assinatura a partir de qualquer modelo da Firma.dev, rastrear atualizações de estado em tempo real através de webhooks e do Prisma, incorporar a assinatura diretamente na sua UI e acionar fluxos de trabalho downstream quando os documentos forem concluídos.

Cada assinatura é legalmente vinculativa ao abrigo do ESIGN Act, UETA e eIDAS (SES e AdES). Todos os dados dos documentos são armazenados na UE, na infraestrutura AWS em Paris e Estocolmo.

Se estiver a criar um SaaS multi-inquilino, os Customer Workspaces da Firma.dev dão a cada um dos seus clientes o seu próprio ambiente de assinatura isolado com modelos e rastreio de utilização separados. Isso combina perfeitamente com os padrões de multi-inquilino do Wasp.

Preços que funcionam para criadores de SaaS

O Open SaaS existe porque pagar entre $300 a $2.000 por código de boilerplate parecia pouco razoável. A mesma lógica aplica-se às assinaturas eletrónicas. A maioria dos fornecedores cobra entre $25 e $50 por utilizador por mês, o que acumula rapidamente quando a assinatura é apenas uma funcionalidade no seu produto.

A Firma.dev cobra €0,029 (cerca de 3 cêntimos de dólar) por envelope. Sem taxas mensais, sem custos por utilizador, sem contratos. Lança a funcionalidade e só paga quando os envelopes forem enviados. Para um SaaS em fase inicial no Open SaaS, isto significa que pode lançar com assinaturas eletrónicas no primeiro dia sem adicionar uma despesa de $300/mês ao seu orçamento.

Começar

O guia completo de integração do Wasp em docs.firma.dev explica cada passo: definir a entidade do Prisma, criar a ação do servidor, configurar os webhooks e incorporar a experiência de assinatura. Se já criou uma ação do Wasp antes, terá os pedidos de assinatura a funcionar em menos de uma hora.

Comece a utilizar a Firma.dev gratuitamente, sem necessidade de cartão de crédito.