Documentación de eSIMTrade
api.esimtrade.com
Documentación práctica y clara de la API para revendedores.
Empieza por la autenticación, comprueba el saldo, consulta los planes y después trabaja con pedidos e inventario. Cada página de ruta explica la autenticación, los campos de la solicitud, la respuesta y ejemplos que puedes copiar.
Empieza aquí
1
Autenticación
Crea un par de código de acceso y clave secreta en el portal para revendedores.
2
Comprueba las consultas
Verifica el saldo, los planes y el perfil antes de realizar operaciones.
3
Haz pedidos
Envía una compra solo después de confirmar el slug del plan y el saldo disponibles.
Recomendado
Introducción
Resumen, inicio rápido, modelo de autenticación y acceso a la documentación pública de la API de eSIMTrade para revendedores.
Abrir guíaTodas las rutas
GET
Saldo
/portal/balance
Consulta el saldo prepago para realizar compras y comprobar la conciliación.
GET
Consultar planes
/portal/plans
Carga el catálogo con los precios asignados al revendedor o consulta un slug para obtener el precio correspondiente a un solo plan.
POST
Crear pedido
/portal/order
Realiza una compra de revendedor con el precio de tu cuenta y el saldo prepago. Se admite la idempotencia.
GET
Consultar el estado del pedido
/portal/orders
Actualiza el estado más reciente de un pedido mediante el número de pedido del proveedor o el ICCID.
GET
Consultar pedidos
/reseller/orders
Consulta el historial de pedidos del revendedor por páginas, con filtros opcionales de estado y texto.
GET
Consultar eSIM
/reseller/esims
Consulta tu inventario de eSIM con filtros opcionales por estado.
GET
Consultar opciones de recarga
/portal/topups
Consulta los planes de recarga disponibles para un ICCID de tu cuenta antes de realizar una compra.
POST
Crear recarga
/portal/topups
Realiza una recarga para un ICCID de tu cuenta con un slug válido devuelto por la consulta de disponibilidad.
GET
Métricas
/reseller/metrics
Consulta las métricas del revendedor, los ingresos a lo largo del tiempo, los principales países y el uso agregado de la API por intervalo.
GET
Consultar perfil
/reseller/profile
Consulta los datos de la cuenta y del perfil empresarial del revendedor autenticado.
PATCH
Actualizar perfil
/reseller/profile
Actualiza los datos del perfil empresarial del revendedor, como el nombre de la empresa, el país y el sitio web.
PATCH
Configuración de webhooks
/reseller/webhook
Consulta o actualiza la URL de webhook configurada para el revendedor. Estas rutas requieren una sesión autenticada del portal.
Crea un flujo para revendedores con la API de eSIMTrade
La API para revendedores conecta tu aplicación con la consulta de planes, los precios de cuenta, las comprobaciones del saldo prepago, los pedidos y el inventario de eSIM. Empieza por la guía de autenticación y confirma que las consultas muestran los planes, el perfil y el saldo esperados para tu cuenta. Antes de enviar una compra, verifica el identificador actual del plan y los fondos disponibles; el servidor vuelve a calcular el precio y registra la transacción. Usa los ejemplos como punto de partida, conserva las claves secretas en tu servidor e incluye una clave de idempotencia al reintentar una compra.