会员积分更新

事件分组	事件标识
app_memberSystem_points	app_memberSystem_points/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
points_balance long

剩余可用积分数
例子: 20
points_expiry_time long

本次变更积分的失效时间，毫秒级时间戳，仅当update_type = increase时有效。当字段为空时，表示永久有效
例子: 1721829526566
store_id string

店铺id
例子: 1718263946864
update_type string

积分更新类型。

DECREASE: 积分减少

INCREASE: 积分增加
例子: DECREASE
updated_at long

更新时间
例子: 1721829526566
updated_scene string

积分变更场景类型。

SUCCESSFUL_REGISTRATION: 客户注册后获得积分。

LOGIN_SUCCESS: 客户成功登录获得积分。

CUSTOMERS_BIRTHDAY: 客户生日发放积分。

SUCCESSFUL_ORDERS: 客户成功下单获得积分。

EMAIL_SUBSCRIPTION: 客户邮箱订阅发放积分。

ENTER_PHONE: 客户填写手机号发放积分。

ENTER_BIRTHDAY: 客户填写生日发放积分。

SHARE_FB: 客户分享到FACEBOOK发放积分。

FOLLOW_FB: 客户关注FACEBOOK发放积分。

FOLLOW_INS: 客户关注INSTAGRAM发放积分。

DAILY_ATTENDANCE: 客户每日签到获得积分。

PRODUCT_REVIEWS: 客户评论商品获得积分。

TOP_REVIEWS: 客户商品评论被选为优质评论后奖励积分。

LEVEL_MEM_BENEFITS: 等级会员权益发放积分。

PAID_MEM_BENEFITS: 付费会员权益发放积分。

SUCCESSFUL_REFERRAL: 客户成功完成邀请获得积分。

MANUALLY_INCREASE: 商家为客户手动添加积分。

CUSTOMER_IMPORT_INCREASE: 商家手动导入会员时为会员发放积分。

CASHBACK: 客户使用积分抵扣现金而扣减积分。

REDEEM_COUPON_CODE: 客户使用积分兑换折扣券而扣减积分。

REDEEM_COUPON: 客户使用积分兑换代金券而扣减积分。

REDEEM_FREE_SHIPPING: 客户使用积分兑换免运费券而扣减积分。

REDEEM_PRODUCTS: 客户使用积分兑换商品而扣减积分。

MANUALLY_DECREASE: 商家为客户手动扣减积分。

CUSTOMER_IMPORT_DECREASE: 商家手动导入会员时为会员扣减积分。

POS_DECREASE: POS扣减积分。
例子: SUCCESSFUL_REGISTRATION
updated_value long

本次更新的积分数
例子: 20

状态码

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

HTTP/1.1 200 OK

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

这篇文章对你有帮助吗？

SHOPLINE

条款协议