DOCS
Checkout•
首页API 参考 Checkout REST API 创建结账

创建结账

探索创建结账所涉及的关键/值对。

此API端点用于向Zonos API发送来自客户购物车的购物车信息和项目。

您将收到一个JSON响应，其中包含一个 tempCartUUID，这是Zonos系统中的唯一购物车标识符。这将用于将客户重定向到Zonos Checkout以完成订单。

属性 

请求正文中的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 Checkout内部"继续购物"按钮的HREF。 string
domesticShippingCharge此字段用于将国内运费传递给Zonos Checkout，该金额将添加到运费中。可以配置为添加运费总额或作为单独的行项目列出。 positive floating point, two decimal places
externalConfirmationPageURL此字段用于传递您的订单确认/感谢页面的URL。客户在Zonos Checkout内完成付款后，将被重定向到此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 Checkout内显示。 string / HTTPS URL
items[index]itemBrand此字段用于传递项目品牌 string
items[index]itemCategory此字段用于传递项目类别，如果项目有多个类别，可以用管道符分隔传递。
示例值: "shoes"或"shoes|sport-shoes|discount-shoes" string
items[index]itemCustomization此字段用于传递未在Zonos Checkout中显示的有关项目的其他详情；但是，可以通过"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 Checkout。

错误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 Checkout 

    收到包含 tempCartUUID 的成功响应后，您的服务器将从客户的浏览器发送重定向到Zonos Checkout，并使用下面涵盖的适当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 Checkout内预选目标国家。使用Zonos Hello JS（JavaScript）在网站上时，您可以通过调用JavaScript方法获得此值: zonos.country()。 string （长度: 2）

    其他字符串数据类型

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

    这个页面有帮助吗？

    获取支持·法律文件·© 2026 Zonos
    在此页面：
  • 重定向到Zonos Checkout