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>