tencent cloud

腾讯云超级应用服务

动态与公告
【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
产品简介
产品概述
产品优势
应用场景
购买指南
计费概述
按量计费(后付费)
续费指引
停服说明
快速入门
套餐管理
概述
控制台账号管理
存储配置
加速配置
品牌化配置
平台功能
控制台登录
用户和权限体系
小程序管理
小游戏管理
应用管理
商业化
平台管理
用户管理
团队管理
运营管理
安全中心
代码接入指引
Demo 及 SDK 获取
Android
iOS
Flutter
App 服务端接入指南
GUID 生成规则
小程序开发指南
小程序介绍与开发环境
小程序代码组成
指南
框架
组件
API
服务端
JS SDK
基础库
IDE 使用指南
小游戏开发指南
指南
API
服务端
实践教程
小程序登录实践教程
小程序订阅消息实践教程
支付相关实践教程
广告接入实践教程
小游戏订阅消息实践教程
相关协议
数据处理和安全协议

虚拟支付

PDF
聚焦模式
字号
最后更新时间: 2025-12-19 23:56:02

requestMidasPaymentGameItem

该 API 使用方法为 wx.requestMidasPaymentGameItem(Object object)
功能说明:发起道具直购支付请求,详细流程可参考小游戏支付实践教程
参数及说明:Object object
属性
类型
默认值
必填
说明
signData
string
-
支付原串
具体支付参数见下面的 signData,需要将数据以json格式传递。
signData 例子:
'{"mode":"goods","buyQuantity":1,"currencyType":"USD","platform":"android","productId":"testproductId","goodsPrice":10,"outTradeNo":"xxxxxx","attach":"testdata"}'
paySig
string
-
支付签名
pay_sig 参数的签名算法。使用密钥 appkey(小程序平台不参与加解密及签名验证过程,因此需小游戏与 superApp 自行完成密钥的交换)对支付的请求进行签名,代表请求经过开发者服务端的支付模块发起。签名算法伪代码为:
paySig = to_hex(hmac_sha256(appkey,'requestMidasPaymentGameItem' + '&' + signData))
可参考 paySig 生成
signature
string
-
用户态签名
signature 参数签名算法。伪代码为:signature = hmac_sha256(session_key, rawData)
可参考 signature 生成
success
function
-
接口调用成功的回调函数
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)

signData 参数说明

属性
类型
默认值
必填
说明
mode
string
-
支付的类型
不同的支付类型有各自额外要传的附加参数
buyQuantity
number
-
购买数量
currencyType
string
-
币种,例如 USD(以当前接入的 superapp 支持的币种为准)
platform
string
-
平台,取值为 android 或 ios
productId
string
-
道具 ID
goodsPrice
number
-
道具单价(分)
用来校验价格和后台道具价格是否一致
outTradeNo
string
-
业务订单号
每个订单号只能使用一次,重复使用会失败。
要求 32 个字符内,只能是数字、大小写字母、符号 _-|*@组成,不能以下划线(_)开头。
attach
string
-
透传数据
发货通知时会透传给开发者
错误码说明:
错误码
说明
-15001
虚拟支付接口错误码,缺少参数
-15002
虚拟支付接口错误码,参数不合法
-15003
虚拟支付接口错误码,订单重复
-15004
虚拟支付接口错误码,后台错误
-15005
虚拟支付接口错误码,appId 权限被封禁
-15006
虚拟支付接口错误码,货币类型不支持
-15012
signature 错误
-15014
paySig 错误
-15015
sessionKey 过期
-15016
道具价格错误
-16001
平台业务错误码,商户信息不存在
-16002
平台业务错误码,道具不存在
-16003
平台业务错误码,小游戏推送配置不存在
-16004
平台业务错误码,道具未注册
-16005
平台业务错误码,superapp 后台服务未配置
-16006
平台业务错误码,superapp 支付未开启
示例代码:
wx.requestMidasPaymentGameItem({
signData: '{"mode":"goods","buyQuantity":1,"currencyType":"{set by yourself}","platform":"android","productId":"testproductId","goodsPrice":10,"outTradeNo":"xxxxxx","attach":"testdata"}',
paySig: 'd0b8bbccbe34ed11549bcfd6602b08711f4acc0965253a949cd6a2b895152f9d',
signature: 'd0b8bbccbe34ed11549bcfd6602b08711f4acc0965253a949cd6a2b895152f9d',
success({errMsg, errCode }) {
console.log('pay', errCode);
},
fail({ errMsg, errCode }) {
console.error(errMsg, errCode)
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