购物车更新

事件分组	事件标识
carts	carts/update

当购物车有更新时触发。

请求头

X-Shopline-Topic string required

事件的唯一标识。

例子: orders/edited
X-Shopline-Hmac-Sha256 string required

该请求的签名。收到请求后，你需要对该签名进行验签以验证数据的真实性和完整性。

例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
X-Shopline-Shop-Domain string required

店铺的域名。

例子: example.myshopline.com
X-Shopline-Shop-Id string required

店铺 ID。

例子: 1610418123456
X-Shopline-Merchant-Id string required

商家 ID。

例子: 2000001234
X-Shopline-API-Version string required

API 版本号。

例子: v20250601
X-Shopline-Webhook-Id string required

该 Webhook 事件的 ID。

例子: b54557e48a5fbf7d70bcd043

请求体

created_at string

购物车的创建时间。格式：ISO 8601。
例子: 2024-08-31T02:20:26+08:00
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
discount_codesobject[]

折扣码信息列表。
amount double

折扣码优惠金额，数值保留到小数点后两位。如果商家设置了多市场币种则以对应市场币种显示，否则以店铺币种显示。
code string

折扣码。
type integer

整单维度的活动类型，有效枚举值包括：

-1：无优惠

1：减金额

2：打折

3：免运费

4：加价品

5：任意 N 件优惠价

6：A+B 组合优惠价

7：赠品

8：固定售价

9：最低价商品免费

11：第 X 件打折

12：买 X 送 Y

13：自定义

14：N 件 M 元
id string

购物车 ID。
line_itemsobject[]

购物车商品信息列表。
giftCard boolean

是否为礼品卡商品。

true：是礼品卡商品

false：不是礼品卡商品
grams string

重量，单位：g。
id string

购物车商品行维度的唯一标识。
original_line_price double

商品行价格，为折扣前单个商品售价乘以商品数量，数值保留到小数点后两位。如果商家设置了多市场币种则以对应市场币种显示，否则以店铺币种显示。
original_price double

折扣前的单个商品售价，数值保留到小数点后两位。如果商家设置了多市场币种则以对应市场币种显示，否则以店铺币种显示。
price double

折扣后的单个商品售价，数值保留到小数点后两位。如果商家设置了多市场币种则以对应市场币种显示，否则以店铺币种显示。
product_id string

款式对应商品的唯一标识 ID。
propertiesobject[]

商品定制信息列表。
name string

自定义属性名称。
show boolean

定制信息是否可见。

true：信息可见

false：信息不可见

urls array

URL 列表。
例子: [""]
value string

自定义属性值。
quantity integer

商品行维度的商品数量。
sku string

商品 SKU 序列号。
taxable boolean

该商品是否需要收税。

true：需要收税

false：不需要收税
title string

商品标题。
variant_id string

分配给库存中某一特定商品的唯一编码。
token string

购物车 token。
total_amount double

购物车总金额，数值保留到小数点后两位。如果商家设置了多市场币种则以对应市场币种显示，否则以店铺币种显示。
updated_at string

购物车更新时间。格式：ISO 8601。
例子: 2024-08-31T02:20:26+08:00

状态码

收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。

HTTP/1.1 200 OK

关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 Webhook 概述。

这篇文章对你有帮助吗？

SHOPLINE

条款协议