Sign in
Book a demo

建立結帳

瞭解建立結帳所涉及的鍵值對。

此 API 端點用於將客戶購物車中的購物車資訊及商品傳送至 Zonos API。

您將收到一份 JSON 回應，其中包含 tempCartUUID，這是 Zonos 系統中的唯一購物車識別碼。此識別碼將用於將客戶重新導向至 Zonos 結帳，以完成訂單。

屬性 

請求本文中的 JSON 鍵值對

POST https://api.iglobalstores.com/v1/createTempCart

欄位↕備註↕
boxCount範例值：22x15x15(1),8x8x4(2),32x22x14(1)
格式：逗號分隔的箱子尺寸和數量清單。在上述範例中，共有 4 個箱子。清單中的第一個箱子長 22 英寸、寬 15 英寸、高 15 英寸。該尺寸只有一個箱子。有兩個尺寸為 8x8x4 英寸的箱子。如果對您來說比較便利，可以多次傳遞相同的箱子尺寸，例如："22x15x15(1),22x15x15(1)"，表示 2 個尺寸為 22x15x15 英寸的箱子。此欄位說明將用於運送訂單的箱子。雖然商家在訂單時間可能不知道此資訊，但如果知道，可以以 string 格式傳遞。
contShoppingURL此欄位用於傳遞 URL，以覆蓋 Zonos 結帳內「繼續購物」按鈕的 HREF。string
domesticShippingCharge此欄位用於將本地運費傳遞至 Zonos 結帳，該金額將新增至運費。可以將其設定為新增運費合計或分別列為一項。positive floating point, two decimal places
externalConfirmationPageURL此欄位用於傳遞您的訂單確認/感謝頁面的 URL。客戶在 Zonos 結帳內完成付款後，會被重新導向至此 URL 以確認訂單。此 URL 經常用於觸發對 Zonos「orderDetail」API 服務端點的呼叫，以檢索訂單詳細資料並將訂單匯入系統。string
footerHTML此欄位用於傳遞 URL 編碼的 HTML 字串。此 HTML 字串會被解碼並放置在結帳頁面的結束 body 標籤之前。通常用於傳遞重新行銷、分析等程式碼。URL encoded string
items

REQUIRED

此欄位是項目對應清單。JSON string
items[index].countryOfOrigin此欄位用於傳遞項目原產地。參數必須是國家/地區的兩個字母的 ISO 代碼。string
items[index].description

REQUIRED

此欄位用於傳遞購物車行項目的完整項目說明，包括任何項目選項、顏色等。string
items[index].height此欄位用於傳遞項目高度，強烈建議用於準確的運費報價。高度單位為

REQUIRED

英寸。string - positive floating point, two decimal places / integer (inches)
items[index].imageURL

REQUIRED

此欄位用於傳遞項目產品影像的 URL。URL 必須是 HTTPS 才能在 Zonos 結帳內顯示。string / HTTPS URL
items[index]itemBrand此欄位用於傳遞項目品牌string
items[index]itemCategory此欄位用於傳遞項目類別，如果項目有一個以上的類別，可以以縱線分隔傳遞。
範例值："shoes" 或 "shoes|sport-shoes|discount-shoes"string
items[index]itemCustomization此欄位用於傳遞項目的其他詳細資料，這些詳細資料不會在 Zonos 結帳內顯示；但是，可以透過「orderDetail」API 服務端點檢索。
items[index]itemHSCode此欄位用於傳遞項目 HS 代碼，可以有句號也可以沒有句號。
範例值："3926901000" 或 "3926.90.1000"string
items[index].itemURL此欄位用於傳遞項目產品頁面的 URL。string / URL
items[index].length此欄位用於傳遞項目長度，強烈建議用於準確的運費報價。長度單位為

REQUIRED

英寸。string - positive floating point, two decimal places / integer (inches)
items[index].nonShippable此欄位用於指示項目是否應包含在運費、關稅和稅金計算中。數位下載、折扣代碼、處理費等應以「true」值傳遞。boolean: true or false
items[index].productId此欄位用於傳遞行項目數量。string
items[index].quantity

REQUIRED

此欄位用於傳遞行項目數量。string
items[index].sku此欄位用於傳遞項目 SKU/UPC 等。string
items[index].unitPrice

REQUIRED

