会员积分更新

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

当会员积分变更时触发。

请求头

Content-Type string required

字段值固定为 application/json; charset=utf-8。
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

本次变更积分的失效时间。仅当 updateType 为 INCREASE 时有值。
例子: 1721829526566
store_id string

店铺 ID。
例子: 1718263946864
update_type string
积分变更类型。有效枚举值包括：
- INCREASE：积分增加。
- DECREASE：积分减少。
例子: 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：客户商品评论被选为优质评论后奖励积分。
- CUSTOMIZED_RULE：自定义积分规则。
- 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 扣减积分。
- POINTS_EXPIRED：积分有效期到期，积分失效。
- ORDER_RETURN：订单退款退回积分。
- REFUND_POINT_BY_EXCHANGE：撤销兑换退还积分。
例子: SUCCESSFUL_REGISTRATION
updated_value long

本次变更的积分数。
例子: 20

状态码

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

HTTP/1.1 200 OK

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

这篇文章对你有帮助吗？

SHOPLINE

条款协议