付款 / 定期定額付款結果通知

應用場景

當訂單是使用信用卡定期定額的交易時,在每次授權成功後,綠界會傳送付款通知結果

  • Step 1. 綠界:第二次授權是由綠界的排程進行授權,交易授權成功後以Server POST方式傳送付款通知至特店傳送的付款完成通知回傳網址[PeriodReturnURL]。
  • Step 2. 特店:收到綠界的付款通知訊息後,需比對檢查碼是否相符。

❗ 注意事項:

  • 第一次授權成功時,付款結果參數會回傳到付款完成通知回傳網址[ReturnURL],
  • 第二次授權成功是由綠界的排程進行授權,所以從第二次開始的資料,都是回傳到所設定的付款完成通知回傳網址[PeriodReturnURL]。

HTTPS 傳輸協定

  • Accept :text/html
  • Content Type :application/x-www-form-urlencoded
  • HTTP Method :POST

綠界回傳參數說明

MerchantID String(10) 
特店編號

MerchantTradeNo String(20) 
特店交易編號

訂單產生時傳送給綠界的特店交易編號。

StoreID String(20)
特店旗下店舖代號

RtnCode Int
交易狀態 

  • 若回傳值為1時,為付款成功
  • 其餘代碼皆為交易異常,請至廠商管理後台確認後再出貨。

RtnMsg String(200)
交易訊息

PeriodType String(1)
訂單建立時所設定的週期種類 

訂單建立時所設定的週期種類

Frequency Int
訂單建立時所設定的執行頻率 

訂單建立時所設定的執行頻率

ExecTimes Int
訂單建立時所設定的執行次數 

訂單建立時所設定的執行次數

Amount Int
本次授權金額

此次所授權的金額

Gwsr Int
授權交易單號 

ProcessDate String (20)
處理時間

格式 yyyy/MM/dd HH:mm:ss

AuthCode String(6)
授權碼

授權碼

FirstAuthAmount Int
初次授權金額

定期定額交易的第一筆授權金額。

TotalSuccessTimes Int
已執行成功次數

目前已成功授權的次數。

SimulatePaid Int
是否為模擬付款

  • 當交易為模擬付款時,才會回傳此欄位
  • 1:代表此交易為模擬付款,RtnCode也為1。並非是由消費者實際真的付款,所以綠界也不會撥款給廠商,請勿對該筆交易做出貨等動作,以避免損失。

❗ 注意事項:

  1. 特店可透過廠商後台來針對單筆訂單模擬綠界回傳付款通知,以方便介接API。
  2. 此功能僅只是用於測試ReturnURL是否能成功接收,不會改變付款狀態。
  3. 只有透過廠商後台的定期定額查詢功能發動的模擬付款通知,綠界才會傳送此參數,正常由定期定額排程所發送的付款通知,不會傳送此參數。

CustomField1 String(50)
自訂名稱欄位1

提供合作廠商使用記錄用客製化使用欄位

CustomField2 String(50)
自訂名稱欄位2

提供合作廠商使用記錄用客製化使用欄位

CustomField3 String(50)
自訂名稱欄位3

提供合作廠商使用記錄用客製化使用欄位

CustomField4 String(50)
自訂名稱欄位4

提供合作廠商使用記錄用客製化使用欄位

CheckMacValue String
檢查碼

特店必須檢查檢查碼來驗證資料是否正確,請參考附錄檢查碼機制

❗ 注意事項:

  1. 特店務必判斷檢查碼[CheckMacValue]是否正確,以及是否已經對該筆訂單的付款通知,做過相對應的處理,以免造成交易狀態無法同步的損失。
  2.  [PeriodReturnURL]每期僅會收到一次通知,如未收到通知,請利用信用卡定期定額訂單查詢取得實際授權結果。
  3. 若遇消費者已付款,但未收到綠界回傳付款完成資訊,此時請檢查接收回傳參數的伺服器是否服務正常,導致無法接收。請參考:無法收到綠界回傳的付款結果通知
  4. 當模擬付款[SimulatePaid]的值為1時,表示此筆訂單資訊是由綠界廠商後台模擬付款按鈕所發送的回傳付款通知測試資訊,並非是由消費者實際真的付款,所以綠界也不會撥款給特店,請勿對該筆交易做出貨等動作,以避免損失。
  5. 特店務必判斷交易狀態[RtnCode]是否為1,若非1時請勿對該筆交易做出貨動作,並取得交易訊息[RtnMsg] 記錄失敗原因。

特店回覆參數說明

回傳值為純字串並無參數名稱。
若收到綠界回傳結果通知,請回傳1|OK,此訊息僅代表特店回應是否已收到綠界回傳通知,並不會影響訂單的狀態。

				
					1|OK

				
			

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

綠界官方網站