綠界 API - fantasy0107/notes GitHub Wiki

綠界 API 介接文件

廠商後台
測試帳號/密碼 : StageTest/test1234 信用卡測試卡號 : 4311-9522-2222-2222 信用卡測試安全碼 : 222

設定相關

  1. 傳參數是有順序的
  2. CheckMacValue Error
綠界信用卡測試碼

4311-9522-2222-2222
222

產生訂單

ClientBackURL - Client 端返回特店的按鈕連結

消費者點選此按鈕後，會將頁面導回到此設定的網址

https://your.site/shopping/Detail

ReturnURL - 付款完成通知回傳網址

當消費者付款完成後，綠界會將付款結果參數以幕後(Server POST)回傳到該網址。

http://your.web.site/receive.php

//付款結果通知 form-data
Barcode1=&
Barcode2=&
Barcode3=&
ExpireDate=2017/12/2800:39:03&
MerchantID=2000132&
MerchantTradeNo=Test1513787899&
PaymentNo=LLL17355880822&
PaymentType=CVS_CVS&RtnCode=10100073&
RtnMsg=Get CVS Code Succeeded.&
TradeAmt=2000&
TradeDate=2017/12/2100:39:03&TradeNo=1712210038341592&
StoreID=&
CustomField1=&
CustomField2=&
CustomField3=&CustomField4=&
CheckMacValue=EA85AEB76DD14ED00016C41934471D877B53F5B292611AB29CA6FCBCE33205D0

注意

  1. 請勿設定與 Client 端接收付款結果網址 OrderResultURL 相同位置，避免程式判斷錯誤。
  2. 請在收到 Server 端付款結果通知後，請正確回應 1|OK 給綠界。

OrderResultURL - Client 端回傳付款結果網址

為付款完成後，綠界將頁面導回到特店網址，並將付款結果帶回

注意

  1. 沒帶此參數則會顯示綠界的付款完成頁。
  2. 建議在測試階段時先不要設定此參數，可將畫面停留在綠界，看見綠界所提供的錯誤訊息，便可以有效除錯。
  3. 若與[ClientBackURL]同時設定，將會以此參數為主。
  4. 測試只能在80與443 port
  5. 測試回傳要傳字串 '1|OK'