Cómo añadir firmas electrónicas a tu aplicación de Supabase

Supabase se ha convertido en el backend por defecto para una gran parte de las aplicaciones web modernas. Ya sea que estés escribiendo código tú mismo, realizando despliegues con Next.js o construyendo a través de herramientas de IA como Lovable y Bolt.new, existe una alta probabilidad de que tu proyecto funcione con Supabase bajo el capó. Y con el tiempo, muchos de esos proyectos necesitan firmas.

Firma.dev es la única API de firma electrónica con una integración dedicada para Supabase. Funciona de manera nativa con Edge Functions, Postgres y webhooks, por lo que no estarás acoplando un sistema externo que no entiende tu pila tecnológica. Estás extendiendo la infraestructura que ya tienes.

Cómo funciona (sin la jerga técnica)

La configuración sigue un patrón que cualquier desarrollador de Supabase reconocerá. Tu aplicación llama a una Supabase Edge Function, que se comunica de forma segura con la API de Firma.dev para crear una solicitud de firma. El firmante recibe el documento, lo firma y Firma.dev envía un webhook de vuelta a otra Edge Function que actualiza tu base de datos Postgres. Tu frontend consulta esa tabla como cualquier otra tabla de Supabase, con la Seguridad de Nivel de Fila (RLS) ya implementada de origen.

Si estás utilizando Lovable, Bolt.new u otro constructor de IA que funcione sobre Supabase, puedes guiarte a través de la mayor parte de esto mediante prompts. La guía de integración completa incluye el código exacto para cada paso, y las herramientas de IA pueden estructurar el resto.

Para fundadores no técnicos: la versión corta es que tu aplicación adquiere la capacidad de enviar documentos, recopilar firmas legalmente vinculantes y realizar un seguimiento de todo en tu base de datos existente. Sin nueva infraestructura, sin nuevos paneles de control de proveedores que gestionar.

Bajo el capó

Para desarrolladores que desean entender la arquitectura antes de profundizar en la documentación:

La integración consta de tres partes móviles. Primero, una Edge Function send-signing-request que autentica al usuario, llama a la API de Firma.dev con los detalles de la plantilla y del destinatario, y almacena el ID de la solicitud en una tabla de Postgres llamada signing_requests. Segundo, una Edge Function firma-webhook (desplegada con --no-verify-jwt dado que los webhooks no llevan cabeceras de autenticación) que escucha eventos como signing_request.completed o signing_request.recipient.declined y actualiza tu tabla en consecuencia. Tercero, tu frontend, que consulta esa tabla mediante la biblioteca cliente de Supabase con políticas de RLS para que los usuarios solo vean sus propios documentos.

También puedes incrustar la experiencia de firma directamente en tu aplicación utilizando un iframe que apunte a la URL de firma incrustable de Firma.dev. El firmante nunca sale de tu interfaz.

Todo se despliega con supabase functions deploy y un único comando supabase secrets set para tu clave de API. Sin servidores externos, sin complejos flujos de autenticación.

Lo que obtienes

Una vez conectada, tu aplicación de Supabase puede enviar documentos para su firma a partir de cualquier plantilla que hayas creado en Firma.dev, realizar un seguimiento de las actualizaciones de estado en tiempo real mediante webhooks, incrustar la firma directamente en tu interfaz de usuario y activar flujos de trabajo posteriores cuando se completen los documentos utilizando los propios disparadores de base de datos de Supabase.

Cada firma es legalmente vinculante bajo la Ley ESIGN, UETA y eIDAS (SES y AdES). Todos los datos de los documentos se almacenan en la UE en la infraestructura de AWS en París y Estocolmo.

Si estás construyendo un producto SaaS multiinquilino, los Espacios de Trabajo para Clientes de Firma.dev ofrecen a cada uno de tus clientes su propio entorno de firma aislado con plantillas independientes y seguimiento de uso. Esto encaja de forma natural con el modelo de Seguridad de Nivel de Fila de Supabase.

Precios que funcionan para proyectos de Supabase

La filosofía de precios de Supabase es el pago por uso, y Firma.dev sigue el mismo modelo. Cada sobre cuesta 0,029 € (aproximadamente 3 centavos de USD). Sin tarifas mensuales, sin cargos por usuario, sin contratos.

Para ponerlo en contexto, la mayoría de los proveedores de firma electrónica cobran entre $25 y $50 por usuario al mes antes de enviar un solo documento. Si estás construyendo un producto donde la firma es una funcionalidad (no todo el producto), esa estructura de costes no tiene sentido. Con Firma.dev, lanzas la funcionalidad hoy y solo pagas cuando realmente se envían los sobres.

Primeros pasos

La guía de integración completa de Supabase en docs.firma.dev detalla cada paso, desde el almacenamiento de tu clave de API hasta la gestión de webhooks. Si ya has desplegado una Supabase Edge Function anteriormente, tendrás las solicitudes de firma funcionando en menos de una hora.

Comienza con Firma.dev de forma gratuita, sin tarjeta de crédito requerida.