# 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>