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 seu modelo Open SaaS vem com autenticação, pagamentos e uma base de dados pronta a usar, e é um dos boilerplates SaaS mais populares no GitHub, com mais de 10 000 estrelas. Se está a criar um produto SaaS no Wasp, adicionar assinaturas eletrónicas é o passo seguinte natural para qualquer área jurídica, de RH, consultoria ou imobiliária.

A Firma.dev integra-se diretamente com as ações de servidor do Wasp e os modelos do Prisma. Define uma ação do Wasp, chama a API da Firma.dev a partir do seu código do lado do servidor e monitoriza 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 corre do 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 Prisma. O signatário 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á está a correr o Open SaaS, tem a autenticação, uma base de dados e as ações de servidor prontas a funcionar. A integração com a Firma.dev adiciona talvez 100 linhas de código em dois ficheiros.

Nos bastidores

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

A integração tem quatro partes. Primeiro, uma entidade Prisma SigningRequest que monitoriza cada pedido de assinatura com o seu ID da Firma.dev, modelo, e-mail do signatário 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, pelo que 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 de assinatura incorporado opcional: um iframe direcionado para https://app.firma.dev/signing/{id} que permite aos signatários concluir documentos sem saírem da sua aplicação.

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

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

O que obtém

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

Cada assinatura é juridicamente vinculativa ao abrigo da lei ESIGN, UETA e eIDAS (SES e AdES). Todos os dados dos documentos são guardados na UE na infraestrutura da AWS em Paris e Estocolmo.

Se está a criar um SaaS multi-tenant, 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 monitorização de utilização separados. Isso combina perfeitamente com os padrões de multi-tenancy do Wasp.

Preços que funcionam para criadores de SaaS

O Open SaaS existe porque pagar $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 de $25 a $50 por utilizador por mês, o que acumula rapidamente quando a assinatura é apenas uma funcionalidade do seu produto.

A Firma.dev cobra €0,049 (aproximadamente 5 cêntimos de USD) por envelope. Sem mensalidades, sem custos por utilizador, sem contratos. Lança a funcionalidade e só paga quando os envelopes são 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 de queima de capital (burn rate).

Começar

O guia completo de integração do Wasp em docs.firma.dev explica todos os passos: definir a entidade Prisma, criar a ação de servidor, ligar 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.