Catalog order status, chat, and approval
After a catalog checkout succeeds, the same catalog URL becomes the customer’s order status page (while the linked customer order is not archived). Customers can chat with the store and approve design mockups when requested.
This is the POS-hosted path (/{posSlug}/catalog/{linkCode}). Classic customer-link chat/approval lives in the Checkout app — Chat and design approval.
Customer
Open status
- Re-open the catalog link the shop sent, or stay after Complete order.
- On the catalog root (and success path), when a live order exists, the app shows Order placed successfully, Order ID, and an Order status timeline.
- While browsing other catalog pages (for example
/shopor/cart), use the header Order status control to return to the status screen.
Status timeline
Typical steps:
- Checkout submitted — We have received your order.
- Needs approval (only when design units need review) — approve or reject mockups.
- In process — Your order is being created. (when the link is Order Placed / Archived and no pending approval).
- Shipped — tracking ID appears when the store sets it (Tracking appears here once the order ships.).
Below the timeline: Items, Order total, and Browse catalog (opens /shop).
Chat (Comments)
- Tap the floating chat control (Open support chat).
- Dialog title Comments — Message the store about this order.
- Type a message → Send. Admin/system replies appear in the thread (live via SSE).
- Unread Admin messages show a red badge on the chat button until you open it.
- Close returns to the status page.
Design approval
When a unit is Approval Requested:
- Review mockup thumbnails (open full size in a new tab).
- Tap Approve, or Reject → optional note (What should change?) → Confirm reject / Cancel.
- Errors show under the unit cards if the action fails.
Used link vs status (important)
| Situation | What the customer sees |
|---|---|
| First successful submit | Success, then status page on the same catalog URL |
| Re-open catalog URL while order is live (not Archived) | Order status page (GET still returns the catalog + order) |
| Second Complete order / submit | API 410 — This catalog link has already been used. |
| Order archived | Catalog GET no longer attaches a live order; status UI is not shown |
| Defensive UI if GET returns 410 | Link already used / This catalog link has already been used. |
Do not assume every revisit shows only “already used.” Live orders reopen into status/chat/approval.
Staff
- Convert the submitted catalog-origin customer link in Link History.
- Continue fulfillment in Admin Orders / workflows as usual.
- Reply to customer comments from the order comments tools (same customer-link comment channel the status page uses).