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

O Supabase tornou-se o back-end padrão para uma enorme parte das aplicações web modernas. Quer esteja a escrever código por si mesmo, 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.

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 associar um sistema externo que não compreende a sua stack. Está a expandir a infraestrutura que já possui.

Como funciona (sem jargão técnico)

A configuração segue um padrão que qualquer programador de Supabase reconhecerá. A sua aplicação invoca 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 front-end consulta essa tabela como qualquer outra tabela do Supabase, com o Row Level Security (RLS) já ativo.

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

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

Nos bastidores

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

A integração tem três partes ativas. Primeiro, uma Edge Function send-signing-request que autentica o utilizador, invoca a API do Firma.dev com o modelo e dados 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 front-end, que consulta essa tabela através da biblioteca de cliente 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 aplicação utilizando um iframe apontado 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 na sua UI e acionar fluxos de trabalho seguintes quando os documentos são concluídos através dos 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 do documento são armazenados na UE em infraestrutura AWS em Paris e Estocolmo.

Se estiver a construir um produto SaaS multi-tenant, os Customer Workspaces do Firma.dev dão a cada um dos seus clientes o seu próprio ambiente de assinatura isolado com modelos próprios e monitorização de utilização. Isto combina perfeitamente com o modelo de Row Level Security do Supabase.

Preços adequados para projetos Supabase

A filosofia de preços do Supabase baseia-se no pagamento por utilização, e o Firma.dev segue o mesmo modelo. Cada envelope custa €0,029 (aproximadamente 3 cêntimos de USD). Sem taxas mensais, sem custos por utilizador, sem contratos.

Para contextualizar, a maioria dos fornecedores de assinatura eletrónica cobra $25 a $50 por utilizador, por mês, antes de enviar sequer um único documento. Se estiver a construir um produto onde a assinatura é apenas 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 completo de integração com o Supabase no docs.firma.dev detalha todos os passos, desde o armazenamento da sua chave de API até à gestão de webhooks. Se já implementou uma Supabase Edge Function antes, 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.