Lock Group
Description
收單鎖定。 此 API 讓已登入的團主鎖定一個「團購主訂單」,鎖定後無法再加入或修改訂單,但稍後可視需要重新開啟。
Resource
POST /v1/order/group/{group_order_id}/lock
Authorization
採用 OAuth 2.0 Bearer Token,需帶入會員 Token (acckey) 以識別團主身分。
詳細使用流程請參考 Auth Login。
Path Parameters
| Name | Type | Description |
|---|---|---|
| group_order_id | string | 團主訂單編號 |
Request Body Parameters
| Name | Type | Description |
|---|---|---|
| store | Store | 門市 |
| customer | Customer | 訂購人資訊 (Ocard 會員驗證身分必填) |
Request Body Parameters - Store
| Name | Type | Description |
|---|---|---|
| id | string | 門市代碼 |
Request Body Parameters - Customer
| Name | Type | Description |
|---|---|---|
| id | string | 會員編號 (optional) |
| name | string | 姓名 |
| mobile | string | 手機號碼 (optional) |
| address | string | 地址,銷售方式為外送時必填 (order.type is DELIVERY) (optional) |
| vip_group_id | string | vip群組代碼 (optional) |
Request Example
{
"store": {
"id": "A01"
},
"customer": {
"name": "小明"
"mobile": "0912345678"
}
}
Response Body Parameters
| Name | Type | Description |
|---|---|---|
| id | string | 訂單編號 |
Response
{
"id": "A012601090001"
}
Notes
- 必須是該團購單的擁有者 (團主) 才能執行鎖定操作,否則會回傳 403 Forbidden。
- 若為 Ocard 會員,需於 Request Body
customer提供手機號碼以驗證身分。 - 鎖定後狀態將變更為
LOCK('1')。