綁定信用卡後交易 / 付款結果通知

應用場景

Server端方式(POST)(ReturnURL)
當幕後交易授權完成後，特店接受綠界的付款結果訊息，並回應接收訊息。

Step1.綠界：以ServerPost方式傳送付款結果訊息至廠商的Server網址(ReturnURL)
Step2.特店：收到綠界的付款結果訊息，回應1|OK

注意事項：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)
付款方式

Credit: 信用卡

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
金額

Card6No String(6)
信用卡卡號前六碼

Card4No String(4)
信用卡卡號末四碼

IssuingBank String(30)
銀行名稱

IssuingBankCode String(10)
銀行代碼

Stage Int
分期期數

分期付款時回傳

Stast Int
首期金額

分期付款時回傳

Staed Int
各期金額

分期付款時回傳

CoBrandingInfo Array[Object]
聯名卡資料

CoBrandingCode String(20)
聯名卡代號

Comment String(100)
備註

CustomField String(200)
自訂欄位

Data參數範例(Json格式)

				
					{
    "RtnCode": 1,
    "RtnMsg": "Success",
    "PlatformID": "1234567890",
    "MerchantID": "1234567890",
    "CardInfo":
    {
        "Card6No": "123456",
        "Card4No": "1234",
        "IssuingBank": "中國信託商業銀行",
        "IssuingBankCode ": "822",
        "AuthCode": "654123",
        "Gwsr": 125,
        "ProcessDate": "2022/09/18 15:39:10",
        "Amount": 2,
        "Card6No":"123456",
        "Card4No":"1234",
        "IssuingBank":"中國信託",
        "IssuingBankCode":"822"
    },
    "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",
    },
    "CoBrandingInfo":[
        {
            "CoBrandingCode":"123456789",
            "Comment":"中信聯名卡"
        }
    ]
}

注意事項：

若未正確回應1|OK，系統會隔5~15分鐘後重發訊息給特店，當天重複發送四次。
若特店持續收到綠界回傳付款資訊，此時請檢查是否未正確回應1|OK給綠界，常見錯誤回傳值為(“1|OK”、1|ok、_OK 、1\OK、空白 )。
若遇消費者已付款，但未收到綠界回傳付款完成資訊，此時請檢查接收回傳參數的伺服器是否服務正常，導致無法接收。請參考：無法收到綠界回傳的付款結果通知
特店務必判斷交易狀態RtnCode是否為1，若非1時請勿對該筆交易做出貨動作，並取得交易訊息RtnMsg記錄失敗原因。

綠界官方網站