Ocard Check Redeem

Description

Ocard 票券核銷前置驗證。KIOSK 呼叫此 API 確認 Ocard 票券是否可核銷；全通路內部自動取得 shop-level Ocard auth，KIOSK 不需傳入 uid/token。Ocard token 過期（code=305）時系統自動重試一次。

POST /v2/ticket/ocard/check_redeem

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

Name	Type	Description
store_id	string	門市代碼（用於內部查詢 Ocard shop-level auth）
code	string	Ocard 票券 pos_code（= `coupon_list[].pos_code`，來自 Ocard Login 回傳）
count	integer	票券數量（optional）
transDetail	object	交易明細（optional）
checkSpend	number	消費金額確認（optional）

POST /v2/ticket/ocard/check_redeem

{
    "store_id": "000030",
    "code": "0PM202512160001"
}

Name	Type	Description
usable	boolean	票券是否可核銷。Ocard `response.code=500`（成功）→ `true`；其他 → `false`
message	string	Ocard 回傳訊息；305 認證失敗時固定回傳「Ocard 認證失敗，請重新登入」

{
    "usable": true,
    "message": ""
}

{
    "usable": false,
    "message": "此票券已使用"
}

{
    "usable": false,
    "message": "Ocard 認證失敗，請重新登入"
}