常見問題 (Q&A)

Q:如果收到 http status code 403 該如何處理?

代表此IP並未加至街口端的店鋪代碼(store_id),請聯繫你的業務窗口進一步處理。

Q:如果收到 http status code 405 該如何處理?

代表 http method 用錯,請先參考 API列表

Q:如果收到 result code 201 該如何處理?

請先參考 加簽加密說明

Q:如果收到 result code 200 該如何處理?

可能為參數錯誤,只能帶整數值卻帶到小數;或是 confirm_url/result_url 應是 https 開頭,但帶成 http。

Q:如果付款失敗,錯誤訊息是[訂單已失效,請至平台確認],可能原因如下

  1. QRCode 每次產生有效時間 20 min。若超過時限,需使用同一個 platform_order_id 再呼叫一次。
  2. 超過商戶 Entry API 設定的 valid_time 不給付。
  3. Entry API 商戶有提供 confirm_url,但街口端 Server 打過去未收到商戶 “valid”: true 的回覆。
  4. 設定的網址有誤,可能設定到 Locaolhost 或內網。

Q:為什麼建議實作 result url?

為了確保商家系統能即時且準確地接收到交易結果。若未實作此機制,將完全仰賴商戶端主動呼叫 Inquiry API 查詢訂單狀態,可能影響使用者體驗。

Q:為何可能發生 result callback 失敗?

若商家所提供的 Server URL 使用的是非公開憑證(例如自簽憑證或無效的憑證),街口系統可能會因安全性考量而無法成功連線,導致 callback 被阻擋或失敗。建議商家使用由公開憑證機構(CA)簽發的有效憑證,以確保 callback 能順利完成。