Recargas

Descripción

Este método permite realizar una recarga de tiempo aire a un número Axios activo y resuelve el estado final de la transacción dentro de la misma llamada. El ciclo de confirmación se ejecuta del lado del servidor, así que recibes directamente el resultado sin necesidad de consultas adicionales.

Duración de la llamada

Normalmente la respuesta es muy rápida. En casos excepcionales, como la confirmación se resuelve internamente, la petición podría permanecer abierta hasta 240 segundos antes de responder. Configura el timeout de tu cliente HTTP en al menos ese valor y asegúrate de que cualquier proxy, balanceador o gateway intermedio permita ese tiempo.

Si tu infraestructura corta la conexión antes, la transacción sigue procesándose en el servidor. No la reintentes a ciegas.

---

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

Parámetro	Tipo	Requerido	Descripción	Ejemplo
carrierCode	string	Sí	Código del producto (SKU).	"204"
amount	string | number	Sí	Monto de la oferta a abonar. Debe ser un número positivo.	"100"
reference	string	Sí	Número Axios al que se aplica la recarga.	"4444444444"
address	string	No	Domicilio de instalación. Solo aplica a productos HBB.	"Av. Reforma 100..."

Resolución automática del producto

El tipo de producto (MOV o HBB) se determina en el servidor a partir del número enviado en reference. No necesitas declararlo. Cuando el número corresponde a un producto HBB y envías address, el domicilio se actualiza en el registro de la línea.

---

Ejemplo de Uso

Endpoint:

POSTapidevstore.axiosmobile.mx/v2/transactions/tae

POST /v2/transactions/tae HTTP/1.1
Host: apidevstore.axiosmobile.mx
x-api-key: {{apiKey}}
Content-Type: application/json

{
  "carrierCode": "204",
  "amount": "100",
  "reference": "4444444444"
}

---

Respuestas

200 — Transacción Completa Success

La recarga se confirmó correctamente.

{
  "message": "Transacción Completa",
  "folio": "1000365e55a3ca5ed53001a7a9479",
  "details": {
    "confirmation": "00",
    "description": "TRANSACCIÓN EXITOSA",
    "folio": "2940590",
    "balance": "0",
    "notice": "Buenos dias",
    "date": "03/03/2024 22:51:57"
  }
}

---

200 — Transacción en proceso Pendiente

La transacción fue aceptada por la plataforma pero no alcanzó un estado final dentro del tiempo de confirmación interno. El details contiene la última respuesta recibida de la plataforma.

{
  "message": "Transacción en proceso",
  "folio": "1000365e55a3ca5ed53001a7a9479",
  "details": {
    "Confirmation": "24",
    "Description": "RECARGA EN ESPERA"
  }
}

No reintentes la recarga

Este caso no significa que la recarga falló. La operación ya fue tomada por la plataforma y el saldo puede haber sido descontado. Enviar de nuevo la misma petición genera un folio distinto y aplica una segunda recarga.

Si recibes este estado, resuelve el folio con Consultar estado de la recarga usando el folio devuelto.

---

400 — Errores de Validación Client Error

carrierCode requerido

{ "error": "carrierCode es requerido" }

amount requerido

{ "error": "amount es requerido" }

monto inválido

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

reference requerido

{ "error": "reference es requerido" }

---

400 — Transacción rechazada Client Error

La plataforma rechazó la recarga. El message contiene la descripción emitida por la plataforma y details.confirmation el código devuelto.

{
  "message": "SALDO INSUFICIENTE",
  "folio": "1000365e55a3ca5ed53001a7a9479",
  "details": {
    "confirmation": "51",
    "description": "SALDO INSUFICIENTE"
  }
}

En este caso la operación no fue tomada y no se descontó saldo.

---

400 — Transacción fallida Client Error

La recarga fue aceptada inicialmente pero la confirmación devolvió un código terminal no exitoso.

{
  "message": "Transacción fallida",
  "folio": "1000365e55a3ca5ed53001a7a9479",
  "details": {
    "Confirmation": "17",
    "Description": "TRANSACCIÓN NO CONFIRMADA"
  }
}

Verifica el folio antes de reintentar

A diferencia del rechazo directo, aquí la plataforma ya había aceptado la operación. Antes de generar una nueva recarga, confirma el estado real del folio con Consultar estado de la recarga.

---

500 — Error de comunicación Server Error

No fue posible contactar al servicio de transacciones.

{
  "message": "Error al conectar con el servicio de transacciones",
  "folio": "1000365e55a3ca5ed53001a7a9479",
  "details": "[mensaje del error]"
}

---

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" }

---

Parámetros de salida

Parámetro	Tipo	Descripción	Ejemplo
message	string	Descripción del resultado de la operación.	"Transacción Completa"
folio	string	Identificador único de la transacción en Axios.	"1000365e55a3ca5ed53001a7a9479"
details	object	Detalle de la confirmación.	—
details.confirmation	string	Código de respuesta de la plataforma.	"00"
details.description	string	Descripción de la transacción.	"TRANSACCIÓN EXITOSA"
details.folio	string	Folio de la operadora.	"2940590"
details.balance	string	Saldo del cliente tras la operación.	"0"
details.notice	string	Aviso informativo.	"Buenos días"
details.date	string	Fecha y hora de la plataforma.	"03/03/2024 22:51:57"

---

Resumen de Códigos de Respuesta

Código HTTP	message	Significado	Acción recomendada
200	Transacción Completa	Recarga confirmada.	Ninguna.
200	Transacción en proceso	Aceptada, sin estado final.	Consultar el folio. No reintentar.
400	—	Datos de entrada inválidos.	Corregir la petición.
400	descripción de la plataforma	Rechazada, sin cargo.	Reintentable.
400	Transacción fallida	Aceptada pero no confirmada.	Consultar el folio antes de reintentar.
429	Too many requests...	Límite de 60 peticiones por minuto excedido.	Esperar 1 minuto y reintentar.
500	Error al conectar...	Falla de comunicación.	Consultar el folio antes de reintentar.

---

Diagrama de flujo

flowchart TD A([El cliente solicita una recarga]) --> AUTH{¿API Key válida?} AUTH -->|No| UNAUTH[401 / 403 - No autorizado] AUTH -->|Sí| B{¿Datos completos\ny válidos?} B -->|No| X[400 - Datos inválidos] B -->|Sí| C[Se resuelve el producto\nMOV o HBB] C --> D[Se genera folio\ny se envía la recarga] D -->|Sin comunicación| ERR[500 - Error de conexión] D --> E{¿La plataforma\naceptó?} E -->|No| REJ[400 - Rechazada\nsin cargo de saldo] E -->|Sí| F[Confirmación interna\nsin acción del integrador] F --> G{¿Estado final?} G -->|Exitoso| OK[200 - Transacción Completa] G -->|Terminal no exitoso| FAIL[400 - Transacción fallida] G -->|Sin resolver| PEND[200 - Transacción en proceso] PEND --> CHK([Consultar estado del folio])

---

Probar Endpoint

POSThttps://apidevstore.axiosmobile.mx/v2/transactions/taeEnviar

Recarga de tiempo aire con confirmación interna — Requiere API Key en el header x-api-key. La respuesta normalmente es rápida, pero puede tardar hasta 240 segundos.

Headers+ Agregar

×

×

BodyFormatear

{ "carrierCode": "204", "amount": "100", "reference": "4444444444" }