# 微信小游戏商城与拼团

# 一、微信小游戏商城介绍

# 功能概述

为帮助开发者进行道具运营与活动拉收，微信小游戏提供小游戏商城能力。（仅支持虚拟支付类游戏接入）
使用小游戏商城，可支持实现：游戏外支付、更灵活支付、多笔合并支付、拼团支付等功能。
运用好这些能力能够帮助游戏方提升付费转化和 ARPPU 值。

# 功能入口

路径：微信公众平台(mp.weixin.qq.com)-虚拟支付-基本配置-商城管理
开发者可以根据需求将已发布的道具在“商城管理”模块上架至你的小游戏商城

# 功能介绍

# 二、拼团能力介绍

# 功能概述

为帮助开发者进行道具活动运营，微信小游戏商城提供拼团能力。
开发者可以选择在商城中上架的商品配置拼团活动（注意：仅限商城内商品）。
配置后，当用户在商城中看到拼团活动商品时，可以选择拼团购买，当组团成功时，可获得优惠价格。

# 功能入口

路径：微信公众平台(mp.weixin.qq.com)-虚拟支付-活动配置-创建拼团活动
创建流程：
① 设置活动名称
② 点击“添加拼团物品”：所选的拼团物品必须已在商城中完成配置上线
③ 设置“折扣”与“上架时间”：拼团成功的商品将享受折扣价格。活动商品上架时间需早于可成团时间，下架时间晚于可成团时间。
④ 设置“可成团时间”：即活动的持续时间，可成团时间需要在活动商品上架时间以内。在活动期间用户可对活动商品进行拼团购买、享优惠价格。在活动期间未成团的用户、将示为拼团失败并原路退款。
⑤“单个团有效时间”：即从团主（发起拼团的用户）支付完成后，成功成团的时间限制。若在时间范围内未成功，将示为拼团失败并原路退款。
⑥“拼团满员人数”：成团的人数要求
⑦“单用户是否可反复参团”：如选择“是” ，第一个团结束后，可以重复发起或参团。 如选择“否”，则不可以重复发起。

# 三、微信小游戏商城接入指南

# MP 配置流程

“配置道具-上架商城-完善发货配置”，仅需三步简单配置
① 使用道具直购能力
在“虚拟支付-基本配置-道具配置”中，基于道具直购能力，配置特定的道具信息。同时，配置好的道具也可以在游戏内使用，
虚拟支付 道具直购 | 微信开放文档

② 配置商城上下架
在“虚拟支付-基本配置-商场管理”中配置道具的上下架，输入在道具直购页面发布成功的道具 id，可自动拉取道具信息，同时开发者可以补充相关商场描述和设定道具限量策略。

③ 完善消息推送与发货
第一步配置接受发货消息的后台服务器地址，具体可参考文档步骤小游戏消息推送

第二步开启消息推送开关，游戏内直购道具在“虚拟支付-基本配置-道具配置”开启，商城道具在“虚拟支付-基本配置-商场管理”开启，开启前会进行一个小测试，会发送 mock 数据通知开发者，开发者需要正确回包。

# 开发者开发流程

# 支付类订阅事件公共说明

所有事件基础结构如下

MiniGame

# 拉取用户最近玩过的游戏角色数据（Event=minigame_query_recent_role_list）

在商城场景下，平台侧会拉取用户游戏角色信息，用于用户在商城购买道具/发放奖励时的分区选择，示意场景及交互如下：

注意：
（1）拉取的分区名/角色名均会经过安全审核，如果审核出现问题，违规词会用特殊处理
（2）事件为实时通知
请求参数
Payload

返回参数

UserRoleInfo

ZoneInfo

PayParam

注意：这里游戏角色的分区若存在层级概念，请按照实际的层级填写，例如：用户在电信一区-测试服-1 号线，请按由大到小的顺序 分为三层（不同游戏层次数量可以不一样）返回，例如

{
    "ZoneInfoList":[
        {
            "ZoneId":"testbigzoneid",
            "ZoneName":"电信一区"
        },
        {
            "ZoneId":"testmiddlezoneid",
            "ZoneName":"测试服"
        },
        {
            "ZoneId":"testsmallzoneid",
            "ZoneName":"一号线"
        }
    ]
}

切勿手动合成一层结构，以下为反面案例：

{
    "ZoneInfoList":[
        {
            "ZoneId":"testzoneid",
            "ZoneName":"电信一区-测试服-1号线"
        }
    ]
}

JSON 格式示例
请求

{
	"CreateTime": 1583202606,
	"MsgType": "event",
	"Event": "minigame_query_recent_role_list",
	"MiniGame": {
		"Payload": "{\"OpenId\":\"to_user_openid\",\"NeedRoleNum\":10,\"ProductId\":\"xxx\",\"GoodsPrice\":123}",
		"PayEventSig": "f749f67b751fa80f27ddc0b7c8d2821aeda162ea22b323cd64a2c8056c2736f0"
	}
}

成功返回

{
  "ErrCode":0,
  "ErrMsg":"success",
  "RecentPlayedRoleList":[
      {
          "RoleId":"testroleid",
          "RoleName":"小游戏开发者",
          "ZoneInfoList":[
              {
                  "ZoneId":"testbigzoneid",
                  "ZoneName":"电信一区"
              },
              {
                  "ZoneId":"testmiddlezoneid",
                  "ZoneName":"测试服"
              },
              {
                  "ZoneId":"testsmallzoneid",
                  "ZoneName":"一号线"
              }
          ],
          "PayParam":{
              "MidasZoneId":"1",
              "Attach":"{\"custom_data\":\"xxx\"}"
          }
      }
  ]
}

失败返回

{"ErrCode":99999,"ErrMsg":"internal error"}

# 道具直购类商城发货通知（Event=minigame_h5_goods_deliver_notify）

见 虚拟支付 道具直购|微信开放文档道具发货消息协议|