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

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

Cómo funciona (la versión corta)

Las aplicaciones de Databutton tienen una separación clara entre el frontend y el backend. Tu clave de API se introduce en el panel de Secrets de Databutton (nunca se expone 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 activa una acción de firma. El firmante recibe el documento por correo electrónico o directamente en tu aplicación a través de un iframe integrado.

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

Bajo el capó

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

La integración consta de tres partes. Primero, un endpoint de FastAPI (/send-signing-request) que lee tu clave de API de Firma.dev desde los secretos de Databutton, llama al endpoint create-and-send con los detalles de la plantilla y del destinatario, y devuelve el ID de la solicitud de firma. El endpoint utiliza modelos de Pydantic para la validación de entradas, por lo que obtienes comprobación de tipos de forma nativa.

Segundo, un controlador de webhook (/firma-webhook) que escucha eventos como signing_request.completed y actualiza la base de datos de tu aplicación o activa el siguiente paso en tu flujo de trabajo utilizando el almacenamiento integrado de Databutton.

Tercero, un componente de firma integrado opcional. Una vez que obtienes el signing_request_user_id del destinatario a partir de la respuesta de la API, renderizas 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 aplicación.

También puedes conectar el servidor MCP de documentación 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.

Qué obtienes

Una vez conectada, tu aplicación Databutton puede enviar documentos para su firma desde cualquier plantilla de Firma.dev, integrar la firma directamente en tu interfaz de usuario, realizar un seguimiento de las 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 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 creando un producto 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 y seguimiento de uso independientes.

Precios con sentido para creadores de aplicaciones

El sistema de precios basado en créditos de Databutton significa que solo pagas por lo que usas. Firma.dev funciona de la misma manera: 0,029 € (aproximadamente 3 centavos de dólar) por sobre, sin tarifas mensuales, sin cargos por usuario y sin contratos. Publicas la función de firma y solo pagas cuando los sobres realmente se envían.

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

Primeros pasos

La guía de integración completa de Databutton en docs.firma.dev te guía a través de cada paso: guardar tu clave de API, crear el endpoint del backend, conectar tu frontend y gestionar los webhooks. Si ya has creado una función de backend en Databutton anteriormente, tendrás las solicitudes de firma funcionando en menos de una hora.

Comienza a utilizar Firma.dev de forma gratuita, sin necesidad de tarjeta de crédito.