微信小程序虛擬支付（米大師）支付接口大全的使用說明
日期：2018-04-25 作者：管理員 來源：本站
微信小程序虛擬支付（米大師）支付接口大全的使用說明【微信小程序支付系統定制開發電話】midasCancelPay接口：開通了虛擬支付的小游戲，若扣除游戲幣的訂單號在有效時間內，可以通過本接口取消該筆扣除游戲幣的訂單。midasGetBalance接口：開通了虛擬支付的小游戲，可以通過本接口查看某個用戶的游戲幣余額。midasPay接口：開通了虛擬支付的小游戲，可以通過本接口扣除某個用戶的游戲幣。 由于可能存在接口調用超時或返回系統失敗，但是游戲幣實際已經扣除的情況，所以當該接口返回系統失敗時，可以用相同的bill_no再次調用本接口，直到返回非系統失敗為止，不會重復扣款，也可以調用取消支付接口取消本次扣款。midasPresent接口：開通了虛擬支付的小游戲，可以通過該接口贈送游戲幣給某個用戶。
微信小程序虛擬支付（米大師）支付接口大全的使用說明【微信小程序支付系統定制開發電話：400-000-1280】
wx.requestMidasPayment(Object object)
發起米大師支付
參數
Object object
| 屬性 | 類型 | 默認值 | 是否必填 | 說明 | 支持版本 |
|---|---|---|---|---|---|
| mode | string | 是 | 支付的類型，不同的支付類型有各自額外要傳的附加參數。 | ||
| env | number | 0 | 否 | 環境配置 | |
| offerId | string | 是 | 在米大師側申請的應用 id | ||
| currencyType | string | 是 | 幣種 | ||
| platform | string | 否 | 申請接入時的平臺，platform 與應用id有關。 | ||
| buyQuantity | number | 否 | 購買數量。mode=game 時必填。購買數量。詳見 buyQuantity 限制說明。 | ||
| zoneId | string | 1 | 否 | 分區 ID | |
| success | function | 否 | 接口調用成功的回調函數 | ||
| fail | function | 否 | 接口調用失敗的回調函數 | ||
| complete | function | 否 | 接口調用結束的回調函數（調用成功、失敗都會執行） |
object.mode 的合法值
| 值 | 說明 |
|---|---|
| game | 購買游戲幣 |
object.env 的合法值
| 值 | 說明 |
|---|---|
| 0 | 米大師正式環境 |
| 1 | 米大師沙箱環境 |
object.currencyType 的合法值
| 值 | 說明 |
|---|---|
| CNY | 人民幣 |
object.platform 的合法值
| 值 | 說明 |
|---|---|
| android | android |
fail 回調函數
參數
Object res
| 屬性 | 類型 | 說明 | 支持版本 |
|---|---|---|---|
| errMsg | string | 錯誤信息 | |
| errCode | number | 錯誤碼 |
res.errCode 的合法值
| 值 | 說明 |
|---|---|
| -1 | 系統失敗 |
| -2 | 支付取消 |
| -15001 | 虛擬支付接口錯誤碼，缺少參數 |
| -15002 | 虛擬支付接口錯誤碼，參數不合法 |
| -15003 | 虛擬支付接口錯誤碼，訂單重復 |
| -15004 | 虛擬支付接口錯誤碼，后臺錯誤 |
| -15006 | 虛擬支付接口錯誤碼，appId 權限被封禁 |
| -15006 | 虛擬支付接口錯誤碼，貨幣類型不支持 |
| -15007 | 虛擬支付接口錯誤碼，訂單已支付 |
| 1 | 虛擬支付接口錯誤碼，用戶取消支付 |
| 2 | 虛擬支付接口錯誤碼，客戶端錯誤, 判斷到小程序在用戶處于支付中時,又發起了一筆支付請求 |
| 3 | 虛擬支付接口錯誤碼，Android 獨有錯誤：用戶使用 Google Play 支付，而手機未安裝 Google Play |
| 4 | 虛擬支付接口錯誤碼，用戶操作系統支付狀態異常 |
| 5 | 虛擬支付接口錯誤碼，操作系統錯誤 |
| 6 | 虛擬支付接口錯誤碼，其他錯誤 |
| 1000 | 參數錯誤 |
| 1003 | 米大師 Portal 錯誤 |
buyQuantity 限制說明
購買游戲幣的時候，buyQuantity 不可任意填寫。需滿足 buyQuantity * 游戲幣單價 = 限定的價格等級。如：游戲幣單價為 0.1 元，一次購買最少數量是 10。
有效價格等級如下：
| 價格等級（單位：人民幣） |
|---|
| 1 |
| 3 |
| 6 |
| 8 |
| 12 |
| 18 |
| 25 |
| 30 |
| 40 |
| 45 |
| 50 |
| 60 |
| 68 |
| 73 |
| 78 |
| 88 |
| 98 |
| 108 |
| 118 |
| 128 |
| 148 |
| 168 |
| 188 |
| 198 |
| 328 |
| 648 |
midasCancelPay
開通了虛擬支付的小游戲，若扣除游戲幣的訂單號在有效時間內，可以通過本接口取消該筆扣除游戲幣的訂單
正式環境
POST https://api.weixin.qq.com/cgi-bin/midas/cancelpay?access_token=ACCESS_TOKEN
沙箱環境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/cancelpay?access_token=ACCESS_TOKEN
參數
| 參數 | 類型 | 默認值 | 是否必填 | 說明 | |
|---|---|---|---|---|---|
| openid | string | 是 | 用戶唯一標識符 | ||
| appid | string | 是 | 小程序 appId | ||
| offer_id | string | 是 | 米大師分配的offer_id | ||
| ts | number | 是 | UNIX 時間戳，單位是秒 | ||
| zone_id | string | 是 | 游戲服務器大區id,游戲不分大區則默認zoneId ="1",String類型。如過應用選擇支持角色，則角色ID接在分區ID號后用"_"連接。 | ||
| pf | string | 是 | 平臺 安卓：android | ||
| user_ip | string | 否 | 用戶外網 IP | ||
| bill_no | string | 是 | 訂單號，業務需要保證全局唯一；相同的訂單號不會重復扣款。長度不超過63，只能是數字、大小寫字母_- | *@ | |
| pay_item | string | 否 | 道具名稱 | ||
| sig | string | 是 | 以上所有參數（含可選最多9個）+uri+米大師密鑰，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 | ||
| access_token | string | 是 | 接口調用憑證 | ||
| mp_sig | string | 是 | 以上所有參數（含可選最多11個）+uri+session_key，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 |
返回值
| 參數 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯誤碼 |
| errmsg | number | 錯誤信息 |
| bill_no | string | 扣除游戲幣的訂單號 |
errcode 的合法值
| 值 | 說明 |
|---|---|
| 0 | 請求成功 |
| -1 | 系統繁忙，此時請開發者稍候再試 |
| 90000 | 訂單不存在 |
| 90009 | mp_sig簽名錯誤 |
| 90010 | 用戶未登錄或登錄態已過期 |
| 90011 | sig簽名錯誤 |
| 90014 | 訂單已支付確認完成，不允許當前操作 |
| 90015 | 訂單已回退，不允許當前操作 |
| 90016 | 訂單處理中 |
| 90017 | 沒有調用接口的權限 |
| 90018 | 參數錯誤 |
POST 數據格式：JSON
{
"openid":"odkx20ENSNa2w5y3g_qOkOvBNM1g",
"appid":"wx1234567",
"offer_id":"12345678",
"ts":1507530737,
"zone_id":"1",
"pf":"android",
"bill_no":"BillNo_123",
"sig":"8bd582a6b06e38a1346fc335ebcb11c8990241bbe23118eb3d22f0ef42870a6a",
"mp_sig":"2651b0ee9cc7e7e1791de388d34c4d0357936e9ab7b8a9db9ba7b0537208f72b"
}midasGetBalance
開通了虛擬支付的小游戲，可以通過本接口查看某個用戶的游戲幣余額
正式環境
POST https://api.weixin.qq.com/cgi-bin/midas/getbalance?access_token=ACCESS_TOKEN
沙箱環境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/getbalance?access_token=ACCESS_TOKEN
參數
| 參數 | 類型 | 默認值 | 是否必填 | 說明 |
|---|---|---|---|---|
| openid | string | 是 | 用戶唯一標識符 | |
| appid | string | 是 | 小程序 appId | |
| offer_id | string | 是 | 米大師分配的offer_id | |
| ts | number | 是 | UNIX 時間戳，單位是秒 | |
| zone_id | string | 是 | 游戲服務器大區id,游戲不分大區則默認zoneId ="1",String類型。如過應用選擇支持角色，則角色ID接在分區ID號后用"_"連接。 | |
| pf | string | 是 | 平臺 安卓：android | |
| user_ip | string | 否 | 用戶外網 IP | |
| sig | string | 是 | 以上所有參數（含可選最多7個）+uri+米大師密鑰，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 | |
| access_token | string | 是 | 接口調用憑證 | |
| mp_sig | string | 是 | 以上所有參數（含可選最多9個）+uri+session_key，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 |
返回值
| 參數 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯誤碼 |
| errmsg | number | 錯誤信息 |
| balance | number | 游戲幣個數（包含贈送） |
| gen_balance | number | 贈送游戲幣數量（贈送游戲幣數量） |
| first_save | boolean | 是否滿足歷史首次充值 |
| save_amt | number | 累計充值金額的游戲幣數量 |
| save_sum | number | 歷史總游戲幣金額 |
| cost_sum | number | 歷史總消費游戲幣金額 |
| present_sum | number | 歷史累計收到贈送金額 |
errcode 的合法值
| 值 | 說明 |
|---|---|
| 0 | 請求成功 |
| -1 | 系統繁忙，此時請開發者稍候再試 |
| 90009 | mp_sig簽名錯誤 |
| 90010 | 用戶未登錄或登錄態已過期 |
| 90011 | sig簽名錯誤 |
| 90017 | 沒有調用接口的權限 |
| 90018 | 參數錯誤 |
first_save 的合法值
| 值 | 說明 |
|---|---|
| 1 | 滿足 |
| 2 | 不滿足 |
POST 數據格式：JSON
{
"openid":"odkx20ENSNa2w5y3g_qOkOvBNM1g",
"appid":"wx1234567",
"offer_id":"12345678",
"ts":1507530737,
"zone_id":"1",
"pf":"android",
"sig":"d1f0a41272f9b85618361323e1b19cd8cb0213f21b935aeaa39c160892031e97",
"mp_sig":"ff4c5bb39dea1002a8f03be0438724e1a8bcea5ebce8f221f9b9fea3bcf3bf76"
}midasPay
開通了虛擬支付的小游戲，可以通過本接口扣除某個用戶的游戲幣。 由于可能存在接口調用超時或返回系統失敗，但是游戲幣實際已經扣除的情況，所以當該接口返回系統失敗時，可以用相同的bill_no再次調用本接口，直到返回非系統失敗為止，不會重復扣款，也可以調用取消支付接口取消本次扣款。
正式環境
POST https://api.weixin.qq.com/cgi-bin/midas/pay?access_token=ACCESS_TOKEN
沙箱環境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/pay?access_token=ACCESS_TOKEN
參數
| 參數 | 類型 | 默認值 | 是否必填 | 說明 | |
|---|---|---|---|---|---|
| openid | string | 是 | 用戶唯一標識符 | ||
| appid | string | 是 | 小程序 appId | ||
| offer_id | string | 是 | 米大師分配的offer_id | ||
| ts | number | 是 | UNIX 時間戳，單位是秒 | ||
| zone_id | string | 是 | 游戲服務器大區id,游戲不分大區則默認zoneId ="1",String類型。如過應用選擇支持角色，則角色ID接在分區ID號后用"_"連接。 | ||
| pf | string | 是 | 平臺 安卓：android | ||
| user_ip | string | 否 | 用戶外網 IP | ||
| amt | number | 是 | 扣除游戲幣數量，不能為 0 | ||
| bill_no | string | 是 | 訂單號，業務需要保證全局唯一；相同的訂單號不會重復扣款。長度不超過63，只能是數字、大小寫字母_- | *@ | |
| pay_item | string | 否 | 道具名稱 | ||
| app_remark | string | 否 | 備注。會寫到賬戶流水 | ||
| sig | string | 是 | 以上所有參數（含可選最多11個）+uri+米大師密鑰，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 | ||
| access_token | string | 是 | 接口調用憑證 | ||
| mp_sig | string | 是 | 以上所有參數（含可選最多13個）+uri+session_key，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 |
返回值
| 參數 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯誤碼 |
| errmsg | number | 錯誤信息 |
| bill_no | string | 訂單號，有效期是 48 小時 |
| balance | number | 預扣后的余額 |
| used_gen_balance | number | 本次扣的贈送幣的余額 |
errcode 的合法值
| 值 | 說明 |
|---|---|
| 0 | 請求成功 |
| -1 | 系統繁忙，此時請開發者稍候再試 |
| 90009 | mp_sig簽名錯誤 |
| 90010 | 用戶未登錄或登錄態已過期 |
| 90011 | sig簽名錯誤 |
| 90012 | 訂單已存在 |
| 90013 | 余額不足 |
| 90017 | 沒有調用接口的權限 |
| 90018 | 參數錯誤 |
POST 數據格式：JSON
{
"openid":"odkx20ENSNa2w5y3g_qOkOvBNM1g",
"appid":"wx1234567",
"offer_id":"12345678",
"ts":1507530737,
"zone_id":"1",
"pf":"android",
"amt":123,
"bill_no":"BillNo_123",
"sig":"f705c7351830125282ffc6d3c22c81db19b50a748f60f7c8f267e59152941d83",
"mp_sig":"168704ac52eea6da27e0d76fd659cd8d628457dd680459a57365e17c0f40de4a"
}midasPresent
開通了虛擬支付的小游戲，可以通過該接口贈送游戲幣給某個用戶。
正式環境
POST https://api.weixin.qq.com/cgi-bin/midas/present?access_token=ACCESS_TOKEN
沙箱環境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/present?access_token=ACCESS_TOKEN
參數
| 參數 | 類型 | 默認值 | 是否必填 | 說明 | |
|---|---|---|---|---|---|
| openid | string | 是 | 用戶唯一標識符 | ||
| appid | string | 是 | 小程序 appId | ||
| offer_id | string | 是 | 米大師分配的offer_id | ||
| ts | number | 是 | UNIX 時間戳，單位是秒 | ||
| zone_id | string | 是 | 游戲服務器大區id,游戲不分大區則默認zoneId ="1",String類型。如過應用選擇支持角色，則角色ID接在分區ID號后用"_"連接。 | ||
| pf | string | 是 | 平臺 安卓：android | ||
| user_ip | string | 否 | 用戶外網 IP | ||
| bill_no | string | 是 | 訂單號，業務需要保證全局唯一；相同的訂單號不會重復扣款。長度不超過63，只能是數字、大小寫字母_- | *@ | |
| present_counts | number | 是 | 贈送游戲幣的個數，不能為0 | ||
| sig | string | 是 | 以上所有參數（含可選最多9個）+uri+米大師密鑰，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 | ||
| access_token | string | 是 | 接口調用憑證 | ||
| mp_sig | string | 是 | 以上所有參數（含可選最多11個）+uri+session_key，用 HMAC-SHA256簽名，詳見 米大師支付簽名算法 |
返回值
| 參數 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯誤碼 |
| errmsg | number | 錯誤信息 |
| balance | number | 贈送后的余額 |
| bill_no | string | 贈送游戲幣的訂單號 |
errcode 的合法值
| 值 | 說明 |
|---|---|
| 0 | 請求成功 |
| -1 | 系統繁忙，此時請開發者稍候再試 |
| 90009 | mp_sig簽名錯誤 |
| 90010 | 用戶未登錄或登錄態已過期 |
| 90011 | sig簽名錯誤 |
| 90012 | 訂單已存在 |
| 90017 | 沒有調用接口的權限 |
| 90018 | 參數錯誤 |
POST 數據格式：JSON
{
"openid":"odkx20ENSNa2w5y3g_qOkOvBNM1g",
"appid":"wx1234567",
"offer_id":"12345678",
"ts":1507530737,
"zone_id":"1",
"pf":"android",
"present_counts":233,
"bill_no":"BillNo_123",
"sig":"e53e5241bbb014b3a9fcc221d66fecab8734b53fe94d7a8c65180e175e29f443",
"mp_sig":"39271a12d8d56b0395981a0990a9e75ae239c54f419cb6235399fe70acf8ccfb"
}掃二維碼手機查看該文章
- 上一篇：微信小游戲防沉迷系統最新技術文檔
- 下一篇：最新微信小游戲圈接口開發文檔
在線咨詢
電話咨詢
