# 準備事項 / 介接注意事項

## 前置準備事項

- 出貨前請務必詳閱跨境物流商之物流手冊：[統一數網：跨境物流進退貨規範手冊](https://www.ecpay.com.tw/Content/files/ecpay_061.pdf)
- 如帳戶餘額過低，將無法建立物流單，建議留存一定金額於綠界帳戶或至[廠商後台](https://vendor.ecpay.com.tw/PrepaidAccount/Create)預存綠界帳戶餘額供物流費扣款使用。

![❗](https://developers.ecpay.com.tw/wp-content/uploads/2022/02/warning-icon.png) **注意事項：**

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

1. 請確認通知回傳網址\[ServerReplyURL\]是否接受回傳資訊，且已開通防火牆對外連線。
2. 呼叫綠界科技API連接port只提供https (443 port)連線方式，並請使用合法的DNS(Domain Name System)進行介接。
3. 請確認各項交易參數傳送時是使用Http POST方式傳送至綠界科技API。
4. 請確認特店系統的Server URL連接port為http 80 port與https 443 port。
5. 傳送參數值的內容不允許使用html tag標示，例如：<br/> <B> <h1>…等。
6. 請勿將金鑰資訊存放或顯示於前端網頁內，如Javascript、html、Css…等，避免金鑰被盜取使用造成損失及交易資料外洩。
7. 串接API時有傳平台商編號PlatformID參數時，產生檢查碼及資料加密的金鑰，請使用平台商的HashKey及HashIV。
8. 回傳網址不支援中文網址，網址參數請使用punycode編碼後的網址，例如中文.tw 改成xn--fiq228c.tw。
9. 為保障消費者權益與網路交易安全，綠界串接服務只支援TLS 1.2之加密通訊協定。

## 特店防火牆設定說明

- 特店防火牆如需連到綠界主機，因為綠界主機 IP 不固定，請以 FQDN 方式設定以下 domain：
    logistics.ecpay.com.tw TCP 443 (正式環境)
    logistics-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的位址。