端點
訂單號碼
取得訂單號碼清單。
訂單詳細資料
取得訂單的詳細資訊。
取得訂單 API 端點使用方式
有兩種常見的方式使用這些端點。
- （第 1 部分 + 第 2 部分）– 在您的網域上使用自訂訂單確認/成功頁面，以觸發您的系統呼叫
orderDetail端點並匯入已完成的訂單。另外，定期呼叫orderNumbers端點以協調任何未匯入到您系統的 Zonos System 訂單。 - （僅第 2 部分）– 使用 Zonos 基本訂單確認/成功頁面或您網域上的靜態頁面，向客戶表示訂單完成。排程您的系統定期呼叫
orderNumbers端點以確定何時新訂單準備好匯入到您的系統中。當發現未結訂單時，為這些訂單呼叫orderDetail端點以取得資料。
第 1 部分：您網域上的成功頁面
每次買家在 Zonos Checkout 中完成訂單時，他們會立即被重新導向至訂單成功頁面 URL。已完成的訂單 ID 會作為查詢字串附加到重新導向 URL。訂單成功頁面的 URL 應提供給 Zonos。建立 Zonos System 中的暫時購物車時，也可以在 createTempCart 端點中作為參數傳遞 URL。
範例：http://www.examplestore.com/internationalThankYou?orderId=999-99999
當客戶被重新導向至此頁面時，您的系統需要從 URL 解析 orderId 值。然後您將使用 orderId 呼叫 orderDetail 端點以取得訂單資料。
第 2 部分：使用排程工作
除了在成功頁面觸發時呼叫訂單詳細資料，我們建議您為所有訂單及其詳細資料設定排程呼叫作為全面涵蓋。這樣，您可以取得任何已完成但尚未匯入到您系統的 Zonos System 訂單。
此程序應該是排程工作/指令碼，例如 Cron 工作，每小時/班次/天/等執行一次（依您的業務流程需求進行調整）。此指令碼應呼叫自上次呼叫訂單以來發生的所有訂單及其詳細資料。如此處位置的 API 測試 GUI 所示，orderNumbers 端點允許您取得 sinceOrderId 或 sinceDate 訂單。通過此排程呼叫取得的所有訂單應該針對每次成功頁面觸發時插入您系統的訂單進行協調。任何尚未在您系統中的訂單應插入到您的系統中並視為合法訂單。
初始訂單狀態
IGLOBAL_ORDER_IN_PROCESS 或 IGLOBAL_FRAUD_REVIEW
呼叫 orderDetail 端點時，我們建議您的系統首先檢查訂單資料的 orderStatus 屬性。
不需要詐欺審查的訂單將使用 orderStatus : IGLOBAL_ORDER_IN_PROCESS 初始化。此狀態的訂單已準備好進行處理和運送。
需要詐欺審查的訂單將在 orderStatus : IGLOBAL_FRAUD_REVIEW 中初始化。此狀態的訂單目前正在進行可疑詐欺的篩選和審查。我們建議您在您的系統中將此訂單置於審查或保留狀態，並繼續呼叫 orderDetail 端點，直到訂單通過 Zonos 詐欺審查程序。
Zonos 詐欺篩選程序完成後，訂單將移至以下其中一個狀態：
-
訂單通過詐欺篩選
- 訂單將移至
orderStatus:IGLOBAL_ORDER_IN_PROCESS並可繼續進行運送。
- 訂單將移至
-
訂單未通過詐欺篩選
- 訂單將移至
orderStatus:IGLOBAL_ORDER_CANCELLED，應在您的系統中取消。
- 訂單將移至
API 測試 GUI
請 聯絡支援 以取得您的帳戶認證。
取得訂單
取得訂單號碼清單或訂單的詳細資訊。
「取得訂單」API 端點用於在 Zonos System 內取得已完成訂單的資料。回應將包含 JSON 物件，代表訂單的所有可用資訊，包括帳單和運送地址、運送方式、訂單總額和狀態。