Skip to main content
El sandbox de Therius es un entorno de pruebas totalmente aislado — las solicitudes llegan a un stub de proveedor de prueba, no se mueve dinero real y no interviene ninguna red de tarjetas. Tu clave de sandbox comienza con prv_sandbox_... y toda cuenta de Therius incluye una por defecto. Todo lo que construyas aquí funciona de forma idéntica en producción; solo cambias la clave y la URL base cuando estés listo para salir a producción.
El encabezado Idempotency-Key es obligatorio en producción. Reintentar un timeout de red sin él puede cobrarle dos veces a un cliente. Los ejemplos siguientes lo incluyen para que adoptes el hábito desde el principio.

​
Pasos

1

Obtén una clave de sandbox

Inicia sesión en tu panel de Therius y copia la clave etiquetada como Sandbox Secret Key. Se ve así: prv_sandbox_xxxxxxxxxxxx.Toda solicitud a https://api-sandbox.therius.io/v1 envía esta clave como Authorization: Bearer prv_sandbox_.... El prefijo de la clave (prv_sandbox_) le indica a Therius que enrute la solicitud al entorno de sandbox automáticamente — sin configuración adicional.
2

Realiza tu primera compra

Pega el siguiente comando en tu terminal, reemplazando prv_sandbox_your_key_here por tu clave de sandbox real.
Algunas cosas a tener en cuenta sobre esta solicitud:
  • Tarjetas de prueba — 4111111111111111 siempre resulta en una aprobación de sandbox. Usa 4000000000000002 para simular un rechazo.
  • amount.value siempre va en unidades menores. 1999 significa $19.99 en USD. Para monedas sin decimales como JPY o CLP, 1999 significa ¥1999.
  • amount.exponent es la cantidad de posiciones decimales: 2 para USD/EUR, 0 para JPY/CLP.
Una respuesta exitosa se ve así:
Guarda el id — es el identificador de este pago, usado como el segmento de ruta {id} para capturar, reembolsar y cancelar. (paymentCode es una referencia para consultas y conciliación.)
3

Consulta el pago

Recupera cualquier pago pasando su id (o su paymentCode) a GET /payment/inquiry/{id}.
La respuesta devuelve la misma estructura PaymentResponse que la compra original, incluido el status actual y todos los detalles del monto.
4

Tokeniza una tarjeta

Para guardar una tarjeta para un cliente que regresa, agrega "tokenize": true y un shopper.id a tu solicitud de compra. Therius almacena la tarjeta en su bóveda y devuelve un token en la respuesta.
La respuesta incluye un campo token (p. ej., vt_abc123). En solicitudes futuras para este cliente, pasa card.tokenData.token en lugar de card.cardData — sin necesidad del número de tarjeta.
5

Sal a producción

Cuando estés listo para aceptar pagos reales, haz dos cambios:
  1. Reemplaza prv_sandbox_... por tu clave de producción prv_production_....
  2. Dirige tus solicitudes a https://api.therius.io/v1 en lugar de https://api-sandbox.therius.io/v1.
No se requiere ningún otro cambio de código. El prefijo de la clave selecciona el entorno automáticamente.
Confirma que toda solicitud que modifica datos en tu código de producción envía un encabezado Idempotency-Key antes de salir a producción.

​
Qué sigue

Referencia de API

Explora cada endpoint — compra, autorización, captura, reembolso, cancelación, suscripciones y más.

SDK de JS

Incorpora un formulario de tarjeta seguro para PCI en tu frontend sin que los datos de tarjeta sin cifrar pasen por tu servidor.

Conexiones

Conecta adquirentes, procesadores y proveedores de pago alternativos a tu cuenta de Therius.

Webhooks

Recibe eventos de pago y suscripción en tu servidor, con verificación de firma.

Pruebas

Cada tarjeta de prueba de sandbox, motivo de rechazo y escenario de 3D Secure en una sola tabla.