Send Post Pay Service Bell

Description

WiXGo 掃碼後結：服務鈴。客人選擇服務鈴選項（可多選），或輸入特殊需求，通知門市服務人員。

• 服務鈴選項請取自 Get Store 的 wixgo_service_bell_vocabulary。
• option_ids 與 special_request 二擇一。
• 送到 POS 的內容（選項名稱）以門市目前的設定為準，不採用前端傳入的文字；選項已停用或門市不使用時會被拒絕。
• 冷卻時間由前端控制。

重要提示： - 送到 POS 列印小白單的串接尚未開放，開放前此 API 一律回 501。

Resource

POST /v1/order/post-pay/{order_id}/service-bell

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	✓	門市代號
participant_id	integer	✓	按服務鈴的參與者編號（加入同桌取得），正整數
option_ids	string[]		選取的服務鈴選項代號，1–20 個、每個最多 20 字、不可重複（與 special_request 擇一）
special_request	string		特殊需求，去頭尾空白後 1–10 字，不可使用表情符號（與 option_ids 擇一）

Request Example

POST /v1/order/post-pay/11056-202610140001/service-bell

範例 1：選擇服務鈴選項

{
  "store_id": "11056",
  "participant_id": 123,
  "option_ids": ["H001", "H002"]
}

範例 2：特殊需求

{
  "store_id": "11056",
  "participant_id": 123,
  "special_request": "幫我換烤網"
}

Response

HTTP-Status-Code: 204

HTTP-Status-Code: 400

{
  "message": "服務鈴選項已停用或不存在，請重新整理後再試"
}

{
  "message": "服務鈴選項與特殊需求必須擇一"
}

{
  "message": "訂單不是用餐中，無法使用服務鈴"
}

{
  "message": "點餐人不屬於這張訂單，請重新加入點餐"
}

HTTP-Status-Code: 501（送 POS 尚未開放）

{
  "message": "服務鈴尚未開放"
}