綁定信用卡 / 綁定信用卡結果通知 / ReturnURL

應用場景

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)
特店編號

MerchantMemberID String(30)
特店會員編號

BindCardID String(64)
綁定信用卡代碼

如收到的內容為null或空字串時,代表該筆訂單內容的綁卡資料已不存在或失效,並不影響交易授權的結果

IsSameCard Bool
此信用卡是否已重覆綁定

true:是,false:否。同個廠商會員是否,是否綁定相同的信用卡

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

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",
    }
}

				
			

❗ 注意事項:

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

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

綠界官方網站