Skip to main content
Therius enruta cada solicitud al entorno de sandbox o al de producción basándose únicamente en el prefijo de la clave de API que envías. No hay indicador de entorno, ni opción de inicialización del SDK aparte, ni archivo de configuración que cambiar. Cuando estés listo para salir a producción, cambias el prefijo de la clave y actualizas la URL base — nada más.

​
Sandbox

El entorno de sandbox es un entorno de pruebas totalmente aislado respaldado por un stub de proveedor de prueba. No interviene ninguna red de tarjetas real, no se mueve dinero real y no se cobra a cuentas reales. Úsalo libremente durante el desarrollo y en los pipelines de pruebas automatizadas.

​
Tarjetas de prueba de sandbox

Usa cualquier fecha de vencimiento futura, cualquier nombre de titular y cualquier CVV de 3 dígitos (4 dígitos para Amex).

Referencia completa de pruebas

Cada tarjeta de prueba por red, escenarios de rechazo por motivo, el recorrido completo de 3D Secure y las respuestas de APM en sandbox.

​
Producción

El entorno de producción procesa pagos reales sobre redes de tarjetas en vivo. Cada cobro es real, cada reembolso afecta a cuentas reales y cada transacción rechazada es una decisión real del emisor.

​
Sandbox vs. producción de un vistazo

​
Cambiar de entorno

Para pasar de sandbox a producción, haz dos cambios en tu configuración:
  1. Reemplaza prv_sandbox_... por prv_production_... (y pub_sandbox_... por pub_production_...).
  2. Actualiza la URL base de https://api-sandbox.therius.io/v1 a https://api.therius.io/v1.
No se requiere ningún otro cambio de código. Los mismos cuerpos de solicitud, las mismas estructuras de respuesta y las mismas rutas de endpoint funcionan en ambos entornos.
Antes de cambiar a producción, verifica que toda solicitud que modifica datos en tu código envía un encabezado Idempotency-Key. En el sandbox es opcional; en producción es obligatorio para evitar cobros duplicados en los reintentos de red.

​
El encabezado X-Environment

La mayoría de las llamadas a la API se autentican con una clave, y el prefijo de la clave determina el entorno. Sin embargo, algunos flujos — como GET /payment/inquiry/{id} alcanzado desde el flujo de reanudación de pending_3ds — pueden llamarse sin clave. En esos casos, envía el encabezado X-Environment para indicarle a Therius a qué entorno enrutar la solicitud.
Los valores válidos son sandbox y production. Cuando incluyes una clave de API, no necesitas este encabezado — el prefijo de la clave tiene precedencia.