Descargas

Colección para Hoppscotch

Prueba todos los endpoints de la API desde Hoppscotch, un cliente HTTP gratuito que funciona en el navegador. La colección ya trae los headers, los cuerpos de ejemplo y pruebas automáticas que validan cada respuesta.

Colección

Peticiones de consulta, venta y estado de transacción.

CTC-API-docs.json

Entornos

CTC · Sandbox y Producción, con todas las variables necesarias.

environment.json

---

Cómo importarla

1. Descarga los dos archivos de arriba.
2. En Hoppscotch, abre Colecciones → Importar → Hoppscotch y selecciona CTC-API-docs.json.
3. Abre Entornos → Importar → Hoppscotch, selecciona hoppscotch-ctc-env.json y activa CTC · Sandbox.
4. Edita el entorno y llena las variables de la tabla de abajo. Como mínimo: host y apiKey.
5. Ejecuta GET Catálogo de productos ★ para comprobar tu acceso. Después puedes consultar tu saldo y hacer ventas.

---

Qué incluye

Carpeta	Petición	Endpoint
01 · Consultas	GET Catálogo de productos ★	GET /api/v1/tae/products
01 · Consultas	GET Saldo ★	GET /api/v1/tae/balance
02 · Ventas	POST Recarga TAE ★	POST /api/v1/tae/do-transaction
02 · Ventas	POST Pago de servicio	POST /api/v1/tae/do-transaction
02 · Ventas	POST Venta de PIN	POST /api/v1/tae/do-transaction
02 · Ventas	POST Venta de eSIM	POST /api/v1/tae/do-transaction
03 · Estado de transacción	GET Consultar estado por folio ★	GET /api/v1/tae/check-transaction/:folio

Las peticiones marcadas con ★ son las del flujo básico.

---

Variables del entorno

Variable	Se llena	Descripción
host	A mano	Dominio de la API, sin /api/v1. Te lo proporciona CTC.
apiKey	A mano	Tu API Key (ctc_...). Secreta.
folioPrefix	Opcional	Prefijo de los folios generados. Por defecto API.
phone	A mano	Celular a 10 dígitos para recargas y pines (en eSIM, teléfono de contacto).
taeAmount	A mano	Monto de la recarga. Debe ser un monto autorizado para el producto.
serviceReference	A mano	Referencia del recibo para el pago de servicio.
serviceAmount	A mano	Importe del pago de servicio (hasta 2 decimales).
pinAmount	A mano	Denominación del pin.
esimAmount, customerName, customerEmail	A mano	Solo para la venta de eSIM.
carrierId, serviceCarrierId, pinCarrierId, esimCarrierId	Automático	Productos a vender. Los guarda la petición de catálogo.
folio	Automático	Folio de la última venta.
transactionId	Automático	transaction_id de la última venta exitosa.