等级会员更新

事件分组	事件标识
app_memberSystem_membershipLevels	app_memberSystem_membershipLevels/challenged

当客户当前所在的等级类型变更时，告知监听方进行对应客户的等级信息更新处理。

请求头

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

请求体

buyer_id string

客户id
例子: 2404721679
level_code string

该客户变更后所在的等级会员编码
例子: MLC6568224957444662294
level_code_before string

该客户变更前所在的等级会员编码。如果为非会员，返回null
例子: MLC6568224957444662294
level_expiry_time long

该客户变更后所在的等级会员会员到期时间。
例子: 1769270399000
level_name string

该客户变更后所在的等级会员名称。最多25个字符
例子: LEVEL_2
level_name_before string

该客户变更前所在的等级会员名称。最多25个字符。如果为非会员，返回null
例子: LEVEL_1
level_order integer

等级权重
例子: 1
level_order_before integer

该客户变更前所在的等级会员的顺序。仅当membership_type = level时有意义，此时level_order越大，等级越高级
例子: 2
level_updated_time long

该客户变更后所在的等级会员会员开始生效时间
例子: 1721750465000
remark string

备注
例子: remark
store_id string

店铺id
例子: 1718263946864
updated_source string

变更来源

HISTORY_DATA: 历史数据

MANUALLY_UPDATE: 商家手动调整

PURCHASE_UPGRADE: 客户消费后升级

ORDER_RETURN: 订单退款

LEVEL_EXPIRED: 等级到期

CUSTOMER_REGISTRATION: 客户注册

RULE_ADJUSTED: 规则调整

ORDER_EDITED: 订单编辑
例子: MANUALLY_UPDATE
updated_type string

变更类型

INITIATION: 成为您店铺的客户

DOWNGRADE: 会员降级

UPGRADE: 会员升级

LOCKIN: 会员保级

UPDATE: 等级更新
例子: UPDATE

状态码

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

HTTP/1.1 200 OK

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

这篇文章对你有帮助吗？

SHOPLINE

条款协议