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": "星益欣會員複合式還原交易失敗:..."
}
說明:外部會員平台回應異常或連線失敗。