Novedades en Firma.dev: personaliza con tu marca blanca la página de firma hasta el último botón

La página de firma de Firma.dev ya incorpora tu marca: tu logotipo, tus colores, tus condiciones para el firmante, tus correos electrónicos y tu página de finalización. A partir de la versión v1.40.0 de la API, lanzada el 17 de octubre de 2026, también se rige por tus reglas sobre lo que un firmante puede hacer en ella. Dos nuevos ajustes permiten ocultar los botones «Rechazar firma» y «Guardar y completar más tarde» tanto en las páginas de firma alojadas como en las integradas, de modo que una plataforma SaaS que utilice la firma integrada dentro de su propio producto ahora decide qué acciones tienen disponibles sus firmantes.

Novedad: Elige qué botones ven tus firmantes

Esta versión añade dos selectores. allow_decline controla el botón «Rechazar firma» y show_save_for_later controla «Guardar y completar más tarde». Ambos se aplican a la página de firma alojada y al iframe de firma integrada, y ambos están visibles de forma predeterminada, por lo que tus páginas de firma permanecerán exactamente como están hasta que configures un valor.

Ocultar «Rechazar firma» es de obligado cumplimiento. Con allow_decline establecido en false, Firma.dev rechaza cualquier intento de declinación en esa solicitud de firma, tanto para firmantes como para aprobadores, y la solicitud solo se puede detener cancelándola... lo que traslada la decisión de rechazo a tu producto. Ocultar «Guardar y completar más tarde» simplemente elimina el botón.

Tu página de firma, con marca blanca de principio a fin

La visibilidad de los botones es el nivel más reciente de un conjunto de funciones de marca blanca que las plataformas SaaS ya utilizan para que la firma integrada tenga la misma apariencia y comportamiento que su propia aplicación. Los controles actuales, agrupados según dónde los encuentra el firmante:

En la página de firma

• Botones de la página de firma (nuevo): muestra u oculta «Rechazar firma» y «Guardar y completar más tarde».

• Etiquetas de los botones: cambia el nombre de nueve botones de la vista de firma por idioma con signing_button_label_overrides, incluidos «Rechazar firma» y «Guardar y completar más tarde». Más información en etiquetas personalizadas para los botones de firma.

• Tema de color: 11 ajustes hexadecimales color_* a nivel de empresa y espacio de trabajo. Cinco de ellos también personalizan el tema de los editores integrados.

• Ajustes de visualización: marco de firma, marca de agua parcial, código QR, verificación de OTP por correo electrónico, aceptación de condiciones, navegación guiada y descarga previa a la firma.

• Condiciones del firmante: tu propia declaración de consentimiento por idioma, con un enlace opcional a los términos.

• Colores de fondo de los campos y una interfaz de firma en 15 idiomas, seleccionable con el parámetro lang.

Integración

• Firma integrada en un iframe que emite los eventos postMessage signing.started, signing.completed, signing.declined y signing.error. La guía de inicio rápido de la API de firma electrónica integrada lo explica detalladamente.

• Editores integrables de plantillas y solicitudes de firma con controles de tema y cierre.

Correos electrónicos

• Un dominio de envío personalizado verificado con SPF, DKIM y DMARC, junto con la parte local de tu propia dirección de remitente.

• Tu logotipo (PNG o JPEG, de hasta 2 MB) en los correos electrónicos y certificados de firma.

• Plantillas de correo electrónico personalizadas a nivel de empresa o de espacio de trabajo, además de selectores por solicitud que desactivan los correos de firma, finalización, vencimiento y cancelación de Firma.dev. Consulta correos electrónicos y enlaces de firma electrónica de marca blanca.

Después de firmar

• Una página de finalización con tu propio título, mensaje y redirección HTTPS, tratada en personalización de la página de finalización.

• Sellos de organización con el membrete de tu empresa en los PDF completados.

Por cliente

• Con los Espacios de trabajo para clientes, cada ajuste compatible a nivel de espacio de trabajo puede diferir de un cliente a otro.

