Rastrear transacción

Descripción

Este método permite consultar el estado de una transacción (activación de eSIM o recarga) a partir de la clave de idempotencia (Idempotency-Key) que enviaste al crearla, sin necesidad de conservar el folio.

Resulta útil cuando una petición de creación (POST /v2/transactions o POST /v2/transactions/tae) no te devolvió respuesta —por ejemplo, por un corte de red o un timeout en tu cliente— y necesitas averiguar si la operación realmente se procesó.

¿Qué es la idempotencia?

Al crear una transacción puedes enviar el header Idempotency-Key con un valor único que tú generas. Si reintentas la misma operación con la misma clave, la API no crea una transacción duplicada: reproduce la respuesta original. Este endpoint te permite consultar, en cualquier momento, el resultado asociado a esa clave.

Consulta Activación de eSIM y Recargas para ver cómo se envía la clave al crear la transacción.

---

URL API

BASE URLhttps://apidevstore.axiosmobile.mx/v2

---

Autenticación

Este endpoint se autentica mediante API Key.

Mecanismo	Header	Descripción
API Key	x-api-key: {{apiKey}}	Clave de API asignada a tu cuenta

Envía la clave en el header x-api-key en cada solicitud. No hay flujo de login previo. Solicita tu clave contactando al equipo de soporte Axios.

Situación	Código
Header x-api-key ausente	401
Clave inválida o no habilitada	403

Límite de peticiones (rate limit)

Este endpoint está protegido por un límite de 60 peticiones por minuto por usuario (tu API Key). Si lo superas, recibirás un 429 con el mensaje { "error": "Too many requests, please try again later" }.

---

Parámetros de entrada

El estado se consulta a partir del header Idempotency-Key. No se envía body ni parámetros en la URL.

Parámetro	Tipo	Ubicación	Requerido	Descripción	Ejemplo
Idempotency-Key	string	Header	Sí	Clave de idempotencia usada al crear la transacción.	"esim-9f1c2b7e-..."

---

Ejemplo de Uso

Endpoint:

GETapidevstore.axiosmobile.mx/v2/transactions/trace

GET /v2/transactions/trace HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}
Idempotency-Key: esim-9f1c2b7e-3a44-4c1e-9b2a-7d5f1e8c0a22

Body: No aplica

---

Respuestas

200 — Transacción encontrada Success

Existe una transacción asociada a la Idempotency-Key. El campo result contiene la respuesta HTTP original que recibió el cliente al crear la transacción (o null si todavía no finaliza).

{
  "idempotencyKey": "esim-9f1c2b7e-3a44-4c1e-9b2a-7d5f1e8c0a22",
  "folio": "100036a358d5f64d032661114acfc",
  "status": "COMPLETED",
  "type": "TRANSACTION_ESIM_V2",
  "createdAt": "2026-10-21T18:30:20.925Z",
  "completedAt": "2026-10-21T18:30:25.100Z",
  "failedAt": null,
  "failureReason": null,
  "result": {
    "status": "COMPLETED",
    "folio": "100036a358d5f64d032661114acfc",
    "description": "TRANSACCIÓN EXITOSA",
    "simData": {
      "imsi": "334140179156088",
      "iccid": "8952140062227833246F",
      "msisdn": "5632158420",
      "pin": "1234",
      "puk": "63011475",
      "serie": "00361",
      "product": "ESIM",
      "qrLink": "https://axios-mobile.s3.us-east-2.amazonaws.com/esims/8952140062227833246F.png"
    }
  }
}

result aún no disponible

Mientras la transacción sigue en proceso, result es null (la respuesta aún no se ha “congelado”). Consulta nuevamente después de unos segundos.

---

400 — Idempotency-Key requerido Client Error

Se retorna cuando no se envía el header Idempotency-Key.

{ "error": "Header Idempotency-Key es requerido" }

---

404 — Transacción no encontrada Client Error

No existe ninguna transacción creada con esa Idempotency-Key para tu cuenta.

{ "error": "No se encontró transacción para ese Idempotency-Key" }

---

429 — Demasiadas peticiones Client Error

Se retorna cuando se supera el límite de 60 peticiones por minuto por usuario (tu API Key).

{ "error": "Too many requests, please try again later" }

---

500 — Error al consultar Server Error

Ocurrió un error inesperado al consultar la transacción.

{
  "error": "Error al consultar la transacción",
  "details": "[mensaje del error]"
}

---

Parámetros de salida (Respuesta Exitosa)

Parámetro	Tipo	Descripción	Ejemplo
idempotencyKey	string	Clave de idempotencia consultada.	"esim-9f1c2b7e-..."
folio	string | null	Identificador único de la transacción en Axios.	"100036a358d5f64d032661114acfc"
status	string | null	Estado interno de la transacción (PROCESSING, COMPLETED, IN_PROGRESS, FAILED, CHECK_FAILED).	"COMPLETED"
type	string | null	Tipo de transacción.	"TRANSACTION_ESIM_V2"
createdAt	string | null	Fecha y hora de creación de la transacción.	"2026-10-21T18:30:20.925Z"
completedAt	string | null	Fecha y hora en que se completó (si aplica).	"2026-10-21T18:30:25.100Z"
failedAt	string | null	Fecha y hora en que falló (si aplica).	null
failureReason	string | null	Motivo de la falla (si aplica).	null
result	object | null	Respuesta HTTP original devuelta al crear la transacción. null si aún no finaliza.	—

---

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v2/transactions/traceEnviar

Rastrear transacción por Idempotency-Key — Requiere API Key en el header x-api-key y la clave de idempotencia en el header Idempotency-Key.

Headers+ Agregar

×

×

×