Listar órdenes de tienda

GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
x-api-key: <tu_api_key>

{
  "orders": [
    {
      "id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "orderCode": "OC-1024",
      "storeId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "COMPLETED",
      "paymentStatus": "SUCCEEDED",
      "channel": "APP",
      "businessDayDate": "2026-07-01",
      "createdAt": "2026-07-01T14:03:00Z",
      "updatedAt": "2026-07-01T14:20:00Z"
    }
  ],
  "pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
}

GET

api

fire

external

stores

{storeId}

orders

GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
x-api-key: <tu_api_key>

{
  "orders": [
    {
      "id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "orderCode": "OC-1024",
      "storeId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "COMPLETED",
      "paymentStatus": "SUCCEEDED",
      "channel": "APP",
      "businessDayDate": "2026-07-01",
      "createdAt": "2026-07-01T14:03:00Z",
      "updatedAt": "2026-07-01T14:20:00Z"
    }
  ],
  "pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
}

La variante anidada de Listar órdenes: la tienda se identifica por el path param {storeId} en lugar de un filtro de query. El resto de los query params — paginación, filtros y projection de campos — se comportan igual. El guard de tenant garantiza que un storeId de otro account/vendor devuelva una lista vacía — nunca órdenes de otro tenant.

Autenticación

string

requerido

Tu API key de Fire con scope orders:read. La key debe ser vendor-scoped — las keys sin vendorId se rechazan con 403.

Path params

string

requerido

UUID de la tienda (stores.id).

Query params

El account y el vendor se derivan de tu API key (vendor-scoped) — no se envían por query.

string

Projection — ver Projection de campos.

string

OPEN, COMPLETED, FORCE_CLOSED, CANCELLED.

string

PENDING, SUCCEEDED, FAILED.

string

Día de negocio exacto, YYYY-MM-DD.

string

Inicio del rango, YYYY-MM-DD.

string

Fin del rango, YYYY-MM-DD.

string

predeterminado:"business_day"

business_day o created_at.

string

predeterminado:"+00:00"

Offset de timezone para el modo created_at.

string

Código de canal.

string

Código de servicio de fulfillment.

string

Código de método de pago.

string

Match parcial sobre order code.

string

UUID exacto, o external order id / order code parcial.

integer

predeterminado:"1"

Número de página (base 1).

integer

predeterminado:"20"

Tamaño de página (1–100).

Petición

GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
x-api-key: <tu_api_key>

Respuesta

Mismo shape que Listar órdenes: { orders, pagination }. Para ver cómo viene el cobro de cada orden, proyectá settlement — ver Progreso del cobro.

{
  "orders": [
    {
      "id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
      "orderCode": "OC-1024",
      "storeId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "COMPLETED",
      "paymentStatus": "SUCCEEDED",
      "channel": "APP",
      "businessDayDate": "2026-07-01",
      "createdAt": "2026-07-01T14:03:00Z",
      "updatedAt": "2026-07-01T14:20:00Z"
    }
  ],
  "pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
}

API

APIs de partner

PayBridge

Listar órdenes de tienda

Autenticación

Path params

Query params

Petición

Respuesta

Relacionado

Listar órdenes

Obtener tienda

​Autenticación

​Path params

​Query params

​Petición

​Respuesta

​Relacionado

Listar órdenes

Obtener tienda

Autenticación

Path params

Query params

Petición

Respuesta

Relacionado