Las etiquetas y la visibilidad se combinan, de modo que un espacio de trabajo puede renombrar «Rechazar firma» como «Solicitar cambios» mientras que otro espacio de trabajo lo oculta por completo. La guía completa de la API de firma electrónica de marca blanca repasa cada control a fondo, y la página de características de firma electrónica de marca blanca ofrece una visión general. Todo esto se incluye al mismo precio que el resto de las funciones en las tarifas de Firma.dev: 0,049 € por sobre (~5¢ USD), de pago por uso, sin mínimos mensuales ni tarifas por puesto.

Cuatro niveles, el más específico prevalece

Cada botón se puede configurar en cuatro niveles: empresa, espacio de trabajo, plantilla y solicitud de firma. Firma.dev lee primero el valor propio de la solicitud de firma. Cuando este es null, se aplica el valor del espacio de trabajo, y cuando el del espacio de trabajo también es null, se aplica el valor de la empresa. El valor predeterminado de la empresa es true, motivo por el cual nada cambia hasta que tú lo modifiques. Dos reglas de sincronización son clave una vez que esto esté en producción.

Las plantillas se copian en el momento de la creación

Una solicitud de firma creada a partir de una plantilla copia los valores de esta en el momento de su creación. Si pasas un valor en settings dentro de la llamada de creación, este anula a la plantilla, y si envías null allí, se hereda el del espacio de trabajo. Modificar la plantilla más adelante no afecta a las solicitudes ya creadas a partir de ella.

Los cambios en el espacio de trabajo y en la empresa se aplican a las solicitudes ya enviadas

Cualquier solicitud de firma cuyo propio valor sea null adoptará el cambio realizado en el espacio de trabajo o en la empresa, incluidas las solicitudes que ya estén en proceso de firma. Si cambias allow_decline a false en un espacio de trabajo activo, todas las solicitudes abiertas sin un valor propio perderán también el botón Rechazar... así que comprueba primero qué solicitudes están en curso.

Dónde encontrarlo en el panel de control

• Empresa: Ajustes > Ajustes de empresa, en Botones de la página de firma. Dos selectores configuran el valor predeterminado para cada espacio de trabajo.

• Espacio de trabajo: pestaña Ajustes del espacio de trabajo, en Botones de la página de firma. Elige Mostrar, Ocultar o Usar valor predeterminado de la empresa, y el cambio se guardará de inmediato.

• Plantilla y solicitud de firma: la pestaña de ajustes del documento en la barra lateral del editor, con Mostrar, Ocultar o Usar valor predeterminado del espacio de trabajo. Una solicitud de firma se puede modificar hasta que se envíe.

Ejecuta tu propio flujo de declinación dentro de tu producto

Cuando un firmante dice que no, muchos productos necesitan conocer el motivo. Una herramienta de ventas quiere registrarlo en la ficha de la oportunidad, una aplicación de préstamos necesita que un gestor devuelva la llamada y un marketplace quiere enviar una oferta actualizada. Con allow_decline: false, Firma.dev rechaza cualquier intento de declinación en la solicitud, de modo que el botón Rechazar de tu propia interfaz pasa a ser la única vía para que un firmante rechace el documento.

Un flujo habitual funciona de la siguiente manera:

1. Configura allow_decline: false en la solicitud de firma, en su plantilla o en el espacio de trabajo, e integra la página de firma en un iframe que apunte a https://app.firma.dev/signing/{signing_request_user_id}.

2. Coloca tu propio botón Rechazar junto al iframe. Cuando el firmante haga clic en él, abre tu propio cuadro de diálogo y solicita un motivo.

3. Envía ese motivo a donde corresponda: una nota en el CRM, una alerta para el gestor de cuentas o un ticket de soporte.

4. Desde tu backend, cancela la solicitud de firma adjuntando el motivo.

curl -X POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/SIGNING_REQUEST_ID/cancel \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Signer declined in app: pricing", "notify_signers": true}'

curl -X POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/SIGNING_REQUEST_ID/cancel \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Signer declined in app: pricing", "notify_signers": true}'

