應用場景
當訂單是使用信用卡定期定額的交易時，在每次授權成功後，綠界會傳送付款通知結果
- Step1.綠界：第二次授權是由綠界的排程進行授權，交易授權成功後以Server POST方式傳送付款通知至特店傳送的付款完成通知回傳網址PeriodReturnURL
- Step2.特店：收到綠界的付款通知訊息後，回應1|OK
注意事項：
- 第一次授權成功時，付款結果參數會回傳到付款完成通知回傳網址ReturnURL
- 第二次授權成功是由綠界的排程進行授權，所以從第二次開始的資料，都是回傳到所設定的付款完成通知回傳網址PeriodReturnURL
HTTPS 傳輸協定
- Accept ：text/html
- Content Type：application/json
- HTTP Method：POST
綠界Response參數說明 (Json格式)
MerchantID String(10)
特店編號
RpHeader JSON
回傳資料
Timestamp Number
回傳時間
時間戳 Unix timestamp
TransCode Int
回傳代碼
1 代表 API 傳輸資料 (MerchantID, RqHeader, Data) 接收成功，實際的API執行結果狀態請參考 RtnCode 參數
TransMsg String(200)
回傳訊息
Data String
加密資料
此參數為加密過的 JSON 格式資料
綠界Response參數範例 (Json格式)
{
"MerchantID": "3002607",
"RpHeader": {
"Timestamp": 1234564848
},
"TransCode": 1,
"TransMsg": "Success",
"Data": "…"
}
Data參數說明(Json格式)
RtnCode Int
交易狀態
1 代表 API 執行成功，其餘代碼均為失敗，失敗代碼請參考交易訊息代碼表。
RtnMsg String(200)
回應訊息
PlatformID String(10)
平台商編號
MerchantID String(10)
特店編號
OrderInfo JSON
訂單資訊
MerchantTradeNo String(20)
特店交易編號
TradeNo String(20)
綠界交易編號
請保存綠界的交易編號與特店交易編號MerchantTradeNo的關聯。
TradeAmt Int
交易金額
TradeDate String(20)
訂單成立時間
格式為 yyyy/MM/dd HH:mm:ss
PaymentType String(20)
付款方式
PaymentDate String(20)
付款時間
格式為 yyyy/MM/dd HH:mm:ss
ChargeFee Number
手續費
TradeStatus String(8)
交易狀態
- 0 :代表交易訂單成立未付款
- 1 : 代表交易訂單成立已付款
CardInfo JSON
信用卡授權資訊
AuthCode String(6)
銀行授權碼
Gwsr Int
授權交易單號
ProcessDate String(20)
交易時間
格式為yyyy/MM/dd HH:mm:ss
Amount Int
金額
Stage Int
分期期數
Stast Int
首期金額
Staed Int
各期金額
Eci Int
3D(VBV) 回傳值
Eci=5,6,2,1 代表該筆交易為3D交易
Card6No String(6)
信用卡卡號前六碼
Card4No String(4)
信用卡卡號末四碼
PeriodType String(1)
週期種類
Frequency Int
執行頻率
ExecTimes Int
執行次數
PeriodAmount Int
訂單建立時的每次要授權金額
TotalSuccessTimes Int
目前已成功授權的次數
TotalSuccessAmount Int
目前已成功授權的金額合計
IssuingBank String(30)
銀行名稱
IssuingBankCode String(10)
銀行代碼
CustomField String(200)
自訂欄位
提供特店使用客制化欄位
Data參數範例(Json格式)
{
"RtnCode": 1,
"RtnMsg": "Success",
"MerchantID": "3002607",
"OrderInfo": {
"MerchantTradeNo": "20180914001",
"TradeNo": "1809261503338172",
"TradeDate" :"2018/09/26 14:59:54"
},
"CardInfo": {
"Gwsr": 10735183,
"ProcessDate": "2018/09/26 14:59:54",
"AuthCode": "777777",
"Amount": 100,
"Eci": 2,
"Card4No": "2222",
"Card6No": "491122",
"Frequency": 5,
"ExecTimes": 5,
"PeriodAmount": 500,
"TotalSuccessTimes": 2,
"TotalSuccessAmount":1000,
"IssuingBank":"玉山",
"IssuingBankCode":"808"
}
}
注意事項：
- PeriodReturnURL每期僅會收到一次通知，如未收到通知，請利用信用卡定期定額訂單查詢取得實際授權結果。
- 若遇消費者已付款，但未收到綠界回傳付款完成資訊，此時請檢查接收回傳參數的伺服器是否服務正常，導致無法接收。請參考：無法收到綠界回傳的付款結果通知
- 特店務必判斷交易狀態RtnCode是否為1，若非1時請勿對該筆交易做出貨動作，並取得交易訊息RtnMsg記錄失敗原因。