Stored Value Card Refund

Description

儲值卡退款。

Resource

POST /v1/card/refund

Authorization

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

Request Body Parameters

Name	Type	Description
store_id	string	門市編號
vip_id	string	會員編號 (option)
order_id	string	訂單編號
returned_id	string	原訂單編號
transaction_id	string	加值平台交易編號
amount	integer	退款金額
client	string (enum)	客戶端 ALLOWED VALUES: ONLINE: 線上 OFFLINE: 線下

Request Example

{
    "store_id": "B001",
    "vip_id": "VIP0009",
    "order_id": "WiXtar001IC2024062700002",
    "returned_id": "WiXtar001IC2024062700001",
    "transaction_id": "B0012024061200002",
    "amount": 208,
    "client": "ONLINE"
}

Response Body Parameters

Name	Type	Description
code	Code	執行結果代碼
message	string	執行結果說明
transaction_info	Transaction Info	交易資訊 (option，code = 0000 才會回傳)

Response Body Parameters - Code

Status Code	Description
0000	執行成功
0001	卡片未開卡
0002	卡片已關卡
0003	卡片已作廢
0004	卡片已開卡
0005	信託額度不足
0006	舊卡號不得等於新卡號
0007	舊卡狀態不符
0008	新卡狀態不符
0009	卡號不得為空
0010	條碼不存在
0011	手機號碼必須相同
0012	會員ID已記名
0013	卡號已存在
1001	禮物卡無法儲值
1002	卡片已超過儲值上限
1003	員工點無法儲值
2001	點數不足請先儲值
2002	該卡無法使用於此消費
3001	補點失敗
4001	查無此訂單
4002	退費金額不符(信託點)
4003	退費金額不符(贈點)
4004	退費金額不符(員工點)
5001	註冊帳號重複
5002	註冊手機重複
5003	註冊Mail重複
5004	查無該號碼的驗證碼請求
5005	驗證碼錯誤
5006	超過驗證時間
5007	帳號或密碼錯誤
5008	超過簡訊發送次數
5009	此卡片已綁定會員
5010	未設定認證發送方式
8001	UID或PID錯誤
8002	資料異常
8003	操作人員異常
9990	AES解密失敗
9992	key格式驗證錯誤
9993	檢查碼驗證失敗
9994	檢查碼不能為空
9995	實際交易加密電文不能為空
9996	模組名稱不能為空
9997	廠商串接專用代碼不能為空
9998	資料格式錯誤
9999	失敗

Response Body Parameters - Transaction Info

Name	Type	Description
card_no	string	儲值卡號
transaction_id	string	加值平台交易編號
balance	integer	儲值卡餘額

Response

HTTP-Status-Code: 200

{
    "code": "0000",
    "message": "執行成功",
    "transaction_info": {
        "card_no": "MO1234567876543",
        "transaction_id": "BBBuB20240607135745",
        "balance": 183
    }
}

HTTP-Status-Code: 400

{
    "code": "WX9999",
    "message": "依全通路回傳"
}