Saltar al contenido
Saltar al contenido

Documentación de eSIMTrade

API pública

api.esimtrade.com

cURL
JavaScript
HTTP
JSON

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.

Consulta rápida
Rutas disponibles
Ejemplos para copiar
Pedidos
Clave de API o sesión
GET

Consultar el estado del pedido

Actualiza el estado más reciente de un pedido mediante el número de pedido del proveedor o el ICCID.

Ruta de API

GET /portal/orders

Funcionamiento de la ruta

Actualiza el estado de un pedido mediante el número de pedido del proveedor o el ICCID. El estado actualizado estará disponible en tu historial de pedidos.

También puedes recibir un correo cuando un pedido alcance un estado que genere una notificación para tu cuenta.

Parámetro de consultaTipoObligatorioDescripción
ordernostringUno de los dosNúmero de pedido del proveedor que se actualizará
iccidstringUno de los dosICCID que se actualizará si no se dispone del número de pedido

Actualizar mediante el número de pedido del proveedor

cURL
curl --location --request GET 'https://api.esimtrade.com/api/v1/portal/orders?orderno=B26022703140001' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY'

Actualizar mediante ICCID

cURL
curl --location --request GET 'https://api.esimtrade.com/api/v1/portal/orders?iccid=8948010000095399804' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY'

Estructura de la respuesta real

JSON
{
  "data": {
    "esimTranNo": "26022703140001",
    "orderNo": "B26022703140001",
    "transactionId": "gs_1772162041486",
    "imsi": "260010181623870",
    "iccid": "8948010000095399804",
    "qrCodeUrl": "https://p.qrsim.net/example.png",
    "shortUrl": "https://p.qrsim.net/example",
    "smdpStatus": "RELEASED",
    "totalVolume": 524288000,
    "totalDuration": 1,
    "durationUnit": "DAY",
    "orderUsage": 0,
    "esimStatus": "CANCEL",
    "packageList": [
      {
        "packageName": "Pakistan 500MB/Day",
        "packageCode": "PUX79Y0PK",
        "slug": "PK_0.5_Daily"
      }
    ]
  }
}

URL base

https://api.esimtrade.com/api/v1