介接注意事項

呼叫綠界API

接收傳送綠界API通知時,請開發人員確認下面事項,以利正常收到綠界發送的各項通知:

  • 請確認Server是否有開通防火牆,以避免付款通知被防火牆阻擋。
  • 呼叫API連接port只提供https (443 port)連線方式,並請使用DNS(Domain Name System)進行介接。
  • 請確認各項交易參數傳送時是使用Http POST方式傳送至綠界API。
  • 請確認Server URL連接port為http 80 port與https 443 port。
  • 傳送參數值的內容不允許使用html tag 標示,例如 <br /> <B> <h1>…等。
  • 測試環境信用卡付款方式未提供海外卡及銀聯卡服務。
  • 傳送參數值的內容請用UTF8格式,且不支援中英文語系之外的文字內容。
  • 回傳網址不支援中文網址,網址參數請使用punycode編碼後的網址,例如中文.tw 改成xn--fiq228c.tw。
  • 請先申請關閉OTP服務及申請開啟信用卡3D驗證服務才能完成串接交易。
  • 為保障消費者權益與網路交易安全,串接服務只支援TLS 1.2 加密通訊協定

特店防火牆設定說明

  • 特店防火牆如需連到綠界主機,因為綠界主機 IP 不固定,請以 FQDN 方式設定以下 domain: 
    正式環境 : payment.ecpay.com.tw TCP 443  
    測試環境 : payment-stage.ecpay.com.tw TCP 443
    如貴司防火牆需固定IP,請至線上回報 https://member.ecpay.com.tw/ServiceReply/CreateProblem 申請,問題類別及子類別請選擇:申請主機IP鎖定。
  • 特店防火牆如需允許綠界主機連入,請設定以下 domain 放行: 
    正式環境 : postgate.ecpay.com.tw TCP 443 
    測試環境 : postgate.ecpay.com.tw TCP 443,postgate-stage.ecpay.com.tw TCP 443  
    如貴司防火牆需固定IP,postgate IP 不須另外申請,請自行使用ping指令查詢IP的位址。

付款完成通知回傳網址[ReturnURL]

  • 付款結果通知回傳網址ReturnURL為特店的Server或主機的URL,用來接收綠界後端回傳的付款結果通知。測試呼叫綠界API時請確認ReturnURL的連線已開放對外。
  • 若賣家使用CDN服務(Content Delivery Network),也就是賣家的主機不在台灣、但透過CDN服務提供網站資料給台灣或相鄰地區的使用者,ReturnURL請設定主機的URL,不設定為CDN網址以避免主機無法接收付款結果。
  • 綠界API僅支援HTTPHTTPS (80 port及443 port);ReturnURL請避免指定port否則導致無法接收綠界回傳付款結果通知。
  • ReturnURL不支援中文網址,若為中文網址參數請使用 punycode 編碼後的網址,例如中文.tw 改成 xn--fiq228c.tw。

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

綠界官方網站