收到錯誤訊息:「找不到加密金鑰,請確認是否有申請開通此物流方式 」是什麼原因?
串接物流API時,若收到此錯誤訊息,主要發生於以下兩種情境:
串接電子地圖(https://logistics.ecpay.com.tw/Express/map)
原因:MerchantID 與呼叫的環境(API URL) 或 LogisticsSubType (物流子類型) 沒有正確配對。

解決方式:
請修正所呼叫的API URL網址、或者調整LogisticsSubType的參數值、或更換使用的MerchantID。 請參考:測試/正式 MerchantID 環境(API URL) LogisticsSubType的參數值 測試 2000132(B2C) 2000933(C2C) https://logistics-stage.ecpay.com.tw/Express/map (測試環境:API URL有-stage字樣) FAMI UNIMART HILIFE FAMIC2C UNIMARTC2C HILIFEC2C 正式 賣家的綠界會員編號(7位數字) https://logistics.ecpay.com.tw/Express/map (正式環境:API URL沒有-stage字樣) 依據賣家申請的物流模式是B2C或C2C。 ※B2C=FAMI 或 UNIMART或 HILIFE ※C2C=FAMIC2C 或 UNIMARTC2C 或 HILIFEC2C 串接建立物流訂單(https://logistics.ecpay.com.tw/Express/Create)
原因:MerchantID 與 LogisticsSubType (物流子類型) 沒有正確配對。

解決方式:
請依據所申請的物流類型(B2C或C2C),修正LogisticsSubType的參數值。 例如(以綠界提供的兩組測試MerchantID為例):MerchantID(測試) LogisticsSubType 2000132 (B2C) FAMI UNIMART HILIFE 2000933 (C2C) FAMIC2C UNIMARTC2C HILIFEC2C
●注意事項●
- 不同的MerchantID有其配對的HashKey及HashIV,故更換MerchantID時,HashKey及HashIV請一併更換。
- 請留意複製過程中是否有空白鍵(並請用複製貼上的方式),手動key容易不小心多一格空白就會造成錯誤,將會導致介接失敗。 以綠界科技提供的測試MerchantID為例:
MerchantID(測試) HashKey HashIV 2000132 (B2C) 5294y06JbISpM5x9 v77hoKGq4kWxNNIS 2000933 (C2C) XBERn1YOvpM9nfZc h1ONHk4P4yqbl5LK - 賣家的LogisticsSubType參數值,請依據向綠界科技申請的物流模式是B2C或C2C,設定對應的參數值。 可至綠界管理後台查詢,路徑為物流管理→物流建單及查詢→物流廠商。 若在”物流廠商”選項內有”店到店“,則物流類型為C2C (反之為B2C) 例: 使用7-11交貨便服務,申請的物流模式為C2C,則對應的LogisticsSubType應為UNIMARTC2C。
收到錯誤訊息:「 0 | 很抱歉,此帳號目前暫停使用,如有問題請洽客服協助 」該如何處理?
錯誤訊息情境:建立物流訂單後(https://logistics.ecpay.com.tw/Express/Create) 出現此錯誤。
錯誤原因:店家實際上未送出參數/參數值,因此綠界API未收到。
未收到原因包含:
- 未開通物流服務 或 帳號有問題。
- Content Type錯誤,例如使用Content Type: application/json。綠界API僅支援form-data
- 環境切換錯誤,例如:呼叫綠界正式環境 API https://logistics.ecpay.com.tw/Express/Create,但使用綠界測試MerchantID (2000132 或 2000933)。
- 送出的MerchantID參數值為空。
- TLS1.0未關閉導致送出的參數資料為空。
解決方式:
- 先確認物流服務是否正常開通。
- 先檢查使用的 MerchantID與API URL是否一致。
- 確認Content Type是否誤用application/json
- 確認TLS 1.0 是否已關閉。
若以上檢查後仍無法排查問題,請提供可建立物流訂單的網址到技術支援中心以利進一步確認。
收到錯誤訊息:「10500036 | 收件人姓名請設定為 4~10 字元(中文 2~5 個字, 英文 4~10 個字)」 該如何處理
由於超商取貨服務有以下注意事項(此為超商規範)
►收件者姓名規範:字元限制為為4~10字元(中文2~5個字, 英文4~10個字)
►貨到付款(取貨付款):不會核對姓名資訊,但會詢問手機末三碼
►0元純取貨(取貨不付款):皆需要核對姓名資訊
因此外籍人士姓名過長時,建議使用貨到付款,避免姓名驗證問題。
若要使用0元付款,請攜帶居留證或護照前往領取。
無法列印託運單-出現歡迎使用綠界科技ECPay Logistics
若使用server端處理post資料並接收,有可能會發生預期外錯誤。
例如:
使用WebRequest(C# 物件)來接收 api 回傳資料,出現「歡迎使用綠界科技ECPay Logistics!」


使用postman測試API,則會停留在「交易資料傳輸中…請勿關閉視窗,以避免交易失敗!」
正確使用方式:
請將POST資料使用client端處理,綠界系統會協助進行轉跳至託運單列印頁面

呼叫選擇電子地圖API,點選電子地圖後,畫面卻只有「歡迎使用綠界科技 ECPay Logistics」?

若呼叫選擇電子地圖 API 時,點選電子地圖後,畫面只有「歡迎使用綠界科技 ECPay Logistics」,可能原因:
- 電子地圖畫面閒置過久(超過3分鐘)
- 電子地圖畫面是「超商端系統」,非綠界控制。若消費者同時開啟多個電子地圖選取頁面,也會導致本狀況。
- 串接時,另開視窗點選地圖也會導致本狀況。
解決方法:
- 請清除 cookie,或是更換瀏覽器後再嘗試。
- 避免同時開啟多個電子地圖畫面,或是重複開啟電子地圖選取頁面。
- 串接開啟超商電子地圖時,請以原視窗開啟,避免另開新視窗。
- 避免使用 cURL 的方式發送。