midasPay · 微信小游戏开发API官方文档

# midasPay ### midasPay 开通了虚拟支付的小游戏，可以通过本接口扣除某个用户的游戏币。 **由于可能存在接口调用超时或返回系统失败，但是游戏币实际已经扣除的情况，所以当该接口返回系统失败时，可以用相同的bill\_no再次调用本接口，直到返回非系统失败为止，不会重复扣款，也可以调用取消支付接口取消本次扣款。** #### 正式环境 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">POST https://api.weixin.qq.com/cgi-bin/midas/pay?access_token=ACCESS_TOKEN</code></li></ol> ``` #### 沙箱环境 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/pay?access_token=ACCESS_TOKEN</code></li></ol> ``` #### 参数 ##### string openid 用户唯一标识符 ##### string appid 小程序 appId ##### string offer\_id 米大师分配的offer\_id ##### number ts UNIX 时间戳，单位是秒 ##### string zone\_id 游戏服务器大区id,游戏不分大区则默认zoneId ="1",String类型。如过应用选择支持角色，则角色ID接在分区ID号后用"\_"连接。 ##### string pf 平台安卓：android ##### string user\_ip 用户外网 IP ##### number amt 扣除游戏币数量，不能为 0 ##### string bill\_no 订单号，业务需要保证全局唯一；相同的订单号不会重复扣款。长度不超过63，只能是数字、大小写字母\_-|\*@ ##### string pay\_item 道具名称 ##### string app\_remark 备注。会写到账户流水 ##### string sig 以上所有参数（含可选最多11个）+uri+米大师密钥，用 HMAC-SHA256签名，详见 [米大师支付签名算法](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/midas-signature.html) ##### string access\_token [接口调用凭证](/read/wechat-game-api/297.md) ##### string mp\_sig 以上所有参数（含可选最多13个）+uri+session\_key，用 HMAC-SHA256签名，详见 [米大师支付签名算法](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/midas-signature.html) #### 返回值 ##### Object 返回的 JSON 数据包属性类型说明支持版本errcodenumber错误码errmsgstring错误信息bill\_nostring订单号，有效期是 48 小时balancenumber预扣后的余额used\_gen\_amtnumber本次扣的赠送币的金额**errcode 的合法值** 值说明0请求成功-1系统繁忙，此时请开发者稍候再试90009mp\_sig签名错误90010用户未登录或登录态已过期90011sig签名错误90012订单已存在90013余额不足90017没有调用接口的权限90018参数错误#### POST 数据格式：JSON ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">{</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "openid":"odkx20ENSNa2w5y3g_qOkOvBNM1g",</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> "appid":"wx1234567",</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "offer_id":"12345678",</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> "ts":1507530737,</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "zone_id":"1",</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> "pf":"android",</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "amt":123,</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> "bill_no":"BillNo_123",</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "sig":"f705c7351830125282ffc6d3c22c81db19b50a748f60f7c8f267e59152941d83",</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> "mp_sig":"168704ac52eea6da27e0d76fd659cd8d628457dd680459a57365e17c0f40de4a"</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">}</code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/midas-payment/midasPay.html>