準備事項 / 介接注意事項

 注意事項：

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

1. 請確認特店伺服器是否有開通防火牆，以避免回傳通知被防火牆阻擋。
2. 呼叫綠界API連接port只提供https (443 port)連線方式，並請使用合法的DNS(Domain Name System)進行介接。
3. 請確認各項交易參數傳送時是使用Http POST方式傳送至綠界API。
4. 請確認特店伺服器URL連接port為http 80 port與https 443 port。
5. 請勿將金鑰資訊(HashKey、HashIV)存放或顯示於前端網頁內，如Javascript、html、Css…等，避免金鑰被盜取使用造成損失及交易資料外洩。
6. 回傳網址不支援中文網址，網址參數請使用punycode編碼後的網址，例如中文.tw 改成xn--fiq228c.tw。
7. 若您要使用電子發票服務，需與綠界提出申請方可使用。
8. 為保障消費者權益與網路交易安全，綠界串接服務支援TLS 1.2之加密通訊協定。
9. 特店防火牆設定說明
   • 特店防火牆如需連到綠界主機，因為綠界主機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的位址
10. 假如程式呼叫 API 的速度太快，會收到 HTTP Status Code 403 的狀態碼，此時請降低呼叫 API 的速度，並等候 30 分鐘後再重新呼叫，如果有高速存取 API 的需求，請先確認您具備「特約賣家」身分，並聯繫所屬業務人員。