Skip to main content
El sandbox de Therius (https://api-sandbox.therius.io/v1, claves prv_sandbox_...) es un entorno totalmente aislado. Las solicitudes son manejadas por el proveedor de sandbox de Therius integrado, que simula respuestas sin tocar una red de tarjetas — no se mueve dinero real. Esta página lista los datos de prueba que impulsan cada resultado simulado.
Los números de tarjeta de abajo se aplican al proveedor de sandbox de Therius integrado. Si has configurado un proveedor real en modo sandbox/test (por ejemplo, claves de test de Stripe), en su lugar se aplica el conjunto de tarjetas de prueba propio de ese proveedor — usa los números de su documentación.

​
Usar las tarjetas de prueba

  • Envía la solicitud con una clave prv_sandbox_..., o agrega el encabezado X-Environment: sandbox.
  • Usa cualquier vencimiento futuro (por ejemplo 12/29) y cualquier CVV de 3 dígitos (por ejemplo 123).
  • American Express requiere un CVV de 4 dígitos (por ejemplo 1234).

​
Aprobaciones

​
Rechazos

Cada uno de estos números de tarjeta devuelve un estado declined con un refusalCode correspondiente — ver Pagos rechazados para la referencia completa de códigos.

​
3D Secure

3DS se habilita por ruta, no por tarjeta — la decisión de step-up la toma un paso de 3D Secure en el pipeline de enrutamiento. La ruta de sandbox sembrada por defecto envía los BIN de abajo a través del simulador de 3DS integrado y luego al gateway de sandbox, así que estas tarjetas funcionan sin configuración.

​
Recorrer la tarjeta de desafío

1

Envía el purchase

Cobra 4000002500003155. La respuesta es:
2

Envía al comprador a la URL del desafío

Redirige a actionRequired.url. El simulador de sandbox trata el desafío como completado al instante — no se requiere interacción.
3

Reanuda el pago

Llama a POST /payment/resume con { "sessionId": "..." } y tu encabezado Authorization: Bearer prv_sandbox_... — el prefijo prv_sandbox_ enruta al sandbox. Las sesiones son de un solo uso y expiran después de 15 minutos. Un resume exitoso devuelve el PaymentResponse final con status: "captured".
El gateway de sandbox rechaza los dos BIN de 3DS (40000032200, 40000025000) si llegan sin datos de ECI/CAVV — así que una aprobación demuestra que el handoff de 3DS realmente ocurrió, en vez de que el paso se saltara silenciosamente.

​
Métodos de pago alternativos

Envía un bloque apm en lugar de card. No se necesita ningún número de tarjeta. Cada método devuelve una respuesta de sandbox determinista:

​
Suscripciones en el sandbox

  • Crea una suscripción con cualquier tarjeta de aprobación de arriba. Se almacena en la base de datos del sandbox, totalmente separada de producción.
  • El worker de gestión de cobros procesa las suscripciones de sandbox según el calendario del sandbox.
  • Las entregas de webhook para eventos de sandbox se escriben en el log de entregas del sandbox y se marcan con "environment": "sandbox" en la carga.

​
Idempotencia en el sandbox

El encabezado Idempotency-Key es opcional en el sandbox pero se comporta exactamente como en producción — reintentar con la misma clave devuelve la primera respuesta cacheada. Adquiere el hábito aquí para que tu código de producción ya sea correcto. Ver Idempotencia.