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

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

Lo que harás

1. Modelar la separación de clientes con Workspaces

2. Crear una Plantilla reutilizable

3. Enviar una Solicitud de Firma

4. Embeber la experiencia de firma o redirigir

5. Rastrear todo con Webhooks

La tarifa es sencilla. Son $0.029 por sobre, con los primeros 25 sobres gratis para que puedas construir y probar de principio a fin.

Requisitos previos

Clave API de la empresa o del workspace desde tu panel de control

• Un PDF que puedas convertir en una plantilla

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

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

1) Crea un workspace para cada cliente

Los Workspaces brindan a cada cliente un espacio privado, particionado, con plantillas, documentos y uso aislados. Es la forma más limpia de construir separación multi‑tenant al 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: los ajustes del workspace, como la copia de correo electrónico y la zona horaria, son por workspace.

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, para que puedas 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 app

Embeber 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 desde un PDF sin procesar 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

Embeber 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 firma dentro de tu producto o mediante redireccionamiento

Firma embebida

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 desde la API.

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

Firma por redireccionamiento

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

6) Rastrear todo con webhooks

Escucha eventos como creados, enviados, vistos, firmados y completados para actualizar tu sistema en tiempo real. La guía incluye verificación HMAC, rotación, reintentos y una lista de verificación para 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 sobre la arquitectura

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

• Workspaces para SaaS. Mantén a los clientes completamente particionados. Tus operadores todavía trabajan desde una sola API.

• Precio y lanzamiento. Comienza con los sobres gratuitos incluidos, luego lánzalo al mercado. No hay mínimos. $0.029 por sobre.

¿Qué sigue?

1. Conecta tu primer workspace

2. Añade una plantilla

3. Envía tu primera solicitud

4. Elige entre embeber o redireccionar

5. Configura los webhooks

👉 Obtén tu clave API ahora - no se requiere tarjeta de crédito.