# midasGetBalance ### midasGetBalance 开通了虚拟支付的小游戏，可以通过本接口查看某个用户的游戏币余额 #### 正式环境 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">POST https</span><span class="pun">:</span><span class="com">//api.weixin.qq.com/cgi-bin/midas/getbalance?access_token=ACCESS_TOKEN</span></code></li></ol> ``` #### 沙箱环境 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln">POST https</span><span class="pun">:</span><span class="com">//api.weixin.qq.com/cgi-bin/midas/sandbox/getbalance?access_token=ACCESS_TOKEN</span></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 ##### string sig 以上所有参数（含可选最多7个）+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 以上所有参数（含可选最多9个）+uri+session\_key，用 HMAC-SHA256签名，详见 [米大师支付签名算法](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/midas-signature.html) #### 返回值 ##### Object 返回的 JSON 数据包 属性类型说明支持版本errcodenumber错误码errmsgstring错误信息balancenumber游戏币个数（包含赠送）gen\_balancenumber赠送游戏币数量（赠送游戏币数量）first\_saveboolean是否满足历史首次充值save\_amtnumber累计充值金额的游戏币数量save\_sumnumber历史总游戏币金额cost\_sumnumber历史总消费游戏币金额present\_sumnumber历史累计收到赠送金额**errcode 的合法值** 值说明0请求成功-1系统繁忙，此时请开发者稍候再试90009mp\_sig签名错误90010用户未登录或登录态已过期90011sig签名错误90017没有调用接口的权限90018参数错误**first\_save 的合法值** 值说明1满足2不满足#### POST 数据格式：JSON ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">{</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"openid"</span><span class="pun">:</span><span class="str">"odkx20ENSNa2w5y3g_qOkOvBNM1g"</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"appid"</span><span class="pun">:</span><span class="str">"wx1234567"</span><span class="pun">,</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"offer_id"</span><span class="pun">:</span><span class="str">"12345678"</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"ts"</span><span class="pun">:</span><span class="lit">1507530737</span><span class="pun">,</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"zone_id"</span><span class="pun">:</span><span class="str">"1"</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"pf"</span><span class="pun">:</span><span class="str">"android"</span><span class="pun">,</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"sig"</span><span class="pun">:</span><span class="str">"d1f0a41272f9b85618361323e1b19cd8cb0213f21b935aeaa39c160892031e97"</span><span class="pun">,</span></code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pln"> </span><span class="str">"mp_sig"</span><span class="pun">:</span><span class="str">"ff4c5bb39dea1002a8f03be0438724e1a8bcea5ebce8f221f9b9fea3bcf3bf76"</span></code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"><span class="pun">}</span></code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/midas-payment/midasGetBalance.html>