微信小程序虛擬支付(米大師)支付接口大全的使用說明【微信小程序支付系統定制開發電話】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 的合法值
object.env 的合法值
object.currencyType 的合法值
object.platform 的合法值
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 的合法值
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"
}