重庆互联网，19年企业互联网解决经验，专业网站开发、移动端开发、微信端开发、小程序开发！
作者：重庆互联网小徐 发布时间：2025-10-09 浏览：19670 赞（1850） 收藏 评论（0）
同样的发货请求（outTradeNo），可能因为网络原因，会请求多次。我们在有限时间内尽量保证触达一次，直到明确返回发货成功为止
针对重复的请求，开发者需要自行保证只发货一次，并且回包需要和第一次一样返回发货成功
通知周期：15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h
必须要开启道具发货推送才能收到回调请求
| 字段 | 类型 | 说明 |
|---|---|---|
| ToUserName | String | 小游戏原始 ID |
| FromUserName | String | 该事件消息的 openid，道具发货场景固定为微信官方的 openid |
| CreateTime | Number | 消息发送时间 |
| MsgType | String | 消息类型，道具发货场景固定为：event |
| Event | String | 事件类型 道具直购（商城）场景固定为： minigame_h5_goods_deliver_notify 道具直购（游戏内）场景固定为： minigame_game_pay_goods_deliver_notify |
| MiniGame | Object | 道具直购发货参数，见下文 |
MiniGame
| 字段 | 类型 | 说明 |
|---|---|---|
| Payload | String | 携带的具体内容，格式为 json，具体内容如下表格 Payload（因为这里需要对消息内容统一签名，所以统一把消息内容设计成 json 格式） |
| PayEventSig | String | 见支付类订阅事件签名算法说明 |
Payload(JSON)
| 字段 | 类型 | 说明 |
|---|---|---|
| OpenId | String | 接收道具的玩家 openid |
| Env | Number | 环境配置 0：现网环境（也叫正式环境） 1：沙箱环境 |
| OutTradeNo | String | 订单号 |
| GoodsInfo | Object | 发货道具 |
| WeChatPayInfo | Object | 微信支付信息（仅微信支付渠道） |
GoodsInfo
| 字段 | 类型 | 说明 |
|---|---|---|
| ProductId | String | 游戏道具 id 标识 |
| Quantity | Number | 购买道具数量 |
| ZoneId | String | 分区 ID |
| OrigPrice | Number | 物品原始价格 （单位：分） |
| ActualPrice | Number | 物品实际支付价格（单位：分） |
| Attach | String | 透传数据 |
| OrderSource | Number | 1 游戏内 2 商城下单 3 商城测试下单 |
WeChatPayInfo
| 字段 | 类型 | 说明 |
|---|---|---|
| MchOrderNo | String | 微信支付商户单号 |
| TransactionId | String | 交易单号(微信支付单号) |
返回参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ErrCode | Number | 是 | 发送状态。0：成功，其他：失败 |
| ErrMsg | String | 否 | 错误原因，用于调试。在 errcode 非 0 的情况下可以返回 |
JSON 格式示例
{
"ToUserName": "gh_31b2a1c7e78a",
"FromUserName": "oUrsf0TSXNtiZjP7JL9UUFiGJzmQ",
"CreateTime": 1583202606,
"MsgType": "event",
"Event": "minigame_deliver_h5_pay_products",
"MiniGame": {
"Payload": "{\"OpenId\":\"to_user_openid\",\"Env\":0,\"GoodsInfo\":{\"ProductId\":\"id_100001\",\"ZoneId\":\"1\",\"OrigPrice\":10,\"ActualPrice\":10,\"Quantity\":1},\"WeChatPayInfo\":{\"MchOrderNo\":\"xxxxx\",\"TransactionId\":\"xxxx\"}}",
"PayEventSig": "f749f67b751fa80f27ddc0b7c8d2821aeda162ea22b323cd64a2c8056c2736f0"
}
}成功返回
{ "ErrCode": 0, "ErrMsg": "Success" }失败返回
{ "ErrCode": 99999, "ErrMsg": "internal error" }重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案，专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发，帮助企业实现从传统行业到互联网的完美转型。截止目前，重庆互联网合作的企业遍布全国各地，21年的开发经验和完善的售后服务体系获得合作客户的高度认可！
关注重庆互联网官方公众号，即可获取粉丝专享福利！
欢迎广大用户为此页面进行评价，评价成功将获得积分奖励！
