积分变更推送

推送参数

其他默认推送参数文档，参考消息推送-使用说明。
当用户积分发生增加、扣减、退款、过期、清零等变化时，平台会向商家配置的消息推送地址发送事件通知。

参数	必选	类型	描述
msg_type	是	string	消息类型：event-事件
event	是	string	事件类型：pointsChange-积分变更推送
data	是	object	消息内容

data 参数结构

参数	必选	类型	描述
uid	是	int	商户 ID
wechat_user_space_id	是	int	用户 ID
type	是	int	积分变动类型
task_type	是	int	任务子类型，非任务场景为 0
points_value	是	int	本次变动积分值，正数表示增加，负数表示扣减
current_points	是	int	变动后的积分余额
remarks	否	string	备注信息，无则为空串
add_time	是	int	积分变更时间，Unix 时间戳，单位秒
third_wechat_info	否	array	客户公众号下用户信息
third_user_info	否	object	客户系统下用户信息

third_wechat_info 参数结构

参数	必选	类型	描述
authorizer_appid	是	string	客户公众号appid
openid	是	string	客户openid
unionid	否	string	客户unionid

third_user_info 参数结构

参数	必选	类型	描述
third_uuid	是	string	客户系统用户ID
third_attach	是	string	客户系统用户附属信息。json字符串

type 枚举说明

取值	描述
1	任务增加
2	购买消费
3	扣减
4	增加
5	退款
6	过期
7	抵现
8	抵现退款
13	观看奖励

task_type 枚举说明

取值	描述
0	手动或非任务场景
1	邀请
2	订阅
3	购买
4	评论
5	打赏
6	礼物
7	观看时长
8	签到
9	观看奖励

推送示例

示例

{
  "key": "示例key",
  "timestamp": 1741595400000,
  "sign": "md5sign",
  "msg_id": "2177E51538CC0078F0AXXX",
  "msg_type": "event",
  "event": "pointsChange",
  "push_msg_url": "https://example.com/push/pointsChange",
  "uid": 123456,
  "data": {
    "uid": 123456,
    "wechat_user_space_id": 2040188,
    "type": 1,
    "task_type": 4,
    "points_value": 10,
    "current_points": 210,
    "remarks": "评论奖励",
    "add_time": 1741449600,
    "third_wechat_info": [
      {
        "authorizer_appid": "wx1234567890abcdef",
        "openid": "oKFTf0TEfzfg1234567890",
        "unionid": "o8-ysv1234567890abcdef"
      }
    ],
    "third_user_info": {
      "third_uuid": "user-123456",
      "third_attach": "{\"site\":\"KD13\"}"
    }
  }
}