Saltar al contenido principal
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

Las llamadas a la API se autentican con una clave (o, desde el navegador, un clientToken de corta duración), y la credencial determina el entorno: el prefijo de la clave (prv_sandbox_ o prv_production_) o el entorno para el que se emitió el clientToken. Esto incluye GET /payment/inquiry/{id}, que requiere una clave privada o un clientToken y ya no acepta solicitudes sin autenticación.
Los valores válidos del encabezado X-Environment son sandbox y production, pero cuando incluyes una clave de API no lo necesitas — el prefijo de la clave tiene precedencia.