呼叫綠界API
- 請確認各項交易參數傳送時是使用 Http POST 方式傳送至綠界API。
- 傳送參數值的內容不允許使用 html tag 標示，例如：<br/> <B> <h1> …等。
- 請勿將重要的加密金鑰資訊(例如:HashKey及HashIV)存放或顯示於前端網頁內程式碼內例如：JavaScript、HTML、CSS…等，避免金鑰被盜取使用造成損失及交易資料外洩。
- 合作特店須進行主機「時間校正」，避免主機產生時差，延伸 API 無法正常運作。
- 為保障消費者權益與網路交易安全，綠界串接服務只支援 TLS 1.2 之加密通訊協定。
- 假如程式呼叫 API 的速度太快，會收到 HTTP Status Code 403 的狀態碼，此時請降低呼叫 API 的速度，並等候 30 分鐘後再重新呼叫，如果有高速存取 API 的需求，請先確認您具備「特約賣家」身分，並聯繫所屬業務人員。
特店防火牆設定說明
- 特店防火牆如需連到綠界主機，因為綠界主機 IP 不固定，請以 FQDN 方式設定以下 domain：
- ecpayment.ecpay.com.tw TCP 443 (正式環境)
- ecpayment-stage.ecpay.com.tw TCP 443 (測試環境)
- 如貴司防火牆需固定IP，請至線上回報申請，問題類別及子類別請選擇：申請主機IP鎖定。
- 特店防火牆如需允許綠界主機連入，請設定以下 domain 放行：
- 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僅支援HTTP及HTTPS (80 port及443 port)；ReturnURL請避免指定port否則導致無法接收綠界回傳付款結果通知。
- ReturnURL不支援中文網址，若為中文網址參數請使用 punycode 編碼後的網址，例如中文.tw 改成 xn--fiq228c.tw。