购物车更新
购物车商品更新时触发。
需要 order 访问权限。最低支持版本:202201。
请求头
触发本次推送的事件,例如 orders/create
orders/create请求体的 HMAC-SHA256 签名(base64 编码),使用应用的 Client Secret 生成,用于验证请求来自 Shoplazza
产生该事件的店铺域名
example.myshoplaza.com序列化 payload 使用的 API 版本
2025-06本次推送的去重 ID,同一事件重发时保持不变,用于幂等去重
请求体
- 数据结构
- 示例
cart object
created_atstring购物车创建时间
currency_codestring货币代码
discount_applications object[]
购物车优惠明细
Array [apply_methodstring自动活动行的应用方式
codestring优惠码 code(仅优惠码活动有)
discount_amountnumber优惠金额
discount_idstring优惠 ID
discount_messagestring优惠提示文案
discount_textstring优惠文案(可能是 title 或 label)
discount_typestring优惠码折扣类型:折扣 / 固定减价(仅优惠码有)
entitled_product_listundefined[]优惠作用商品列表
extentsobject扩展字段(string→string 键值对,键不固定)
extents.application_timestring应用时间
extents.business_custom_datastring业务自定义数据
extents.discount_apply_typestring折扣应用类型
extents.discount_codestring折扣码
extents.discount_rule_infostring折扣规则信息
extents.old_discount_idstring旧优惠 ID
extents.use_with_otherstring是否可与其他折扣叠加
iconstring图标
is_free_giftboolean活动优惠商品列表是否为免费赠品
messagestring输入框提示文案
propertiesstring优惠码附加字段
statusstring优惠码应用状态:success(应用成功)、undetermined(待定)、fail(应用失败)
subtypestring营销活动子类型:discount_rebate(满减)、discount_code(优惠码)、discount_coupon(优惠券)、discount_flashsale(限时促销)、automatic(自动优惠)、buy_x_get_y(买 X 送 Y)
target_selectionstring优惠目标选择方式
target_typestring优惠作用目标:shipping_line(运费)、line_item(商品行)、payment_line(支付方式)
titlestring优惠名称
typestring营销活动类型:discount_rebate(满减)、discount_code(优惠码)、discount_coupon(优惠券)、discount_flashsale(限时促销)、automatic(自动优惠)
value_typestring优惠值类型
]extra object
购物车变更附加信息
client_idstring客户端 ID
item_countinteger商品数量
line_items object[]
购物车商品列表
Array [add_quantitystring添加数量
availableboolean商品是否可售
available_quantityinteger可用数量
can_buyboolean是否可购买
compare_at_pricestring商品原价(划线价)-单价
cost_pricestring成本价
customboolean是否为自定义商品项
discount_applications object[]
该商品项的优惠明细
Array [allocation_methodstring分配方式
codestring优惠码 code
discount_amountstring折扣金额
discount_idstring优惠 ID
discount_quantityinteger优惠数量
discount_textstring优惠文案(可能是 title 或 label)
discount_typestring优惠码折扣类型
extentsobject扩展字段(键值对,键不固定)
extents.business_custom_datastring业务自定义数据
extents.old_discount_idstring旧优惠 ID
extents.raw_input_line_item_pricestring原始输入的行项目价格
groupsundefined[]折扣应用组
iconstring图标
is_free_giftboolean该商品列表是否为免费赠品
is_need_splitboolean是否允许拆分
subtypestring营销活动子类型(取值见 discount_applications 表)
target_selectionstring优惠目标选择方式
target_typestring优惠作用目标(取值见 discount_applications 表)
titlestring优惠名称
total_discount_amountstring总折扣金额
typestring营销活动类型(取值见 discount_applications 表)
valuestring优惠值
value_typestring优惠值类型
]discount_totalstring折扣总额
final_line_pricestring最终行价格
final_pricestring最终单价
fixed_discount_totalstring固定折扣总额
idstring购物车商品项 ID
imageobject商品图片链接
image.heightinteger图片高度
image.pathstring图片路径
image.srcstring图片 URL
image.widthinteger图片宽度
inventory_policystring库存策略(continue 缺货继续销售 / deny 缺货停止销售 / auto_unpublished 缺货自动下架)
inventory_quantityinteger库存数量
inventory_trackingboolean是否启用库存追踪
item_idstring商品项 ID
line_pricestring行价格
mixed_wholesaleboolean是否支持混批
options object[]
商品款式属性列表
Array [namestring款式选项名称
valuestring选项值
]origin_pricestring原价
original_line_pricenumber原始行价格
parts_pricestring部件价格
pricestring商品售价-单价
product_handlestring商品 Handle
product_idstring商品 ID
product_tagsundefined[]商品标签
product_titlestring商品标题
product_typestring商品类型
product_urlstring商品链接
propertiesstring商品款式属性(键值对)
publishedboolean商品是否已发布(上架)
published_atstring商品发布时间
quantitystring购买数量
requires_shippingboolean是否需要物流
retail_pricestring零售价
saved_priceinteger节省金额
skustring子款式 SKU
taxableboolean是否需要纳税
trunk_pricestring主干价格
variant_idstring子款式 ID
variant_titlestring子款式标题
vendorstring供应商
weightstring商品重量
weight_unitstring重量单位
wholesale_price object[]
批发价(列表)
Array [min_quantityinteger最小数量
pricestring价格
]]total_discountstring购物车优惠总价
total_pricestring购物车商品总金额
updated_atstring购物车更新时间
user_idstring用户 ID
user_signstring用户签名(游客标识)
{
"cart": {
"created_at": "string",
"currency_code": "string",
"discount_applications": [
{
"apply_method": "string",
"code": "string",
"discount_amount": 0,
"discount_id": "string",
"discount_message": "string",
"discount_text": "string",
"discount_type": "string",
"entitled_product_list": [
null
],
"extents": {},
"extents.application_time": "string",
"extents.business_custom_data": "string",
"extents.discount_apply_type": "string",
"extents.discount_code": "string",
"extents.discount_rule_info": "string",
"extents.old_discount_id": "string",
"extents.use_with_other": "string",
"icon": "string",
"is_free_gift": true,
"message": "string",
"properties": "string",
"status": "string",
"subtype": "string",
"target_selection": "string",
"target_type": "string",
"title": "string",
"type": "string",
"value_type": "string"
}
],
"extra": {
"client_id": "string"
},
"item_count": 0,
"line_items": [
{
"add_quantity": "string",
"available": true,
"available_quantity": 0,
"can_buy": true,
"compare_at_price": "string",
"cost_price": "string",
"custom": true,
"discount_applications": [
{
"allocation_method": "string",
"code": "string",
"discount_amount": "string",
"discount_id": "string",
"discount_quantity": 0,
"discount_text": "string",
"discount_type": "string",
"extents": {},
"extents.business_custom_data": "string",
"extents.old_discount_id": "string",
"extents.raw_input_line_item_price": "string",
"groups": [
null
],
"icon": "string",
"is_free_gift": true,
"is_need_split": true,
"subtype": "string",
"target_selection": "string",
"target_type": "string",
"title": "string",
"total_discount_amount": "string",
"type": "string",
"value": "string",
"value_type": "string"
}
],
"discount_total": "string",
"final_line_price": "string",
"final_price": "string",
"fixed_discount_total": "string",
"id": "string",
"image": {},
"image.height": 0,
"image.path": "string",
"image.src": "string",
"image.width": 0,
"inventory_policy": "string",
"inventory_quantity": 0,
"inventory_tracking": true,
"item_id": "string",
"line_price": "string",
"mixed_wholesale": true,
"options": [
{
"name": "string",
"value": "string"
}
],
"origin_price": "string",
"original_line_price": 0,
"parts_price": "string",
"price": "string",
"product_handle": "string",
"product_id": "string",
"product_tags": [
null
],
"product_title": "string",
"product_type": "string",
"product_url": "string",
"properties": "string",
"published": true,
"published_at": "string",
"quantity": "string",
"requires_shipping": true,
"retail_price": "string",
"saved_price": 0,
"sku": "string",
"taxable": true,
"trunk_price": "string",
"variant_id": "string",
"variant_title": "string",
"vendor": "string",
"weight": "string",
"weight_unit": "string",
"wholesale_price": [
{
"min_quantity": 0,
"price": "string"
}
]
}
],
"total_discount": "string",
"total_price": "string",
"updated_at": "string",
"user_id": "string",
"user_sign": "string"
}
}