Cómo añadir firmas electrónicas a tu app Databutton

Databutton te permite crear aplicaciones web full-stack describiendo lo que quieres a un agente de IA. Genera backends de Python (FastAPI) con frontends de Streamlit o React, y se encarga del despliegue con un solo clic. Cuando tu aplicación necesita enviar contratos, recopilar firmas o cerrar acuerdos con documentos legalmente vinculantes, Firma.dev se integra directamente en la arquitectura backend de Databutton.

Cómo funciona (la versión corta)

Las apps de Databutton tienen una separación clara entre frontend y backend. Tu clave API va al panel Secrets de Databutton (nunca expuesta al navegador), y creas un endpoint HTTP de Python que llama a la API de Firma.dev. Tu frontend, ya sea Streamlit o React, llama a ese endpoint cuando un usuario inicia una acción de firma. El firmante recibe el documento por correo electrónico o directamente en tu app mediante un iframe incrustado.

Cuando el documento se firma, Firma.dev envía un webhook a otro endpoint de Databutton que actualiza el estado de tu app. También puedes pedirle al chat de IA de Databutton que conecte todo esto por ti describiendo el flujo en inglés sencillo.

Bajo el capó

Para los desarrolladores que quieren entender la arquitectura antes de saltar a la documentación:

La integración tiene tres partes. Primero, un endpoint FastAPI (/send-signing-request) que lee tu clave API de Firma.dev desde los secretos de Databutton, llama al endpoint create-and-send con los detalles de la plantilla y el destinatario, y devuelve el ID de la solicitud de firma. El endpoint usa modelos de Pydantic para la validación de entrada, así que obtienes comprobación de tipos lista para usar.

Segundo, un manejador de webhooks (/firma-webhook) que escucha eventos como signing_request.completed y actualiza la base de datos de tu app o activa el siguiente paso en tu flujo de trabajo usando el almacenamiento integrado de Databutton.

Tercero, un componente opcional de firma incrustado. Una vez que tienes el signing_request_user_id del destinatario a partir de la respuesta de la API, representas la experiencia de firma de Firma.dev en un iframe. En Streamlit eso es st.components.v1.iframe(); en React es un componente iframe estándar. El firmante completa el documento sin salir de tu app.

También puedes conectar el servidor Docs MCP de Firma.dev a tus herramientas de desarrollo, para que el asistente de IA de Databutton pueda consultar la documentación completa de la API mientras genera el código de integración para ti.

Lo que obtienes

Una vez conectado, tu app de Databutton puede enviar documentos para firma desde cualquier plantilla de Firma.dev, incrustar la firma directamente en tu interfaz, seguir actualizaciones de estado en tiempo real a través de webhooks y activar flujos de trabajo posteriores cuando se completen los documentos.

Cada firma es legalmente vinculante según la ESIGN Act, UETA y eIDAS (SES y AdES). Todos los datos del documento se almacenan en la UE sobre infraestructura de AWS en París y Estocolmo.

Si estás creando un producto multi-tenant, los Espacios de trabajo de clientes de Firma.dev dan a cada uno de tus clientes su propio entorno de firma aislado, con plantillas y seguimiento de uso separados.

Precios que tienen sentido para quienes crean apps

Los precios basados en créditos de Databutton significan que solo pagas por lo que usas. Firma.dev funciona igual: 0,029 € (aproximadamente 3 céntimos de USD) por sobre, sin cuotas mensuales, sin cargos por usuario y sin contratos. Lanzarás la función de firma y solo pagarás cuando realmente se envíen los sobres.

La mayoría de los proveedores de firma electrónica cobran entre 25 y 50 dólares por usuario al mes antes de que envíes un solo documento. Si estás creando una app en la que la firma es una función más entre muchas, ese modelo de precios no tiene sentido. Con Firma.dev, puedes lanzarla con firmas electrónicas desde el primer día sin una suscripción SaaS aparte que reduzca tus márgenes.

Empieza

La guía completa de integración de Databutton en docs.firma.dev recorre cada paso: almacenar tu clave API, crear el endpoint backend, conectar tu frontend y gestionar los webhooks. Si antes has creado una función backend de Databutton, tendrás las solicitudes de firma en funcionamiento en menos de una hora.

Empieza a usar Firma.dev gratis, sin necesidad de tarjeta de crédito.