Sandbox

Cada cuenta de FINORA KYC puede tener un gemelo sandbox con sus datos separados. Se usa con credenciales kyc_test_… sobre la misma URL, https://kyc.finoracore.com: no hay otro host ni otra versión del API.

Nunca uses datos reales en sandbox

Usa nombres, documentos y fotos de prueba. El sandbox existe para probar tu integración, no para verificar personas.

Qué cambia en sandbox

	Producción (kyc_live_)	Sandbox (kyc_test_)
Datos	Tu cuenta real	Gemelo separado
Destinos de webhook	Solo https a direcciones públicas	También http y destinos en tu red local
Cabecera en cada entrega	—	X-Finora-Sandbox: true
Campo sandbox del evento	false	true
URL de retorno del enlace alojado	Solo https	También http
X-Kyc-Sandbox-Resultado	422 SIMULACION_SOLO_SANDBOX	Simula la selfie

Simular la selfie

La comparación facial y la prueba de vida automáticas están Próximamente. Para probar los dos caminos de tu integración, envía la cabecera X-Kyc-Sandbox-Resultado al subir la selfie:

curl -s -X POST "$KYC_BASE/v1/casos/$CASO/selfie" \
  -H "X-API-Key: $KYC_API_KEY" -H "Idempotency-Key: selfie-1001" \
  -H "X-Kyc-Sandbox-Resultado: PASA" \
  -F selfie=@selfie-prueba.jpg

Valor	Efecto
PASA	Registra las verificaciones LIVENESS y SELFIE_ROSTRO con resultado PASA.
FALLA	Las registra con resultado FALLA.
Otro valor	422 SIMULACION_INVALIDA.

Las verificaciones simuladas se ven en el caso con detalle.simulado = "true":

{
  "tipo": "LIVENESS",
  "estado": "COMPLETADA",
  "resultado": "PASA",
  "detalle": { "simulado": "true", "origen": "X-Kyc-Sandbox-Resultado" }
}

La simulación solo afecta a esas dos verificaciones: nunca decide el caso. La aprobación o el rechazo siguen siendo de una persona en la consola del sandbox.

Recorrido de prueba completo

1. Registra un destino de webhook que apunte a tu equipo.
2. Crea un caso con datos ficticios y sube un documento de prueba.
3. Sube la selfie con X-Kyc-Sandbox-Resultado: PASA; repite con otro caso y FALLA.
4. Envía el caso, decídelo en la consola del sandbox y verifica que tu servidor recibe caso.decidido con una firma válida.
5. Apaga tu servidor, decide otro caso y comprueba que los reintentos y la conciliación funcionan.

¿Necesitas credenciales de sandbox? Escribe a contacto@finoracore.com.