Pruebas en sandbox
Pruebas en sandbox
El modo Sandbox de Soyio te permite probar tus integraciones de forma segura antes de activarlas en producción. Este entorno simula el comportamiento real de la plataforma, pero sin generar registros auditables ni producir efectos legales sobre identidades, consentimientos o solicitudes de derechos.
Objetivo del modo sandbox
El entorno sandbox está diseñado para que tu equipo técnico y funcional pueda:
- Probar la integración de la API y componentes de Soyio.
- Validar el comportamiento de los flujos de consentimiento, gestión de derechos, validación de identidad y autenticación.
- Ajustar configuraciones, plantillas y procesos antes del despliegue productivo.
- Ver cómo se generan evidencias y registros sin afectar datos reales.
Ninguno de los registros creados en sandbox tiene validez legal ni se replica en producción.
URL base del entorno Sandbox
Utiliza la siguiente URL base para realizar las pruebas en sandbox:
https://sandbox.soyio.id
Cada llamada a la API debe autenticarse con una API Key de sandbox, que siempre comienza con el prefijo ak_sandbox_.
Modelos compartidos entre entornos
Algunos objetos de configuración se comparten entre los entornos de sandbox y producción. Esto permite mantener una estructura coherente mientras separas los registros de prueba y los registros reales.
Los modelos compartidos incluyen:
- Configuración de compañía: datos generales y configuración de seguridad
- Estructura organizacional: sucursales, filiales, productos o unidades que agrupan tus flujos
- Configuración de apariencia y comportamiento: logo, colores, estilos de íconos, obligatoriedad, etc.
- Plantillas (templates): definiciones de consentimientos, formularios o documentos usados en los flujos
Estos objetos existen en un espacio común, accesible desde ambos entornos. Sin embargo, los registros generados por las interacciones de los usuarios (por ejemplo, consentimientos otorgados, validaciones de identidad o solicitudes de derechos) se crean únicamente en el entorno activo (sandbox o producción).
Los webhooks son la excepción: se configuran por ambiente, así que debes crearlos por separado en sandbox y en producción. Revisa Webhooks por ambiente.
Esto garantiza que:
- Puedas diseñar y probar tus plantillas y procesos en un entorno seguro.
- Los registros reales y de prueba se mantengan completamente separados.
- No se mezclen evidencias o consentimientos simulados con los registros auditables.
Validar flujos completos
Antes de pasar a producción, ejecuta pruebas integrales en sandbox para revisar:
- El flujo completo de tus integraciones.
- La recepción de callbacks o webhooks en tu infraestructura.
- La correcta generación de evidencias según tus flujos esperados (no auditables en sandbox).
- Logs y respuestas de la API ante distintos escenarios de error o validación.
Transición a producción
Cuando tus pruebas estén completas y tu integración validada, podrás solicitar la activación del entorno productivo.
Consulta la guía Paso a Producción para conocer el checklist y las recomendaciones finales antes del despliegue.
RUTs de prueba para verificación gubernamental
En sandbox puedes usar RUTs específicos para simular distintos resultados de la verificación gubernamental. Esto aplica tanto a la verificación gubernamental vía API como a los formularios de consentimiento con validación gubernamental.
| RUT | Resultado | Error |
|---|---|---|
11111111-1 | failed | auth-076 / document_not_valid — documento no vigente |
22222222-2 | failed | auth-074 / invalid_document_number — número de documento inválido |
33333333-3 | failed | auth-075 / government_api_error o auth-077 / document_mismatch_or_government_api_error — error del Registro Civil |
Con el proveedor por defecto (eCert), 33333333-3 retorna document_mismatch_or_government_api_error (auth-077). Con certificadora_del_sur, retorna government_api_error (auth-075).
Cualquier otro RUT con formato válido retornará una verificación exitosa (successful).
En sandbox solo esos tres RUTs fallan. Si un formulario de prueba "acepta cualquier RUT", es el comportamiento esperado del entorno, no una falta de validación.