應用場景
Server端方式(POST)(ReturnURL)
當消費者付款完成後，特店接受綠界的付款結果訊息，並回應接收訊息
- Step1.綠界：以ServerPost方式傳送付款結果訊息至特店的Server網址(ReturnURL)
- Step2.特店：收到綠界的付款結果訊息，並判斷檢查碼是否相符
注意事項：
- 超商繳費條碼(BARCODE)因超商端作業時間關係會於消費者付款完成兩天後回傳。
- ATM、CVS、BARCODE可透過廠商管理後台的『模擬付款』，來確認ReturnURL是否正確接收付款結果通知。
- 付款結果通知常見付款狀態未更新原因說明。
- 1|OK僅是廠商回應綠界是否收到通知，並不會改變付款狀態。
HTTPS 傳輸協定
- Accept ：text/html
- Content Type：application/json
- HTTP Method：POST
綠界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)
特店編號
OrderInfo Object
訂單資訊
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 : 代表交易訂單成立已付款
CVSInfo Object
超商代碼資訊
付款方式為CVS時，回傳CVSInfo
PayFrom String(10)
繳費超商
- family：全家
- hilife：萊爾富
- okmart：OK 超商
- ibon：7-11
PaymentNo String(14)
繳費代碼
PaymentURL String(100)
繳費連結
BarcodeInfo Object
超商條碼資訊
付款方式為Barcode時，回傳BarcodeInfo
PayFrom String(10)
繳費超商
- family：全家
- hilife：萊爾富
- okmart：OK 超商
- ibon：7-11
ATMInfo Object
ATM資訊
付款方式為ATM時，回傳ATMInfo
ATMAccBank String(3)
付款人銀行代碼
ATMAccNo String(5)
付款人銀行帳號後五碼
CustomField String(200)
自訂欄位
提供特店使用客制化欄位
Data參數範例(Json格式)
{
"RtnCode": 1,
"RtnMsg": "Success",
"MerchantID": "3002607",
"OrderInfo": {
"MerchantTradeNo": "20180914001",
"TradeNo": "1809261503338172",
"TradeDate" :"2018/09/26 14:59:54"
},
"ATMInfo": {
"ATMAccBank": "000",
"ATMAccNo ": "12345"
}
}
注意事項：
- 若未正確回應1|OK，系統會隔5~15分鐘後重發訊息給特店，當天重複發送四次。
- 若特店持續收到綠界回傳付款資訊，此時請檢查是否未正確回應1|OK給綠界，常見錯誤回傳值為(“1|OK”、1|ok、_OK 、1\OK、空白 )。
- 若遇消費者已付款，但未收到綠界回傳付款完成資訊，此時請檢查接收回傳參數的伺服器是否服務正常，導致無法接收。請參考：無法收到綠界回傳的付款結果通知
- 當模擬付款SimulatePaid的值為1時，表示此筆訂單資訊是由綠界廠商後台模擬付款按鈕所發送的回傳付款通知測試資訊，並非是由消費者實際真的付款，所以綠界也不會撥款給特店，請勿對該筆交易做出貨等動作，以避免損失。
- 特店務必判斷交易狀態RtnCode是否為1，若非1時請勿對該筆交易做出貨動作，並取得交易訊息RtnMsg記錄失敗原因。