Entorno de pruebas
Claves de API de sandbox para verificación de identidad.
Una clave de sandbox ejecuta la misma API, la misma página alojada y el mismo flujo de webhook que producción, con una clave que nunca se factura. Es la forma más rápida de ver si ShieldID se ajusta a sus necesidades antes de hablar de precios.
Cómo funciona
Mismo proceso. Distinta clave. Sin factura.
El sandbox no es un modo de demostración simplificado: es el proceso de verificación real, diferenciado únicamente por la clave que usted envíe.
| Prefijo de la clave | vk_sand_… identifica una clave de sandbox en el momento de la autenticación. No hay una cuenta ni un panel de sandbox separados que configurar. |
|---|---|
| Marca de entorno | Cada sesión, resultado y webhook creado con una clave de sandbox lleva environment: "sandbox", de modo que nada creado en sandbox pueda confundirse con una verificación real más adelante. |
| Facturación | Las sesiones de sandbox nunca se facturan, en todos los planes, sin importar cuántas necesite para desarrollar y probar su integración. |
| La verificación en sí | Real: su propio documento, su propio rostro, las mismas comprobaciones. No hay un conjunto separado de documentos de prueba falsos: usted se verifica a sí mismo para ver cómo se comporta el producto. |
Cómo obtener una clave
Solicítela hoy. El autoservicio está en camino.
La creación de claves de sandbox en autoservicio en los planes que califiquen está prevista, pero aún sin fecha. Mientras tanto, una solicitud mediante el formulario de contacto le da una clave directamente.
Hoy
Cuéntenos en el formulario de contacto un poco sobre lo que está construyendo y le entregaremos una clave de sandbox; la mayoría de las solicitudes, el mismo día hábil.
Próximamente
PróximamenteLa creación de claves de sandbox en autoservicio, en los planes que califiquen, está prevista pero aún sin fecha, para que pueda generar una clave en el momento en que se registre.
Pruébelo usted mismo
Escenarios de prueba que puede ejecutar en su propio teléfono.
No se necesitan documentos falsos: ejecute estos escenarios con su propio documento de identidad para ver cómo se comporta cada ruta.
Una aprobación limpia
Cree una sesión, abra la página alojada, fotografíe su propio documento de identidad y complete el desafío de prueba de vida. Observe cómo checks.document, checks.liveness, checks.antispoof y checks.face_match devuelven PASS.
Una cámara rechazada
Niegue el permiso de la cámara cuando la página alojada lo solicite. La sesión se resuelve en FAILED con un failure_reason con el que puede construir un mensaje de error real.
Un reintento tras un fallo (próximamente)
Reabrir el verification_url de una sesión FAILED para restablecerla a PENDING y permitir un segundo intento aún no está disponible. Hoy, trate FAILED como estado final: cree una nueva sesión si el solicitante desea intentarlo de nuevo.
Una sesión expirada
Cree una sesión y no la toque. Pasado el plazo predeterminado, pasa a EXPIRED, sin datos de persona ni de comprobaciones: un buen estado para probar los mensajes de tiempo de espera de su interfaz.
Una sesión cancelada
Llame a DELETE /v1/sessions/{id} sobre una sesión PENDING y luego intente abrir verification_url. Confirme que su aplicación trata una sesión cancelada como finalizada, no como un error.
Idioma francés
Cree una sesión con locale: "fr" y confirme que la página alojada y su propio manejo de la URL de retorno se lean correctamente para un solicitante francófono.
Límites
Lo que el sandbox no hace.
Respuestas claras, sin letra pequeña.
- El sandbox no tiene un límite de frecuencia distinto del de producción: actualmente ninguna solicitud se limita por restricciones a nivel de plan; esa aplicación aún no está activa.
- Sandbox y producción se separan únicamente por el prefijo de la clave, no por cuentas, paneles ni conjuntos de documentos distintos.
- Una sesión de sandbox es una verificación real de un documento real. No use el documento de identidad de otra persona para probar: verifique el suyo.
Preguntas
Preguntas frecuentes del entorno de pruebas (sandbox).
Obtener una clave
Solicite una clave de sandbox.
Cuéntenos qué está construyendo y le conseguiremos una clave para empezar a probar.
Las sesiones en el entorno de pruebas (sandbox) nunca se facturan.