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 inclui autenticação, pagamentos e uma base de dados pronta a usar, sendo um dos boilerplates de SaaS mais populares no GitHub, com mais de 10 000 estrelas. Se está a desenvolver um produto SaaS no Wasp, adicionar assinaturas eletrónicas é o passo seguinte natural para qualquer área jurídica, de recursos humanos, 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 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 simples. 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 do lado do servidor (para que a sua chave de API nunca chegue ao browser), 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 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 querem compreender a arquitetura antes de passarem para a documentação:

A integração tem quatro partes. Primeiro, uma entidade Prisma SigningRequest que acompanha cada pedido de assinatura com o seu ID da Firma.dev, modelo, e-mail do signatário e estado. Segundo, uma ação 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 gere 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 processador de webhook declarado como uma rota api do Wasp (com auth: false, uma vez que os webhooks não contêm tokens de sessão) que escuta eventos como signing_request.completed e atualiza os seus registos 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 sair 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 MCP de Docs da Firma.dev ao Cursor ou 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 obtém

Uma vez ligada, a sua aplicação Wasp pode enviar documentos para assinatura a partir de qualquer modelo da Firma.dev, acompanhar atualizações de estado em tempo real através de webhooks e do Prisma, incorporar a assinatura diretamente na sua interface de utilizador e desencadear fluxos de trabalho posteriores 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 está a desenvolver um SaaS multi-tenant, os Workspaces de Cliente da Firma.dev dão a cada um dos seus clientes o seu próprio ambiente de assinatura isolado, com modelos e controlo 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 2000 $ por código boilerplate parecia irracional. 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 se acumula rapidamente quando a assinatura é apenas uma funcionalidade do seu produto.

A Firma.dev cobra 0,049 € (cerca de 5 cêntimos de USD) por envelope. Sem mensalidades, sem taxas 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 logo 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 todos os passos: definir a entidade Prisma, criar a ação de servidor, configurar os webhooks e incorporar a experiência de assinatura. Se já desenvolveu uma ação Wasp antes, conseguirá colocar 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.