應用場景
Client端方式(POST)(OrderResultURL)
當消費者綁定信用卡完成後，綠界一次性反饋綁定信用卡結果通知，並將頁面導至廠商自製頁面。
- Step1.綠界：傳送綁定信用卡結果並將頁面導至廠商的自製頁面網址。(OrderResultURL)
- Step2.特店：接收綠界的綁定信用卡結果訊息。
注意事項：
- 請務必根據回傳的交易狀態來判斷顯示綁定信用卡成功與否的頁面。
- 因各家銀行授權時間不同，若因授權時間過久未收到反饋訊息，請使用查詢綁定信用卡API後再顯示綁定信用卡結果。
- 若此參數設定網址未使用https時，部份瀏覽器可能會出現警告訊息提醒。
HTTPS 傳輸協定
- Accept ：text/html
- Content Type ：application/x-www-form-urlencoded
- HTTP Method ：POST
綠界Response參數說明
ResultData String
回傳參數
特店自製頁面接收的回傳參數
綠界Response參數範例
ResultData = 綠界回傳參數
綠界Response參數說明 (Json格式)
MerchantID String(10)
特店編號
RpHeader Object
回傳資料
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)
特店編號
MerchantMemberID String(30)
特店會員編號
BindCardID String(64)
綁定信用卡代碼
IsSameCard Bool
此信用卡是否已重覆綁定
true:是，false:否。同個廠商會員是否，是否綁定相同的信用卡
OrderInfo JSON
訂單資訊
MerchantTradeNo String(20)
特店交易編號
TradeNo String(20)
綠界交易編號
請保存綠界的交易編號與特店交易編號MerchantTradeNo的關聯。
TradeAmt Int
交易金額
TradeDate String(20)
訂單成立時間
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
金額
Eci Int
3D(VBV) 回傳值
Eci=5,6,2,1 代表該筆交易為3D交易
Card6No String(6)
信用卡卡號前六碼
Card4No String(4)
信用卡卡號末四碼
CardValidYY String(2)
信用卡有效年
格式為YY
CardValidMM String(2)
信用卡有效月
格式為MM
Stage Int
分期期數
有分期付款時回傳
Stast Int
首期金額
有分期付款時回傳
Staed Int
各期金額
有分期付款時回傳
CustomField String(200)
自訂欄位
提供特店使用客制化欄位
Data參數範例(Json格式)
{
"RtnCode": 1,
"RtnMsg": "Success",
"PlatformID": "1234567890",
"MerchantID": "1234567890",
"MerchantMemberID": "abcdefg",
"BindCardID": "a123dfgh",
"CardInfo": {
"Card6No": "123456",
"Card4No": "1234",
"CardValidYY": "25",
"CardValidMM": "12",
"AuthCode": "654123",
"Gwsr": 125,
"ProcessDate": "2022/09/18 15:39:10",
"Amount": 2
"Eci": 1,
},
"OrderInfo": {
"MerchantTradeNo": "test123466",
"TradeNo": "123456789",
"PaymentDate": "2022/09/18 15:39:10",
"TradeAmt": 2,
"PaymentType": "Credit",
"TradeDate": "2022/09/18 15:39:10",
"ChargeFee": 0,
"TradeStatus": "1",
}
}