呼叫綠界API
注意事項:
接收傳送綠界科技API通知時,請特店系統開發人員確認下面事項,以利正常收到綠界科技發送的各項通知:
- 若您要使用電子發票服務,需與綠界提出申請方可使用。
- 請確認特店伺服器是否有開通防火牆,以避免回傳通知被防火牆阻擋。
- 呼叫綠界API連接port只提供https(443 port)連線方式,並請使用合法的DNS(Domain Name System)進行介接。
- 請確認各項交易參數傳送時是使用Http POST方式傳送至綠界API。
- 請確認特店伺服器URL連接port為http 80 port與https 443 port。
- 請勿將金鑰資訊(HashKey、HashIV)存放或顯示於前端網頁內,如Javascript、html、Css…等,避免金鑰被盜取使用造成損失及交易資料外洩。
- 回傳網址不支援中文網址,網址參數請使用punycode編碼後的網址,例如中文.tw 改成xn--fiq228c.tw。
- 為保障消費者權益與網路交易安全,綠界串接服務支援TLS 1.2之加密通訊協定。
- 如有超商KIOSK事務機列印需求, 除須向業務人員申請外, 請參照開立發票列印相關參數特別說明。
- 特店若有自行列印電子發票之需求需申請密碼種子,請聯繫業務人員辦理。
- 特店防火牆如需連到綠界主機,因為綠界主機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鎖定。 - 假如程式呼叫 API 的速度太快,會收到 HTTP Status Code 403 的狀態碼,此時請降低呼叫 API 的速度,並等候 30 分鐘後再重新呼叫,如果有高速存取 API 的需求,請先確認您具備「特約賣家」身分,並聯繫所屬業務人員。
- 如收到HTTP Status Code 500 的狀態碼,可能為資料格式錯誤、MerchantID與Key及IV不匹配(無權限)或加解密錯誤,請檢查收到的回傳訊息後重新傳送正確資料。