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

O Supabase tornou-se o backend predefinido para uma enorme parte das aplicações web modernas. Quer esteja a escrever código sozinho, a lançar com o Next.js ou a construir através de ferramentas de IA como o Lovable e o Bolt.new, há uma grande probabilidade de o seu projeto correr com o Supabase nos bastidores. E, eventualmente, muitos desses projetos precisam de assinaturas.

O Firma.dev é a única API de assinatura eletrónica com uma integração dedicada com o Supabase. Funciona nativamente com Edge Functions, Postgres, e webhooks, para que não tenha de acoplar um sistema externo que não compreende a sua stack. Está a expandir a infraestrutura que já possui.

Como funciona (sem o jargão técnico)

A configuração segue um padrão que qualquer programador de Supabase reconhecerá. A sua app chama uma Supabase Edge Function, que comunica de forma segura com a API do Firma.dev para criar um pedido de assinatura. O signatário recebe o documento, assina-o, e o Firma.dev envia um webhook de volta para outra Edge Function que atualiza a sua base de dados Postgres. O seu frontend consulta essa tabela como qualquer outra tabela do Supabase, com Row Level Security já implementado.

Se estiver a utilizar o Lovable, o Bolt.new ou outro construtor de IA que corra em Supabase, pode programar a maior parte disto através de prompts. O guia de integração completo inclui o código exato para cada passo, e as ferramentas de IA podem estruturar o resto.

Para fundadores não técnicos: a versão curta é que a sua app ganha a capacidade de enviar documentos, recolher assinaturas legalmente vinculativas e acompanhar tudo na sua base de dados existente. Sem novas infraestruturas, sem novos painéis de fornecedores para gerir.

Nos bastidores

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

A integração tem três partes móveis. Primeiro, uma Edge Function send-signing-request que autentica o utilizador, chama a API do Firma.dev com o modelo e os detalhes do destinatário, e armazena o ID do pedido numa tabela Postgres signing_requests. Segundo, uma Edge Function firma-webhook (implementada com --no-verify-jwt, uma vez que os webhooks não contêm cabeçalhos de autenticação) que escuta eventos como signing_request.completed ou signing_request.recipient.declined e atualiza a sua tabela em conformidade. Terceiro, o seu frontend, que consulta essa tabela através da biblioteca de clientes do Supabase com políticas RLS para que os utilizadores vejam apenas os seus próprios documentos.

Também pode incorporar a experiência de assinatura diretamente na sua app utilizando um iframe direcionado para o URL de assinatura incorporável do Firma.dev. O signatário nunca sai do seu interface.

Tudo isto é implementado com supabase functions deploy e um único comando supabase secrets set para a sua chave de API. Sem servidores externos, sem fluxos de autenticação complexos.

O que obtém

Uma vez ligado, a sua aplicação Supabase pode enviar documentos para assinatura a partir de qualquer modelo que tenha construído no Firma.dev, acompanhar atualizações de estado em tempo real através de webhooks, incorporar a assinatura diretamente no seu interface e acionar fluxos de trabalho downstream quando os documentos estão concluídos, utilizando os próprios triggers de base de dados do Supabase.

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 construir um produto SaaS multi-tenant, os Workspaces de Cliente do 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. Isto combina naturalmente com o modelo de Row Level Security do Supabase.

Preços que funcionam para projetos Supabase

A filosofia de preços do Supabase é pagar pelo que consome, e o Firma.dev segue o mesmo modelo. Cada envelope custa €0.049 (aproximadamente 5 cêntimos USD). Sem mensalidades, sem custos por utilizador, sem contratos.

Para contextualizar, a maioria dos fornecedores de assinatura eletrónica cobra $25-$50 por utilizador por mês antes de enviar um único documento. Se está a construir um produto onde a assinatura é uma funcionalidade (e não o produto inteiro), essa estrutura de custos não faz sentido. Com o Firma.dev, lança a funcionalidade hoje e só paga quando os envelopes forem realmente enviados.

Começar

O guia de integração completo do Supabase em docs.firma.dev detalha cada passo, desde o armazenamento da sua chave de API até à gestão de webhooks. Se já implementou uma Supabase Edge Function anteriormente, terá os pedidos de assinatura a funcionar em menos de uma hora.

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