退款 / 取消交易 ​

信用卡請退款功能(Server) ​

應用場景 ​

當收到訂單授權成功，透由 查詢信用卡單筆明細記錄 API 取得[交易狀態]，再依[交易狀態]發動欲執行動作。

(1) 請款使用說明:信用卡付款成功，查詢訂單會顯示[已授權] (此時僅會佔用信用卡額度)，如果此筆訂單要送至銀行請款，須執行[關帳] (Action=C)。
(2) 執行[關帳]後，查詢訂單會顯示[要關帳]，表示歐買尬金流將要向銀行進行請款作業。
(3) 當歐買尬金流已向銀行完成[請款]作業，查詢訂單會顯示[已關帳]。

退款使用方式 ​

(1) 呼叫 查詢信用卡單筆明細記錄 API 取得狀態
(2) 查詢後，呼叫信用卡請退款 API:

  • [已授權]階段: 執行[放棄] (Action=N)可釋放信用卡佔額。
  • [要關帳]階段:
    • 全額退款: 先執行[取消] (Action=E)，接著進行[放棄] (Action=N)。
    • 部份退款: 執行[退刷] (Action=R)。
  • [已關帳]階段: 執行[退刷] (Action=R)。

(3) 當歐買尬金流已向銀行完成[請款]作業，查詢訂單會顯示[已關帳]。

執行動作說明 ​

(1) 「關帳」：訂單在每日 20:00 系統會自行關帳，歐買尬金流依關帳後的金額向銀行請/退款。
(2) 「退刷」：在系統關帳或自行關帳後，可修改訂單金額。
(3) 「取消」：可取消關帳，讓訂單回復關帳前的狀態。
(4) 「放棄」：適用在當日關帳前放棄此筆交易，不做請款。

介接路徑 ​

廠商傳入參數說明：(JSON 格式，名稱前若有紅色星號*為必填欄位)： ​

  • Content Type：application/json
  • HTTP Method：POST
參數 / 型態參數名稱說明
*MerchantID
String(10)		特店編號請填入由歐買尬金流提供的特店編號
*RqHeader
JSON		傳輸資料 
*Timestamp
Number		傳輸時間時間戳 Unix timestamp

※注意事項：
若時間戳跟歐買尬金流伺服器接收到時間超過 10 分鐘時，交易會失敗無法進行
*Revision
String(10)		串接版號請參考 系統介接測試相關資訊的串接版號。 例：1.0.0
*Data
String		加密資料加密過 JSON 格式的資料。加密方法說明

範例 ​

json
{
    "MerchantID": "1000031", 
    "RqHeader": 
    {
        "Timestamp": 1234567890,
        "Revision": "1.0.0"
    },
    "Data": "…"
}

Data參數說明：請在加密前對參數值進行 URLEncode ​

參數 / 型態參數名稱說明
MerchantID
String(10)		特店編號特店編號
RqHeader
JSON		傳輸資料 
Timestamp
Number		傳輸時間時間戳 Unix timestamp
TransCode
Int		回傳代碼1 代表傳輸資料(MerchantID，RqHeader，Data)接收成功，其餘均為失敗。
TransMsg
String(200)		回傳訊息回傳訊息
Data
String		加密資料加密過 JSON 格式的資料。加密方法說明

Data範例 ​

json
{
    "MerchantID": "1000031",
    "MerchantTradeNo": "20180914001",
    "TradeNo": "1809261503338172",
    "Action": "C",
    "TotalAmount": 100
}

買尬金流回傳參數說明：(JSON 格式) ​

參數 / 型態參數名稱說明
MerchantID
String(10)		特店編號 
RqHeader
JSON		傳輸資料 
Timestamp
Number		傳輸時間時間戳 Unix timestamp

※注意事項：
若時間戳跟歐買尬金流伺服器接收到時間超過 10 分鐘時，交易會失敗無法進行。
TransCode
Int		回傳代碼1 代表傳輸資料(MerchantID，RqHeader，Data)接收成功，其餘均為失敗。
TransMsg
String(200)		回傳訊息回傳訊息
Data
String		加密資料加密過 JSON 格式的資料。加密方法說明

範例 ​

json
{
    "MerchantID": "1000031", 
    "RpHeader": 
    {
        "Timestamp": 1234564848
    },
    "TransCode": 1,
    "TransMsg": "成功",
    "Data": "…"
}

Data參數說明：請在解密後對參數值進行 URLDecode ​

參數 / 型態參數名稱說明
RtnCode
Int		交易狀態1 代表 API 執行成功，其餘代碼均為失敗。
失敗代碼請參考交易訊息代碼表
RtnMsg
String(200)		回應訊息 
以下為 RtnCode 為 1 時才會回傳
PlatformID
String(10)		平台商編號特約合作平台商特店編號。
MerchantID
String(10)		特店編號 
MerchantTradeNo
String(20)		特店交易編號不可重複
TradeNo
String(20)		歐買尬金流的交易編號 

Data範例（解密後） ​

json
{
    "MerchantID": "1000031",
    "MerchantTradeNo": "20180914001",
    "TradeNo": "1809261503338172",
    "RtnCode": 1,
    "RtnMsg": ""
}