Sandbox es el entorno de pruebas junto a Producción: cada proveedor está simulado, no se factura nada y puedes forzar el resultado que necesites.
Cambia la consola a Sandbox con el selector que hay bajo el nombre de tu aplicación, crea ahí una clave de API de sandbox y úsala. Cada comprobación queda simulada, no se factura nada y puedes forzar el resultado que quieras. Sandbox mantiene sus propios datos, claves, webhooks y listas, separados de Producción.
El sandbox de Didit es el equivalente a las tarjetas de prueba de un proveedor de pagos: te permite reproducir cualquier resultado de verificación bajo demanda, sin llamar a proveedores reales, sin manejar datos personales reales y sin tocar tu saldo.
#Sandbox es su propio entorno
Esta es la parte que confunde a la mayoría de la gente. Producción y Sandbox son entornos separados: Sandbox es la aplicación de prueba compartida de tu organización, con sus propias verificaciones, claves de API, webhooks y listas, así que el tráfico de prueba y los datos de producción nunca se mezclan. Una franja en la parte superior de cada página de la consola te indica cuándo estás en Sandbox.
- Cambia a Sandbox
Haz clic en Sandbox en el selector que hay bajo el nombre de tu aplicación, en la parte superior de la barra lateral. Volver es deliberado: al elegir Producción primero aparece una breve lista Antes de cambiar a Producción (publicar un flujo de trabajo, crear una clave de API o un enlace de producción, probar tu webhook, confirmar cómo pagas, revisar la retención de datos) y después Cambiar a Producción o Seguir en Sandbox.
- Crea una clave de API de sandbox
Abre Desarrolladores → Claves de API y crea una clave, o elige Sandbox como entorno al crearla. Una clave de producción nunca crea una sesión de sandbox; la clave decide el entorno.
- Crea o copia un flujo de trabajo
Sandbox tiene sus propios flujos de trabajo. Crea el flujo que quieras probar, o cópialo desde Producción.
- Crea sesiones con normalidad
Mismo endpoint, mismo flujo de código. La única diferencia es qué clave envías.
Si Sandbox aparece en gris en el selector, tu organización todavía no tiene una aplicación Sandbox. Pide a soporte que la active: es un ajuste a nivel de cuenta, no algo que hayas configurado mal.
#Qué cambia sandbox, y qué no
| Sandbox | Producción | |
|---|---|---|
| Proveedores externos | Todos simulados: nunca se llama a ningún tercero | Reales |
| Facturación | Nunca se factura; se omite la comprobación de saldo | Se factura por función completada |
| Límite de creación de sesiones | 500 cada 24 horas | Tu saldo |
| Carga útil del webhook | "environment": "sandbox" | "environment": "live" |
| Datos extraídos y estado | Simulados por el escenario que elijas | Derivados de la captura real |
| Medios capturados | Se almacenan de verdad, exactamente igual que en una sesión real | Se almacenan |
Sandbox almacena los medios que captura: documentos, selfie, vídeo de prueba de vida, archivos de comprobante de domicilio, exactamente igual que lo haría una sesión real. El resultado está simulado, pero la subida es real, así que usa los documentos de muestra y los datos de prueba que ofrece el flujo en lugar de un documento de identidad real o información personal real.
Como los resultados nunca dependen de los píxeles, una foto deliberadamente mala no producirá un rechazo en sandbox. El escenario es quien decide.
Lo mismo se aplica a los campos extraídos: sandbox siempre devuelve datos de identidad de muestra (nombre, fecha de nacimiento, número de documento), sea cual sea el documento que escanees. Ver la imagen de tu pasaporte real en la consola junto a los datos de otra persona es el comportamiento esperado de sandbox, no un fallo del OCR, y cualquier tipo de documento "se escanea" correctamente independientemente de lo que hayas seleccionado. También significa que los flujos de chip que vuelven a derivar las claves a partir de los datos impresos (NFC BAC) no se pueden probar con un documento real en sandbox: los campos de OCR simulados no coincidirán con tu chip.
#Elegir el resultado
Pasa un slug de escenario como sandbox_scenario al crear la sesión, o deja que la persona que prueba elija uno: las sesiones de sandbox en el flujo alojado muestran un selector de escenario dentro de la tarjeta antes de que empiece la captura, además de una franja de documentos de muestra bajo el componente de subida y un aviso permanente de "solo datos de prueba".
Los escenarios cubren los resultados que realmente necesitas para probar tu integración:
| Quieres probar | Escenario |
|---|---|
| Todo se aprueba | approve |
| Documento caducado | decline_document_expired |
| Documento ilegible | decline_could_not_recognize_document |
| Fallo de suma de comprobación del MRZ | decline_mrz_validation |
| Por debajo de la edad mínima | decline_minimum_age |
| Coincidencia facial demasiado baja | decline_face_match_low_similarity |
| Ataque de suplantación en la prueba de vida | decline_liveness_attack |
| Coincidencia con sanciones / PEP en AML | decline_aml_hit |
| Dirección IP bloqueada | decline_ip_blocklist |
| Discrepancia de dirección en el comprobante de domicilio | decline_poa_address_mismatch |
| Fallo de integridad del chip NFC | decline_nfc_chip_not_verified |
| La validación de base de datos no encuentra nada | decline_database_no_match |
| Necesita revisión manual (AML) | review_aml_possible_match |
| Necesita revisión manual (coincidencia facial límite) | review_face_match_borderline |
| Necesita revisión manual (coincidencia parcial de dirección) | review_poa_partial_match |
| Discrepancia con el registro en KYB | decline_kyb_registry_mismatch |
Los escenarios review_* existen para que puedas ejercitar todo el flujo de revisión manual (la cola de revisión de la consola, el webhook de In Review, un revisor aprobando o pidiendo un reenvío) sin necesitar una entrada que provoque un rechazo.
El catálogo en vivo de escenarios y valores mágicos lo sirve la propia API en
GET /v1/sandbox/scenarios/. Si algún slug de aquí llega a quedar desactualizado,
confía en el endpoint. Referencia completa: pruebas en sandbox.
#Distinguir los dos entornos en tu propio código
Cada webhook lleva un campo environment: "sandbox" o "live". Actúa según eso en lugar de intentar deducir el entorno a partir de la clave, y nunca confundirás una sesión de prueba con un cliente real.
#Lo que sandbox no hará
- No devolverá datos de registro reales de una empresa real. El KYB de sandbox usa respuestas de registro simuladas.
- No enviará un SMS ni un correo real. La verificación de teléfono y correo electrónico están simuladas, así que no puedes usar sandbox para comprobar la entregabilidad real de los mensajes.
- No consumirá el crédito mensual de tu plan, lo que también significa que una ejecución en sandbox no te dice nada sobre el crédito que te queda.
#Si necesitas verificaciones de prueba reales
Algunas cosas requieren genuinamente una llamada real: comprobar que el servicio de base de datos de un país concreto está aprovisionado para ti, o confirmar la entrega de un SMS a un operador concreto. Eso necesita una pequeña recarga en una aplicación de producción en lugar de sandbox. Pregunta a soporte antes de gastar en ello, para que puedan confirmar primero que el servicio está realmente activado en tu cuenta.
¿Sigues atascado? Habla con una persona.
Incluye el ID de tu organización y el ID de la sesión sobre la que preguntas.