小游戏道具直购（透传模式）
最后更新时间：2025-10-28 10:38:28
简介
在团队绑定了商户号后，如果团队内的小游戏需要使用虚拟支付，则需要由小程序团队管理员在“商业化-虚拟支付”模块下，单独为小游戏向 superapp 申请开通支付功能，superapp 审批通过之后，小游戏才可调用 superapp 提供的虚拟支付能力。
注意：
1. 虚拟支付目前仅支持道具直购模式，仅支持小游戏接入。
2. 道具直购是指在小游戏中，玩家可以通过虚拟支付功能，直接购买游戏内的虚拟道具（如皮肤、金币、装备等）的支付方式。
功能模块和操作流程
1. 开通支付
角色和权限
功能 | 角色 | 小程序团队管理员 |
开通支付-申请开通 | ✓ |
小程序团队管理员：拥有开通支付模块的权限，拥有开通支付-申请开通的权限。
1.1 选择需要开通支付功能的小游戏，点击“申请开通”。
1.2 填写申请留言，点击确定，提交申请，并等待 superapp 审批。
审批通过后，此时虚拟支付功能已可使用，您还需要参考下方流程进行道具发货推送配置和道具录入。
2. 基础配置
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 |
发货推送配置-查看 | 只读 | 只读 | ✓ | ✓ | ✓ | ✓ |
发货推送配置-配置、修改 | - | - | ✓ | ✓ | - | - |
发货推送配置-申请证书、密钥 | - | - | ✓ | ✓ | - | - |
虚拟商品免审批-查看 | 只读 | 只读 | ✓ | ✓ | ✓ | ✓ |
虚拟商品免审批-申请 | - | - | ✓ | ✓ | - | - |
超级管理员/平台管理员：拥有基础配置模块的只读权限，拥有发货推送配置、虚拟商品免审批的查看权限。
小程序团队管理员/小程序高级开发者：拥有基础配置模块的权限，拥有发货推送配置的、虚拟商品免审批的查看权限，拥有发货推送配置-配置、修改、申请证书、密钥的权限，拥有虚拟商品免审批的申请权限。
小程序高级开发者/小程序运营人员：拥有基础配置模块的权限，拥有发货推送配置、虚拟商品免审批的查看权限。
2.1 发货推送配置
开发者需要在虚拟支付-基础配置中，完成道具发货推送配置，才可接收到小游戏道具发货事件通知。
点击配置按钮，填写发货推送域名，同时向 superapp 申请用于接口安全校验的证书和密钥。
字段说明：
URL：开发者用来接收道具发货消息事件的接口 URL。开发者所填写的 URL 必须以 http:// 或 https:// 开头，分别支持80端口和443端口。
测试 URL：开发者用来测试接收道具发货消息事件的接口 URL。
申请证书&密钥：首次保存会向 superapp 申请证书和密钥，superapp 会将证书和密钥打包后通过邮件方式发送至您当前登录账号绑定的邮箱。
在基础配置完成推送配置后，在道具管理页面，开启道具发货推送。
2.2 道具发布免审批权限申请
小游戏道具需要经过 superapp 审批后才可发布使用，开发者可以跟 superapp 管理者协商后，申请“虚拟商品发布时免审批”的权限，superapp 审批通过后，小游戏发布道具时无需再经过 superapp 审批。
注意：
开发者需要注意游戏道具是否符合 superapp 的运营规范，必要时 superapp 可主动关闭免审核权限并下架游戏道具。
3. 道具管理
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 |
道具列表-查看 | 只读 | 只读 | ✓ | ✓ | ✓ | ✓ |
道具列表-下载模板 | - | - | ✓ | ✓ | ✓ | - |
道具列表-添加、导入、编辑道具 | - | - | ✓ | ✓ | ✓ | - |
道具列表-提交发布申请 | - | - | ✓ | ✓ | - | - |
道具列表-删除、下架道具 | - | - | ✓ | - | - | - |
超级管理员/平台管理员：拥有道具管理模块的只读权限，拥有道具列表的查看权限。
小程序团队管理员：拥有道具管理模块的权限，拥有道具列表-查看、下载模板、添加/导入/编辑道具、提交发布申请、删除/下架道具的权限。
小程序高级开发者：拥有道具管理模块的权限，拥有道具列表-查看、下载模板、添加/导入/编辑道具、提交发布申请的权限。
小程序开发者：拥有道具管理模块的权限，拥有道具列表-查看、下载模板、添加/导入/编辑道具的权限。
小程序运营人员：拥有道具管理模块的权限，拥有道具列表的查看权限。
3.1 添加道具
在虚拟支付-道具管理中，开发者可通过添加道具，创建游戏道具。
填写道具 ID、道具名称、道具价格、道具图片等内容，点击保存。
3.2 批量添加
您也可以下载导入模板，填写 Excel 表格后，通过道具导入的方式，将游戏道具批量导入。
3.3 道具发布
创建道具后，可以通过单个发布或批量选择发布的方式，发布游戏道具，发布后，游戏道具即可在开发者调用虚拟支付接口时被使用。
4. 订单记录
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 |
订单记录-列表、详情查看 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
订单记录-导出 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
超级管理员/平台管理员/小程序团队管理员/小程序高级开发者/小程序开发者/小程序运营人员：拥有订单记录模块的权限，拥有订单记录-列表、详情的查看权限，拥有订单记录的导出权限。
当玩家在小游戏中购买了道具并完成支付后，即可在“虚拟支付-订单记录”中查询道具直购订单。
5. 售后记录
C 端用户可发起虚拟支付订单的退款，退款单生成后，可在商业化-虚拟支付-售后记录中查询。可通过退款发起时间（默认最近7天）来查询数据，最多支持查询最近12个月内的订单数据。可通过订单号或退款单号搜索退款订单，支持导出详细数据。
文档反馈