Sandbox y modo sombra

Sandbox

Las llaves de prueba (sk_test_…) usan los mismos módulos que producción. Su uso, casos, dispositivos y webhooks van en un entorno separado y no se mezclan con los de live. Las reglas, las listas y la configuración (umbrales) también son de cada entorno: lo que cambies con una llave de prueba no afecta a live, y al revés. Prueba tus reglas y listas en test y, cuando estén listas, cárgalas también con una llave live.

Para probar cada resultado sin datos personales reales, usa estos valores mágicos:

Envía Obtienes
user_id que empieza con sandbox_review_ Razón SANDBOX_REVIEW (peso 50): decisión review como mínimo
user_id que empieza con sandbox_decline_ Razón SANDBOX_DECLINE (peso 100): decisión decline
Nombre Sancho Sandbox Sancionado con screening Coincidencia en sanciones (match, lista sandbox)
Nombre Pepa Pruebas Expuesta con screening Coincidencia PEP (lista sandbox)

Las demás señales siguen funcionando y se suman: un sandbox_review_ con correo desechable puede terminar en decline.

curl -s "$SAFEGATE_URL/v1/score" \
  -H "Authorization: Bearer $SAFEGATE_KEY" -H "Content-Type: application/json" \
  -d '{"event_type": "withdrawal", "user_id": "sandbox_review_42",
       "screen": true, "person": {"full_name": "Pepa Pruebas Expuesta"}}'

Con esto puedes probar de punta a punta: la cola de casos del panel, los webhooks score.review, score.decline y screening.match, y el manejo de cada decisión en tu código.

En llaves de producción estos valores no tienen ningún efecto especial.

Modo sombra

Antes de dejar que Safegate bloquee a jugadores reales, haz un piloto en modo sombra:

  1. Llama a /v1/score con tu llave live en cada evento, igual que en producción.
  2. No actúes sobre decision todavía: registra la respuesta y sigue tu flujo actual.
  3. Envía etiquetas cuando confirmes un fraude, un contracargo o un abuso de bono.
  4. Después de unas semanas comparamos juntos las decisiones contra las etiquetas: cuántos casos malos habría detenido y cuántos jugadores buenos habría molestado.
  5. Cuando los números te convenzan, empieza a actuar sobre review y decline.

Las reglas nuevas también pueden correr en sombra ("mode": "shadow"): se evalúan y se registran, pero no cambian el score. Así pruebas una regla con tráfico real antes de activarla.