重庆互联网，19年企业互联网解决经验，专业网站开发、移动端开发、微信端开发、小程序开发！
作者：重庆互联网小徐 发布时间：2025-10-16 浏览：19542 赞（1850） 收藏 评论（0）
所有事件基础结构如下
| 字段 | 类型 | 说明 |
|---|---|---|
| CreateTime | Number | 消息发送时间 |
| MsgType | String | 消息类型，道具发货场景固定为：event |
| CreateTime | Number | 消息发送时间 |
| Event | String | 事件类型 与商城有关的事件类型 （1）拉取用户最近玩过的游戏角色数据 minigame_query_recent_role_list （2）代币类道具商城发货通知 minigame_h5_coin_deliver_notify （3）道具直购类商城发货通知 minigame_h5_goods_deliver_notify |
| MiniGame | Object | 具体消息内容，见MiniGame |
MiniGame
| 字段 | 类型 | 说明 |
|---|---|---|
| Payload | String | 携带的具体内容，格式为 json，具体内容如下表格 Payload （因为这里需要对消息内容统一签名，所以统一把消息内容设计成 json 格式） |
| PayEventSig | String | 见支付请求签名算法说明（PayEventSig） |
在商城场景下，平台侧会拉取用户游戏角色信息，用于用户在商城购买道具/发放奖励时的分区选择，示意场景及交互如下：
注意：
（1）拉取的分区名/角色名均会经过安全审核，如果审核出现问题，违规词会用特殊处理
（2）事件为实时通知
请求参数
Payload
| 字段 | 类型 | 说明 |
|---|---|---|
| OpenId | String | 用户 openid |
| NeedRoleNum | Number | 需要的最近玩过的角色数量，不会超过 20 个 |
| ProductId | Number | 道具 id（仅道具购买页传入） |
| GoodsPrice | Number | 道具价格（仅道具购买页传入） |
返回参数
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| ErrCode | Number | 是 | 发送状态。0：成功，其他：失败 |
| ErrMsg | String | 否 | 错误原因，用于调试。在 errcode 非 0 的情况下可以返回 |
| RecentPlayedRoleList | Array.<UserRoleInfo> | 最近玩过的角色列表 |
UserRoleInfo
| 字段 | 类型 | 说明 |
|---|---|---|
| RoleId | String | 游戏角色 id 标识 |
| RoleName | String | 游戏角色名 |
| ZoneInfoList | Array.<ZoneInfo> | 用户角色对应的分区，可能存在大区/中区/小区等，按由大到小的顺序 |
| PayParam | PayParam | 米大师下单需要的支付参数 （请求参数若带道具 id，此参数必填，用来下单支付） |
ZoneInfo
| 字段 | 类型 | 说明 |
|---|---|---|
| ZoneId | String | 自定义分区 id |
| ZoneName | String | 自定义分区名 |
PayParam
| 字段 | 类型 | 说明 |
|---|---|---|
| MidasZoneId | String | 米大师分区 id |
| Attach | String | 附加数据，在查询 API 和通知中原样返回，可作为自定义参数使用 |
注意：这里游戏角色的分区若存在层级概念，请按照实际的层级填写，例如：用户在电信一区-测试服-1 号线，请按由大到小的顺序 分为三层（不同游戏层次数量可以不一样）返回
见 虚拟支付 道具直购|微信开放文档道具发货消息协议|
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案，专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发，帮助企业实现从传统行业到互联网的完美转型。截止目前，重庆互联网合作的企业遍布全国各地，21年的开发经验和完善的售后服务体系获得合作客户的高度认可！
关注重庆互联网官方公众号，即可获取粉丝专享福利！
欢迎广大用户为此页面进行评价，评价成功将获得积分奖励！