curl -X POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/SIGNING_REQUEST_ID/cancel \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Signer declined in app: pricing", "notify_signers": true}'

reason es opcional y está limitado a 500 caracteres. notify_signers está configurado como true de forma predeterminada, así que cámbialo a false si tu producto envía su propio mensaje al firmante. Cancelar funciona en solicitudes que hayan sido enviadas y que no estén ya finalizadas o canceladas; de lo contrario, devuelve un 409. La misma regla se aplica a los aprobadores, ya que ocultar Rechazar afecta a todos los participantes de la solicitud.

Firma.dev cumple con las leyes ESIGN Act, UETA, eIDAS (SES y AES) y el eIDAS del Reino Unido, y las firmas son legalmente vinculantes en más de 55 países con independencia de los botones que decidas mostrar.

Formularios de firma única

Un formulario de una sola página con una sola firma no requiere regresar más tarde... oculta «Guardar y completar más tarde» en esa plantilla y el firmante tendrá un botón menos en el que pensar.

Un mismo flujo de trabajo, diferentes reglas

Mantén la opción de rechazar activada como valor predeterminado de la empresa y desactívala en una sola plantilla... por ejemplo, en la aceptación de una política interna donde rechazar no forma parte del proceso. Todas las demás plantillas conservarán el botón.

Configúralo mediante la API

Los cuatro niveles admiten las mismas dos claves. El valor predeterminado de la empresa solo acepta true o false:

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/company/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_decline": true, "show_save_for_later": true}'

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/company/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_decline": true, "show_save_for_later": true}'

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/company/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_decline": true, "show_save_for_later": true}'

Una anulación a nivel de espacio de trabajo acepta null para recurrir al valor de la empresa:

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/WORKSPACE_ID/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_decline": false, "show_save_for_later": null}'

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/WORKSPACE_ID/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_decline": false, "show_save_for_later": null}'

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/WORKSPACE_ID/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allow_decline": false, "show_save_for_later": null}'

Por solicitud, las claves se introducen en settings en POST /signing-requests o POST /signing-requests/create-and-send. Este ejemplo utiliza los destinatarios de la plantilla porque no se pasa ninguno:

curl -X POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order form - Acme",
    "template_id": "TEMPLATE_ID",
    "settings": {"allow_decline": false, "show_save_for_later": false}
  }'

curl -X POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order form - Acme",
    "template_id": "TEMPLATE_ID",
    "settings": {"allow_decline": false, "show_save_for_later": false}
  }'

curl -X POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order form - Acme",
    "template_id": "TEMPLATE_ID",
    "settings": {"allow_decline": false, "show_save_for_later": false}
  }'

En PUT /signing-requests/{id}, el mismo objeto se ubica bajo signing_request_properties.settings, y en PUT /templates/{id} bajo template_properties.settings. POST /templates y las rutas PATCH admiten settings en el nivel superior. Cualquier valor distinto de true, false o null devuelve un error 400 VALIDATION_ERROR indicando la clave, y no se guarda ningún cambio. La tabla completa de rutas se encuentra en el registro de cambios de la API para la versión v1.40.0.

También en la versión v1.40.0: Un error 413 claro para solicitudes que superan el tamaño límite

Los cuerpos de solicitud que superan los 6 MiB ahora devuelven un error 413 REQUEST_TOO_LARGE con el formato estándar de error y code. Anteriormente, la pasarela respondía con un 502, lo que ofrecía muy poca información sobre lo que había fallado. Para archivos más grandes, solicita una URL de subida con POST /documents, sube el archivo a ella y pasa document_id o document_ids en tu llamada de creación.

En resumen, la versión v1.40.0 te permite ocultar «Rechazar firma» y «Guardar y completar más tarde» a nivel de empresa, espacio de trabajo, plantilla o solicitud. Ocultar la opción de rechazo es de obligado cumplimiento, y el endpoint de cancelación proporciona a tu propio flujo de declinación una forma limpia de cerrar la solicitud. Y todo esto se suma al logotipo, los colores, las etiquetas, las condiciones para el firmante, los correos electrónicos y la página de finalización que ya controlas.

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