Consultar estado de una transacción

Descripción

Devuelve el estado de una venta usando el folio que tu sistema envió en Realizar venta. Úsalo para conciliar y, sobre todo, cuando la venta no devolvió un resultado definitivo (timeout, 502, 500 o error de red).

Esta consulta no reenvía la venta al proveedor: devuelve el estado registrado en Orion.

Solo ves ventas hechas con la misma API Key que consulta.

---

URL API

BASE URLhttps://api.faxil.mx/api/v1

---

Autenticación

Header	Requerido	Permiso de la API Key
x-api-key	Sí	Ninguno adicional.

---

Parámetros de entrada

Parámetro	Tipo	Ubicación	Requerido	Descripción
folio	string	Path	Sí	El folio que enviaste al vender. Codifícalo para URL si contiene caracteres especiales.

---

Ejemplo de uso

Endpoint:

GETapi.faxil.mx/api/v1/tae/check-transaction/:folio

curl -s "$ORION_API/api/v1/tae/check-transaction/POS01-000123" \
  -H "x-api-key: $ORION_API_KEY"

Body: No aplica

---

Respuestas

200 — Estado de transacción Success

data es un arreglo de intentos ordenado del primero al último. Normalmente tiene un solo elemento. Si el proveedor principal rechazó la venta y Orion la reintentó con un proveedor de respaldo, verás un elemento por intento.

El estado de la venta es el code del último elemento.

{
  "error": false,
  "message": "Estado de transacción",
  "data": [
    {
      "id": 104233,
      "folio": "POS01-000123",
      "carrier_id": 1,
      "dn": "5512345678",
      "amount": "50.00",
      "fee_amount": "0.00",
      "wallet": "TAE",
      "channel": "API",
      "code": "00",
      "description": "TRANSACCION EXITOSA",
      "folio_carrier": "784512",
      "reversed": 0,
      "datetime_sent": "2026-11-07T17:02:11.412Z",
      "datetime_response": "2026-11-07T17:02:13.087Z",
      "createdAt": "2026-11-07T17:02:11.415Z",
      "updatedAt": "2026-11-07T17:02:13.090Z"
    }
  ],
  "results": 1
}

---

404 — Transacción no encontrada Client Error

No existe una venta con ese folio para tu API Key.

{ "error": true, "message": "Transacción no encontrada", "data": [], "results": 0 }

401 / 403 — Autenticación Client Error

Ver Autenticación (API Key).

---

Parámetros de salida

Campos de cada elemento de data:

Campo	Tipo	Descripción
id	number	Identificador interno del intento. El último coincide con el transaction_id de la venta.
folio	string	Tu folio.
carrier_id	number	Producto vendido.
dn	string	Número o referencia de la venta.
amount	string (decimal)	Monto vendido, en MXN.
fee_amount	string (decimal)	Comisión cobrada al cliente final (SERVICIO y PIN).
wallet	string	Bolsa afectada: TAE o SERVICIOS.
channel	string	Canal de la venta. Por API siempre API.
code	string	Estado: 00 exitosa, 04 rechazada, 25 en proceso. Ver tabla abajo.
description	string | null	Descripción del resultado.
folio_carrier	string | null	Folio o autorización del proveedor.
reversed	number	1 si la venta fue revertida posteriormente; 0 si no.
datetime_sent	string (ISO 8601, UTC)	Envío al proveedor.
datetime_response	string | null (ISO 8601, UTC)	Respuesta del proveedor. null mientras no haya respuesta.
esim	object	Solo en ventas de eSIM exitosas: iccid, msisdn, qr_link.

Estados (code)

code	Estado	¿Se cobró?	Qué hacer
00	Exitosa	Sí	Entregar comprobante.
04	Rechazada	No	Reintentar con datos corregidos y folio nuevo.
25	En proceso / pendiente de conciliación	Saldo apartado	Volver a consultar más tarde. No reintentar. CTC concilia con el proveedor y la venta termina como 00 o 04.

---

Estrategia de consulta recomendada

1. Tras un timeout o 502, consulta el folio.
2. Si responde 404, reenvía la venta con el mismo folio.
3. Si el último intento tiene code 25, consulta de nuevo con espera creciente (por ejemplo, 30 s, 1 min, 5 min, 15 min).
4. Si después de 24 horas sigue en 25, contacta a soporte de CTC con el folio.

---

Probar endpoint

GEThttps://api.faxil.mx/api/v1/tae/check-transaction/:folioEnviar

Ingresa el folio que enviaste al realizar la venta.

Parámetros de ruta

:folio

Headers+ Agregar

×

×