物流整合API技術文件 / 常見技術FAQ

收到錯誤訊息:「找不到加密金鑰,請確認是否有申請開通此物流方式 」是什麼原因?

串接物流API時,若收到此錯誤訊息,主要發生於以下兩種情境:

  1. 串接電子地圖(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
  2. 串接建立物流訂單(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

●注意事項●

  1. 不同的MerchantID有其配對的HashKey及HashIV,故更換MerchantID時,HashKey及HashIV請一併更換。
  2. 請留意複製過程中是否有空白鍵(並請用複製貼上的方式),手動key容易不小心多一格空白就會造成錯誤,將會導致介接失敗。 以綠界科技提供的測試MerchantID為例:
    MerchantID(測試)HashKeyHashIV
    2000132 (B2C)5294y06JbISpM5x9v77hoKGq4kWxNNIS
    2000933 (C2C)XBERn1YOvpM9nfZch1ONHk4P4yqbl5LK
  3. 賣家的LogisticsSubType參數值,請依據向綠界科技申請的物流模式是B2CC2C,設定對應的參數值。 可至綠界管理後台查詢,路徑為物流管理→物流建單及查詢→物流廠商。 若在”物流廠商”選項內有”店到店“,則物流類型為C2C (反之為B2C) 例: 使用7-11交貨便服務,申請的物流模式為C2C,則對應的LogisticsSubType應為UNIMARTC2C。

收到錯誤訊息:「 0 | 很抱歉,此帳號目前暫停使用,如有問題請洽客服協助 」該如何處理?

錯誤訊息情境:建立物流訂單後(https://logistics.ecpay.com.tw/Express/Create) 出現此錯誤。

錯誤原因:店家實際上未送出參數/參數值,因此綠界API未收到。

未收到原因包含:

  1. 未開通物流服務 或 帳號有問題。
  2. Content Type錯誤,例如使用Content Type: application/json。綠界API僅支援form-data
  3. 環境切換錯誤,例如:呼叫綠界正式環境 API https://logistics.ecpay.com.tw/Express/Create,但使用綠界測試MerchantID (2000132 或 2000933)。
  4. 送出的MerchantID參數值為空。
  5. TLS1.0未關閉導致送出的參數資料為空。

解決方式:

  1. 先確認物流服務是否正常開通。
  2. 先檢查使用的 MerchantID與API URL是否一致。
  3. 確認Content Type是否誤用application/json
  4. 確認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」,可能原因:

  1. 電子地圖畫面閒置過久(超過3分鐘)
  2. 電子地圖畫面是「超商端系統」,非綠界控制。若消費者同時開啟多個電子地圖選取頁面,也會導致本狀況。
  3. 串接時,另開視窗點選地圖也會導致本狀況。

解決方法:

  1. 請清除 cookie,或是更換瀏覽器後再嘗試。
  2. 避免同時開啟多個電子地圖畫面,或是重複開啟電子地圖選取頁面。
  3. 串接開啟超商電子地圖時,請以原視窗開啟,避免另開新視窗。
  4. 避免使用 cURL 的方式發送。

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

綠界官方網站