Envía tu primer flujo de firma electrónica rápidamente con Firma: Una guía rápida para desarrolladores

¿Eres desarrollador y ya tienes tu cuenta de Firma? Perfecto. Esta guía te lleva desde “clave API en mano” a un flujo de firma en vivo y embebido. Lo mantendremos sencillo, nos centraremos en decisiones, y te vincularemos directamente a fragmentos funcionales en la documentación.

¿Buscas la guía No Técnica? Haz clic aquí.

Qué harás

1. Modelar aislamiento de clientes con Espacios de Trabajo

2. Crear una Plantilla reutilizable

3. Enviar una Solicitud de Firma

4. Integrar la experiencia de firma o redirigir

5. Rastrear todo con Webhooks

El precio es simple. Es $0.029 por sobre, con tus primeros 25 sobres gratis para que puedas construir y probar de principio a fin.

Requisitos previos

Clave API de empresa o de espacio de trabajo desde tu panel de control

• Un PDF que puedas convertir en una plantilla

• Un lugar para ejecutar código del servidor para generación de JWT y webhooks

¿Necesitas un repaso del flujo general? Consulta la Guía de Configuración Completa.

1) Crear un espacio de trabajo para cada cliente

Los Espacios de Trabajo dan a cada cliente un espacio privado y particionado con plantillas, documentos y uso aislados. Es la manera más limpia de construir una separación de múltiples arrendatarios estilo SaaS sin filtrar datos entre clientes.

Create a workspace
https://docs.firma.dev/api-reference/v01.00.01/workspaces/create-a-new-workspace

Útil: la configuración del espacio de trabajo como la copia de correo y la zona horaria son por espacio de trabajo.

Workspace settings guide
https://docs.firma.dev/guides/workspace-settings

2) Crear una plantilla reutilizable

Las plantillas contienen el PDF más roles y campos, así puedes enviar el mismo documento muchas veces con diferentes destinatarios.

Create Template (API)
https://docs.firma.dev/api-reference/v01.00.01/templates/create-template

Opción A: Permitir que los usuarios diseñen plantillas dentro de tu aplicación

Incrustar el editor de plantillas con un JWT de corta duración.

Embeddable template editor (guide)
https://docs.firma.dev/guides/embeddable-template-editor

Generar el token del lado del servidor.

Generate JWT for template embedding
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-embedding-templates

3) Crear la solicitud de firma

Convierte tu plantilla en una transacción en vivo. También puedes crear a partir de un PDF en bruto si lo prefieres. La referencia cubre destinatarios, campos, recordatorios y reglas de validación.

Create Signing Request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/create-signing-request

Opcional: permitir que los usuarios empresariales completen detalles y envíen desde tu interfaz

Incrustar el editor de solicitudes de firma con un JWT de 7 días.

Embeddable signing request editor (guide)
https://docs.firma.dev/guides/embeddable-signing-request-editor

Generar el JWT del lado del servidor.

Generate JWT for signing request editor
https://docs.firma.dev/api-reference/v01.00.01/jwt-management/generate-jwt-token-for-signing-request

4) Enviar la solicitud de firma

Cuando estés listo, activa el envío.

Send signing request
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/send-signing-request

5) Entregar la firma dentro de tu producto o mediante redirección

Firma integrada

Cada destinatario firma en una URL única que sigue este patrón:

https://app.firma.dev/signing/{signing_request_user_id}.

Embeddable signing (iframe pattern and tips)
https://docs.firma.dev/guides/embeddable-signing

Obtendrás el signing_request_user_id de la API.

Get signing request users
https://docs.firma.dev/api-reference/v01.00.01/signing-requests/get-signing-request-users

Redirección de firma

Alternativamente, puedes enviar a los destinatarios a la interfaz de firma alojada. Consulta la misma guía arriba para más detalles.

6) Rastrear todo con webhooks

Escucha eventos como creado, enviado, visto, firmado y completado para actualizar tu sistema en tiempo real. La guía incluye verificación HMAC, rotación, reintentos y una lista de verificación de producción.

Webhooks guide
https://docs.firma.dev/guides/webhooks

Create webhook (API)
https://docs.firma.dev/api-reference/v01.00.01/webhooks/create-webhook

Notas rápidas de arquitectura

• JWTs. Generarlos del lado del servidor. Los tokens de editor de plantillas son de corta duración; los tokens de editor de solicitudes de firma expiran después de 7 días.

• Espacios de Trabajo para SaaS. Mantén a los clientes totalmente particionados. Tus operadores aún trabajan desde una sola API.

• Precios y despliegue. Comienza con los sobres gratuitos incluidos, luego entra en producción. Sin mínimos. $0.029 por sobre.

¿Qué sigue?

1. Conectar tu primer espacio de trabajo

2. Agregar una plantilla

3. Enviar tu primera solicitud

4. Elegir incrustar o redirigir

5. Configurar webhooks

👉 Obtén tu clave API ahora - sin necesidad de tarjeta de crédito.