Join Post Pay Table

Description

WiXGo 掃碼後結：加入同桌。客人選好頭像與暱稱、按「開始點餐」時呼叫，取得參與者編號；之後送單與服務鈴都要帶這個編號。

• 訂單必須是用餐中。
• 同一張單暱稱重複時，系統自動存成「暱稱(1)」「暱稱(2)」…，畫面請以回傳的 nickname 為準。
• 併桌後，前端用原本的頭像與暱稱對目標訂單再呼叫一次，取得新的參與者編號。

Resource

POST /v1/order/post-pay/{order_id}/participants

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Path Parameters

Name	Type	Description
order_id	string	訂單編號

Request Body Parameters

Name	Type	Required	Description
store_id	string	✓	門市代號
nickname	string	✓	暱稱，去頭尾空白後 1–8 個中英數字
avatar_id	string	✓	頭像編號，最多 20 字

Request Example

POST /v1/order/post-pay/11056-202610140001/participants

{
  "store_id": "11056",
  "nickname": "葡萄",
  "avatar_id": "grape"
}

Response Body Parameters

Name	Type	Description
participant_id	integer	參與者編號
nickname	string	實際存下的暱稱（重名時會加上編號）

Response

HTTP-Status-Code: 201

{
  "participant_id": 123,
  "nickname": "葡萄(1)"
}

HTTP-Status-Code: 400

{
  "message": "訂單不是用餐中，無法加入點餐"
}

{
  "message": "暱稱限 1-8 個中英數字"
}