Entorno de pruebas (sandbox)
Firmatia ofrece un entorno de pruebas en sandbox.firmatia.es para que los equipos técnicos puedan integrar la API y probar el flujo de firma sin coste y sin riesgo. Es un entorno separado de producción, con sus propias cuentas, tokens y base de datos.
Lo que debe saber
- El sandbox es solo para pruebas: está prohibido usarlo para operaciones reales. Los documentos de firma simple se marcan con la leyenda «SANDBOX» y llevan un sello de tiempo no cualificado. Los de firma avanzada los firma el prestador y no llevan esa leyenda: el aviso de que son pruebas aparece en la página de firma y en los correos. Firmatia no custodia estos documentos, no conserva sus evidencias más allá de los treinta días y no responde de ningún uso real que se haga de ellos.
- Los datos de cada sobre se borran automáticamente a los 30 días de crearse el sobre: el propio sobre, sus documentos, sus firmantes y sus evidencias. Si usted genera una exportación desde el panel, esa exportación se borra a los siete días de generarla, por lo que puede conservar datos de un sobre ya borrado hasta que le llegue su propio plazo. Pasados esos plazos los datos no se pueden recuperar. Firmatia borra de forma automática todo lo anterior; si un borrado falla, queda registrado y se resuelve a mano.
- El sandbox solo debe utilizarse con datos ficticios o con datos de las propias personas que realizan las pruebas; no debe introducirse en él ningún documento real ni datos de terceros. Los correos que envía el sandbox llevan el prefijo «[PRUEBA]» en el asunto y salen desde un remitente distinto al de producción.
- En el sandbox no se envían SMS: las invitaciones a firmar y los códigos de verificación llegan siempre por correo electrónico, aunque se indique un teléfono.
- Hay un límite diario de 50 envíos por empresa para evitar usos abusivos. Si necesita más volumen para una prueba concreta, escríbanos.
- Los documentos que suba no pueden superar los 5 MB, y cada empresa dispone de hasta 500 MB de documentos. Mientras un sobre no está firmado, se le reserva espacio para su versión firmada. Si necesita documentos más grandes o más espacio para una prueba concreta, escríbanos.
- El acceso se concede previa solicitud a través del formulario de contacto de firmatia.es. Las credenciales del sandbox no sirven en producción: cuando pase a producción se le creará una cuenta nueva en firmatia.es y solo tendrá que cambiar la URL base y el token.
Diferencias con producción
| Sandbox | Producción | |
|---|---|---|
| URL base de la API | https://sandbox.firmatia.es/api/v1 |
https://firmatia.es/api/v1 |
| Finalidad | Solo pruebas, sin uso real | Servicio real conforme a eIDAS |
| Sello de tiempo | No cualificado | Cualificado (prestador de la lista de confianza de la UE) |
| Conservación | 30 días | Según contrato |
| Tamaño del documento | Documentos de hasta 5 MB | Según la plataforma |
| Límite de envíos | 50 sobres al día por empresa | Sin límite diario |
| Almacenamiento | 500 MB de documentos por empresa | Según contrato |
| Coste | Gratuito | Según bono contratado |
| Envío de SMS | No (todo por correo) | Solo en las empresas que tienen activado el envío de SMS |
Cabecera X-Firmatia-Environment (API) y campo environment (webhooks) |
sandbox |
production |
Para cualquier duda sobre el sandbox escriba a hola@firmatia.es. El tratamiento de datos en el entorno de pruebas se rige por la Política de privacidad.
Versión 6 · actualizado el 2/10/2026