Consultar transacción por código o folio

Descripción

Este método permite localizar una transacción (venta de eSIM o recarga) a partir de un único identificador, que puede ser:

• El código alfanumérico de 6 caracteres asociado a la venta, o
• El folio de la transacción.

Es un endpoint público: no requiere API Key ni login. Está pensado para flujos donde el cliente final o un sistema de soporte necesita consultar una venta conociendo solo su código corto, incluyendo los datos de la eSIM para su instalación.

¿Qué consulta usar?

• Tienes el código de 6 caracteres o el folio → usa este endpoint (no requiere API Key).
• Tienes la Idempotency-Key con la que creaste la transacción → usa Consultar transacción por Idempotency-Key (requiere API Key).

Endpoint público con datos de la eSIM

Al ser un endpoint abierto, cualquiera que conozca el code o el folio obtiene el simData completo (incluidos pin, puk y qrLink). La respuesta no incluye credenciales de la cuenta ni datos de contacto del comprador (correo/teléfono).

---

URL API

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

---

Autenticación

Este endpoint es público (noAuth): no se envía x-api-key ni token.

Límite de peticiones (rate limit)

Este endpoint aplica un límite de peticiones; si lo superas recibirás un 429.

---

Parámetros de entrada

El identificador se envía como parámetro de ruta. No se envía body.

Parámetro	Tipo	Ubicación	Requerido	Descripción	Ejemplo
identifier	string	Ruta (path)	Sí	Código de 6 caracteres o folio de la transacción. Solo se aceptan caracteres alfanuméricos (6 a 80).	"AB12CD"

Identificador aceptado

Puedes enviar el código de 6 caracteres (sin distinguir mayúsculas/minúsculas) o el folio. El code se obtiene de la respuesta de creación (POST /v2/transactions) y el folio lo devuelven tanto la creación como Ventas de eSIM.

---

Ejemplo de Uso

Endpoint:

GETapidevstore.axiosmobile.mx/v2/transactions/find/:identifier

GET /v2/transactions/find/AB12CD HTTP/1.1
Host: apidevstore.axiosmobile.mx

Body: No aplica

---

Respuestas

200 — Transacción encontrada Success

{
  "code": "AB12CD",
  "folio": "100036a358d5f64d032661114acfc",
  "status": "COMPLETED",
  "type": "TRANSACTION_ESIM_V2",
  "soldAt": "2026-10-21T18:30:20.925Z",
  "completedAt": "2026-10-21T18:30:25.100Z",
  "failedAt": null,
  "offering": {
    "offeringId": "OFF-5GB-30D",
    "descriptionPlan": "Plan Conecta 5GB · 30 días",
    "carrier": "204",
    "group": "ACTIVACION",
    "amount": 150
  },
  "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"
  }
}

Recargas

En una recarga (no es una venta de eSIM) el objeto simData es null, ya que no hay un perfil eSIM asociado. Los campos de offering reflejan el producto recargado.

---

400 — Identificador inválido Client Error

Se retorna cuando el identificador falta o tiene un formato no permitido (caracteres no alfanuméricos, o longitud fuera de 6–80).

{ "error": "identifier inválido" }

---

404 — Transacción no encontrada Client Error

No existe ninguna transacción con ese código ni con ese folio.

{ "error": "Transacción no encontrada" }

---

429 — Demasiadas peticiones Client Error

Se retorna cuando se supera el límite de peticiones.

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

---

500 — Error al localizar Server Error

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

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

---

Parámetros de salida (Respuesta Exitosa)

Parámetro	Tipo	Descripción	Ejemplo
code	string | null	Código alfanumérico de 6 caracteres de la venta.	"AB12CD"
folio	string | null	Identificador único de la transacción en Axios.	"100036a358d5f64d032661114acfc"
status	string | null	Estado de la transacción (PROCESSING, COMPLETED, IN_PROGRESS, FAILED, CHECK_FAILED).	"COMPLETED"
type	string | null	Tipo de transacción.	"TRANSACTION_ESIM_V2"
soldAt	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
offering.offeringId	string | null	Identificador de la oferta/paquete.	"OFF-5GB-30D"
offering.descriptionPlan	string | null	Descripción del plan o paquete.	"Plan Conecta 5GB · 30 días"
offering.carrier	string | null	Operador o código de carrier.	"204"
offering.group	string | null	Grupo del producto.	"ACTIVACION"
offering.amount	number | null	Monto de la operación (MXN).	150
simData	object | null	Datos de la eSIM vendida. null en recargas.	—
simData.imsi	string	IMSI de la eSIM.	"334140179156088"
simData.iccid	string	ICCID de la eSIM.	"8952140062227833246F"
simData.msisdn	string	Número asignado.	"5632158420"
simData.pin	string	PIN de la línea.	"1234"
simData.puk	string	PUK de la línea.	"63011475"
simData.serie	string	Serie.	"00361"
simData.product	string	Tipo de producto.	"ESIM"
simData.qrLink	string	URL de la imagen del QR de activación.	"https://.../8952...F.png"

---

Probar Endpoint

GEThttps://apidevstore.axiosmobile.mx/v2/transactions/find/:identifierEnviar

Consultar transacción por código (6 caracteres) o folio — Endpoint público, sin API Key.

Parámetros de ruta

:identifier

Headers+ Agregar

×