Skip to main content
GET
/
orders
/
{order_id}
Get Order
curl --request GET \
  --url https://quickei.io/pay/sandbox/api/v1/orders/{order_id}
Retrieve the full details and current status of a specific POS order.

Endpoint

GET https://quickei.io/pay/sandbox/api/v1/orders/{order_id}

Path Parameters

order_id
string
required
The POS order ID (e.g. POS-20240115-A1B2C3)
Auto-expiry: If the order is still PENDING and past its expires_at, the API will automatically mark it as EXPIRED before returning.

Response Fields

FieldDescription
order_idUnique POS order identifier
amountFormatted amount with currency (e.g. 25.00 EUR)
raw_amountNumeric amount value
statusPENDING, PAID, EXPIRED, CANCELLED, REFUNDED, REFUND_PENDING
qr_dataQR code data string (when payment_method includes qr)
payment_urlHosted payment page URL (when payment_method includes page)
trx_idQuickei transaction ID (null until paid)
paid_atISO 8601 timestamp of payment (null until paid)

Example Request

GET /merchant-api/pos/v1/orders/POS-20240115-A1B2C3
Authorization: Basic {base64_credentials}

Success Response 200

{
  "message": {
    "success": ["Order status retrieved"]
  },
  "data": {
    "order_id": "POS-20240115-A1B2C3",
    "amount": "25.00 EUR",
    "raw_amount": 25.00,
    "currency": "EUR",
    "payment_method": "both",
    "reference": "INV-2024-001",
    "description": "Table 5 - Lunch",
    "terminal_id": "terminal-01",
    "status": "PAID",
    "qr_data": "quickei://pay?order=POS-20240115-A1B2C3&a=25.00&c=EUR",
    "payment_url": "https://quickei.io/pay/pos/POS-20240115-A1B2C3",
    "trx_id": "TRX-98765",
    "paid_at": "2024-01-15T14:02:30+00:00",
    "expires_at": "2024-01-15T14:05:00+00:00",
    "created_at": "2024-01-15T14:00:00+00:00"
  }
}

Error Response 404

{
  "message": {
    "error": ["Order not found"]
  }
}