準備事項 / 介接注意事項

呼叫綠界API注意事項

  1. 請確認特店伺服器是否有開通防火牆,以避免回傳通知被防火牆阻擋。
  2. 呼叫綠界API連接port只提供https (443 port)連線方式,並請使用合法的DNS(Domain Name System)進行介接。
  3. 請確認各項交易參數傳送時是使用Http POST方式傳送至綠界API。
  4. 請確認特店伺服器URL連接porthttp 80 porthttps 443 port
  5. 請勿將金鑰資訊(HashKeyHashIV)存放或顯示於前端網頁內,如Javascript、html、Css…等,避免金鑰被盜取使用造成損失及交易資料外洩。
  6. 回傳網址不支援中文網址,網址參數請使用punycode編碼後的網址,例如中文.tw 改成xn--fiq228c.tw。
  7. 若您要使用電子發票服務,需與綠界提出申請方可使用。
  8. 為保障消費者權益與網路交易安全,綠界串接服務支援TLS 1.2之加密通訊協定。
  9. 如收到HTTP Status Code 500 的狀態碼,可能為資料格式錯誤、MerchantID與Key及IV不匹配(無權限)或加解密錯誤,請檢查收到的回傳訊息後重新傳送正確資料。

特店防火牆設定說明

特店防火牆如需連到綠界主機,因為綠界主機 IP 不固定,請以 FQDN 方式設定以下 domain:
  • einvoice.ecpay.com.tw TCP 443 (正式環境)
  • einvoice-stage.ecpay.com.tw TCP 443 (測試環境)

❗ 注意事項 

如貴司防火牆需固定IP,請至線上回報 https://member.ecpay.com.tw/ServiceReply/CreateProblem 申請,問題類別及子類別請選擇:申請主機IP鎖定。

特店防火牆如需允許綠界主機連入,請設定以下 domain 放行:

  • postgate.ecpay.com.tw TCP 443 (正式環境)
  • postgate-stage.ecpay.com.tw TCP 443 (測試環境)
❗ 注意事項:如貴司防火牆需固定IP,postgate IP 不須另外申請,請自行使用ping指令查詢IP的位址。

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

綠界官方網站