此欄位用於傳遞行項目單價。positive floating point, two decimal places / integer
items[index].weight此欄位用於傳遞項目重量，強烈建議用於準確的運費報價。重量單位預設為「LBS」，除非在 items[index].itemWeightUnits 中傳遞其他重量單位string - positive floating point, two decimal places / integer
items[index].weightUnits此欄位用於覆蓋預設項目重量單位。項目重量單位預設為「LBS」，除非在此欄位中傳遞其他重量單位。string - "LB", "OZ", "KG", or "G"
items[index].width此欄位用於傳遞項目寬度，強烈建議用於準確的運費報價。寬度單位為

REQUIRED

英寸。string - positive floating point, two decimal places / integer (inches)
misc1 - misc6此欄位用於傳遞與訂單相關聯的其他資料，通過 Zonos API 進行傳遞，以便與從 Zonos「orderDetail」API 服務端點傳回的訂單資料一起檢索。string
referenceId此欄位用於為您系統中的購物車/工作階段/等傳遞唯一的參考識別值。這可以用來透過 Zonos「orderDetail」API 服務端點查詢 Zonos 訂單 ID。string
storeId

REQUIRED

Zonos 提供的商店 ID。integer

其他字串資料類型

  • items[index].itemDescriptionLong
  • items[index].itemDescriptionDetailed
  • items[index].itemFabricContent
  • items[index].itemColor
  • items[index].itemLtlClass
  • items[index].status
  • items[index].itemMaterial

折扣、優惠券和促銷代碼 

若要透過伺服器 post 將折扣、優惠券和促銷代碼傳送至 Zonos，必須以單獨項目的形式傳遞，並為 "unitPrice" 和 "nonShippable":true 參數使用負值。

1{
2 "description": "Discount (10OFF) - 10% OFF",
3 "unitPrice": -15.5,
4 "quantity": 1,
5 "nonShippable": true
6}

HTTPS 回應

成功 HTTP 回應

訊息格式：JSON

1{
2 "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"
3}

回應 JSON 定義

欄位↕備註↕
tempCartUUID此參數將包含指派給客戶國際購物車的 GUID，並在 Zonos 系統中建立。此欄位將作為 URL 查詢 string 參數傳遞，同時將使用者的瀏覽器重新導向至 Zonos 結帳。

錯誤 HTTP 回應

錯誤代碼↕意義↕
400要求本文中出現未預期的字元。
406不可接受。HTTP 標頭「Accept」無效。
415不支援的媒體類型。HTTP 標頭「Content-Type」無效。
422無法處理的實體。
500「storeId」不正確或 JSON 本文無法剖析。
1
2 
3
4 
5
6 
7Error 422 Unprocessable Entity
8 
9
10 
11
12 
13

HTTP ERROR 422

14 
15

16 Problem accessing /v2/createTempCart. Reason:
17 
Unprocessable Entity
18 
19

20 
21

The request entity had the following errors:

22 
23
24 
25
  • items may not be empty (was null)
    • 26 
    27
  • items may not be null (was null)
    • 28 
    29
    30 
    31
    32 
    33

    重新導向至 Zonos 結帳 

    收到包含 tempCartUUID 的成功回應後，您的伺服器會從客戶的瀏覽器傳送重新導向至 Zonos 結帳，其中包含下述涵蓋的適當 URL 查詢字串參數。

    範例重新導向 URL：https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

    備註：[yourassignedsubdomain] - 請聯絡您的 Zonos 實施團隊成員以接收您的 Zonos.com 子網域。

    URL 要求參數

    欄位↕備註↕
    tempCartUUID

    REQUIRED

    		此值是通過呼叫 Zonos createTempCart API 服務端點取得的。string / GUID
    country目的地國家/地區的兩個字母的 ISO 代碼。我們強烈建議傳遞此參數以改進使用者體驗。country 參數將在 Zonos 結帳內預先選擇目的地國家/地區。當在網站上使用 Zonos Hello JS (JavaScript) 時，您可以透過呼叫 JavaScript 方法取得此值：zonos.country()。string (Length: 2)

    其他字串資料類型

    • customerName
    • customerCompany
    • customerEmail
    • customerPhone
    • customerAltPhone
    • customerAddress1
    • customerAddress2
    • customerCity
    • customerState
    • customerZip

    Copyright © 2026 Zonos

    •

    Privacy PolicyTerms of Service