> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hardware Orders (Acquiring)

> The merchant dashboard Payment > Terminal > Hardware Orders page — view placed POS/terminal hardware orders, filter by status and date, view order details and delivery progress, and reorder devices from Shop.

## What this is

This is the **Hardware Orders** page under **Terminal** in the **Payment** module of the merchant dashboard (left nav **Terminal** → top **Hardware Orders** tab; page subtitle "Track hardware orders and deliveries"; sibling tabs include **Locations** and **POS Devices**). Here you view your placed POS/terminal hardware orders, filter by status and date, open an order to see its details and delivery progress, and reorder devices via **Shop** in the top right. Use this page to check whether your ordered devices have shipped, find a tracking number, see the estimated delivery date, or order more devices.

## Steps

Open and view orders:

1. In the left nav, go to **Terminal**, then select the **Hardware Orders** tab at the top.
2. The list shows orders within the selected date range by default; narrow it down using the toolbar filters.

Filter and search:

1. **Date range**: shows roughly the last 3 months by default; choose custom start/end dates or **All time**.
2. **Status** filter: check order statuses (Pending / Processing / Shipped / Delivered) to narrow the list.
3. **Search**: search by Order ID or tracking number (placeholder "Search by order ID, tracking...").
4. Active filters appear as tags under **Filtered by**; click the "x" on a tag to remove it, or click **Clear all** to clear everything.

View a single order's details:

1. Click a row (or open the row's **⋯** menu → **View details**) to slide in the **Order Details** panel.
2. The panel shows the order overview, order total and estimated delivery, shipping information, tracking number, and delivery timeline.

Export:

1. Click **Export** in the toolbar to export the currently filtered orders as a CSV file.
2. Or check one or more rows in the list and click **Export selected** to export only the selected orders.

Reorder devices: click **Shop** in the top right to open the "Order Devices" dialog and place an order in three steps — ① select devices and quantity → ② **Continue to Shipping** to enter a shipping address → ③ **Review Order**, then click **Place Order**. Shipping is free.

## Fields and statuses

**List columns:**

| Column           | Meaning (merchant view)                                          | Notes                                         |
| ---------------- | ---------------------------------------------------------------- | --------------------------------------------- |
| Order ID         | This hardware order's identifier                                 | Copyable inline                               |
| Items            | The devices and quantities in this order (e.g. "Device name x2") |                                               |
| Status           | The order's current status, see below                            |                                               |
| Shipping Address | Abbreviated shipping address (street + city + country)           |                                               |
| Order Date       | When the order was placed                                        |                                               |
| Tracking         | The logistics tracking number; shows "—" if not yet shipped      | Copyable inline when a tracking number exists |

**Order status:**

| Status     | Meaning                              |
| ---------- | ------------------------------------ |
| Pending    | Order submitted, awaiting processing |
| Processing | Order is being processed / prepared  |
| Shipped    | Shipped and in transit               |
| Delivered  | Delivered and received               |

> The status bar at the top summarizes counts by status: Total, Pending, Processing, Shipped, Delivered. A small number of orders may show **Cancelled**.

**Order Details panel fields:**

* **Order Overview**: Order ID, status, Items, Order Date.
* **Order Total / Est. Delivery**: this order's amount and estimated delivery date.
* **Shipping Information**: Contact Name, Street Address, City, State / Province, Postal Code, Country, Phone (masked, e.g. `+65 9***4567`).
* **Tracking**: tracking number; shows "Not yet available" before shipment.
* **Delivery Timeline**: progress nodes Order placed → Processing → Shipped → Delivered, with the current node labeled "In transit."

**Row-level "⋯" menu**: View details, Track shipment.

## Edge cases and troubleshooting

* **List shows "No orders yet"**: the account has no hardware orders yet; the hint reads "Orders will appear here once activity begins." Click **Shop** in the top right to place one.
* **"No orders match your filters"**: the current status/date/search filter has no matches; the hint reads "Try adjusting your filter criteria." Click **Clear filters** or **Clear all** and try again.
* **Tracking column shows "—" / order details show "Not yet available"**: the order hasn't shipped yet — a tracking number is generated once it does.
* **Phone number only partially shown**: the shipping phone number is masked for privacy — this is expected.
* **Want to order more devices**: click **Shop** in the top right, then select devices/quantity → enter shipping address → review → Place Order — three steps, shipping is free.
* **Shipping information errors when submitting an order**: Contact Name, Address Line 1, City, Postal Code, Country, and Phone Number are required — any missing field is flagged in red beneath it; complete them all before continuing.

## Common questions (Q\&A)

* **Q: Where do I see hardware orders? / How do I check my POS machine orders?** A: Left nav **Terminal** → top **Hardware Orders** tab — the list shows your hardware orders, filterable by status, date, or order ID/tracking number.
* **Q: Has my device shipped / what's the tracking number?** A: Check the **Tracking** column in the list, or open the order details; "—" or "Not yet available" means it hasn't shipped yet — a tracking number appears once it does.
* **Q: What order statuses are there and what do they mean?** A: Pending (awaiting processing), Processing (being prepared), Shipped (in transit), Delivered (received); a small number of orders may show Cancelled.
* **Q: How do I order more POS devices / hardware?** A: On the Hardware Orders page, click **Shop** in the top right, then: select devices and quantity → enter shipping address → review order → Place Order. Shipping is free.
* **Q: What do I need to fill in to order devices?** A: In shipping information, Contact Name, Address Line 1, City, Postal Code, Country, and Phone Number are required; State/Province and Address Line 2 are optional.
* **Q: How do I export hardware orders?** A: Click **Export** in the toolbar to export the currently filtered orders as CSV; or check rows and click **Export selected** to export only those.
* **Q: How do I find an order by order number or tracking number?** A: Use the search box in the toolbar and enter the Order ID or tracking number.
* **Q: When is my order expected to arrive?** A: Open the order details — **Est. Delivery** shows the estimated delivery date, and the **Delivery Timeline** shows current progress.
* **Q: Why is my shipping phone number only partially shown?** A: For privacy, the shipping phone number is masked — this is expected.
* **Q: What step is this order at exactly / when will it actually arrive?** A: This is a real-time status for an individual order — refer to the status and delivery timeline in the order details panel; this corpus doesn't provide case-by-case conclusions.