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

Supabase se ha convertido en el backend predeterminado para una gran parte de las aplicaciones web modernas. Ya sea que estés escribiendo el código tú mismo, realizando el despliegue con Next.js o construyendo a través de herramientas de IA como Lovable y Bolt.new, es muy probable que tu proyecto funcione sobre Supabase en su interior. 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 forma nativa con Edge Functions, Postgres y webhooks, por lo que no estarás acoplando un sistema externo que no entiende tu tecnología. Estás extendiendo la infraestructura que ya tienes.

Cómo funciona (sin tecnicismos)

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 de Postgres. Tu frontend consulta esa tabla como cualquier otra tabla de Supabase, con la Seguridad de Nivel de Fila (RLS) ya implementada.

Si estás utilizando Lovable, Bolt.new u otro constructor de IA que se ejecute en Supabase, puedes guiar la mayor parte de este proceso mediante instrucciones manuales (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 obtiene la capacidad de enviar documentos, recopilar firmas legalmente vinculantes y realizar un seguimiento de todo en tu base de datos existente. Sin nueva infraestructura ni nuevos paneles de control de proveedores que gestionar.

Bajo el capó

Para los 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 ya que los webhooks no llevan encabezados 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 a través de la biblioteca cliente de Supabase con políticas de RLS para que los usuarios solo vean sus propios documentos.

También puedes integrar la experiencia de firma directamente en tu aplicación utilizando un iframe apuntado a la URL de firma integrable de Firma.dev. El firmante nunca sale de tu interfaz.

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

Qué obtienes

Una vez conectada, tu aplicación de Supabase puede enviar documentos para 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, integrar 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 según 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 (multi-tenant), los Espacios de Trabajo para Clientes de Firma.dev ofrecen a cada uno de tus clientes su propio entorno de firma aislado con plantillas y seguimiento de uso independientes. Esto encaja de forma natural con el modelo de Seguridad de Nivel de Fila de Supabase.

Precios adaptados para proyectos de Supabase

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

Para ponerlo en contexto, la mayoría de los proveedores de firma electrónica cobran de 25 a 50 $ por usuario al mes antes de que envíes 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 cómo almacenar tu clave de API hasta cómo gestionar los webhooks. Si ya has desplegado una Supabase Edge Function antes, tendrás las solicitudes de firma funcionando en menos de una hora.

Comienza con Firma.dev gratis, sin necesidad de tarjeta de crédito.