Skip to content

Wixtar Reverse

Description

星益欣會員複合式交易沖正。在星益欣會員門市環境下,訂單取消、作廢或退款成功後,由取消流程發起此端點請求,向星益欣會員平台執行整單沖正(反核銷點數折抵與票券)。 若訂單屬於非星益欣門市、訪客訂單或先前已執行過沖正,端點將直接略過處理並維持冪等成功回應。

Resource

PATCH /v1/order/{order_id}/wixtar-reverse

Authorization

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

Path Parameters

Name Type Description
order_id string 訂單編號(前綴為門市代碼,長度至少 12 碼)

Request Body Parameters

(無 Request Body)

Response

Success / Skipped Response

Status-Code: 204 No Content

說明:沖正執行成功,或滿足略過條件(非星益欣門市、訪客單無有效會員、先前已沖正過)。

Validation Error Response

Status-Code: 400 Bad Request

{
  "message": "訂單編號格式錯誤"
}

Unauthorized Response

Status-Code: 401 Unauthorized

{
  "message": "未授權"
}

Gateway Error Response

Status-Code: 502 Bad Gateway

{
  "message": "星益欣會員複合式還原交易失敗:..."
}

說明:外部會員平台回應異常或連線失敗。