# 用户积分兑换通知
# 接口说明
视频号小店会通过该接口将用户积分兑换的消息通知给商户。
# 注意事项
- 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，商户将无法收视频号小店发送的通知；
# 请求参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| ToUserName | string | 小店UserName |
| FromUserName | string | 用户OpenID |
| CreateTime | number | 事件时间,Unix时间戳，即格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数 |
| MsgType | string | 消息类型,固定为 event |
| Event | string | 事件类型,本接口固定为 channels_ec_vip_score_exchange |
| exchange_info | object ExchangeInfo | 事件主体，结构体详情请参考ExchangeInfo |
# 请求参数示例（解密后的明文JSON）
{
"ToUserName": "gh_*",
"FromUserName": "OPENID",
"CreateTime": 1662480000,
"MsgType": "event",
"Event": "channels_ec_vip_score_exchange",
"exchange_info": {
"pay_score": 100,
"score_item_type": 1,
"coupon_info": {
"related_coupon_id": 1234
},
"product_info": {
"related_product_id": 1234
}
}
}
# 返回参数说明
只需直接返回字符串
success
# 返回参数示例
success
# 结构体
# ExchangeInfo
事件主体
| 参数 | 类型 | 描述 |
|---|---|---|
| pay_score | number | 兑换积分 |
| score_item_type | number | 兑换类型，枚举值详情请参考score_item_type |
| coupon_info.related_coupon_id | number | 兑换的优惠券ID |
| product_info.related_product_id | number | 兑换的商品ID |
# 枚举值
# score_item_type
兑换类型
| 枚举值 | 描述 |
|---|---|
| 1 | 优惠券 |
| 2 | 商品 |