微信小程序虛擬支付(米大師)支付接口大全的使用說(shuō)明【微信小程序支付系統(tǒng)定制開發(fā)電話】midasCancelPay接口:開通了虛擬支付的小游戲,若扣除游戲幣的訂單號(hào)在有效時(shí)間內(nèi),可以通過(guò)本接口取消該筆扣除游戲幣的訂單。midasGetBalance接口:開通了虛擬支付的小游戲,可以通過(guò)本接口查看某個(gè)用戶的游戲幣余額。midasPay接口:開通了虛擬支付的小游戲,可以通過(guò)本接口扣除某個(gè)用戶的游戲幣。 由于可能存在接口調(diào)用超時(shí)或返回系統(tǒng)失敗,但是游戲幣實(shí)際已經(jīng)扣除的情況,所以當(dāng)該接口返回系統(tǒng)失敗時(shí),可以用相同的bill_no再次調(diào)用本接口,直到返回非系統(tǒng)失敗為止,不會(huì)重復(fù)扣款,也可以調(diào)用取消支付接口取消本次扣款。midasPresent接口:開通了虛擬支付的小游戲,可以通過(guò)該接口贈(zèng)送游戲幣給某個(gè)用戶。
微信小程序虛擬支付(米大師)支付接口大全的使用說(shuō)明【微信小程序支付系統(tǒng)定制開發(fā)電話:400-000-1280】
wx.requestMidasPayment(Object object)
發(fā)起米大師支付
參數(shù)
Object object
屬性 |
類型 |
默認(rèn)值 |
是否必填 |
說(shuō)明 |
支持版本 |
---|
mode |
string |
|
是 |
支付的類型,不同的支付類型有各自額外要傳的附加參數(shù)。 |
|
env |
number |
0 |
否 |
環(huán)境配置 |
|
offerId |
string |
|
是 |
在米大師側(cè)申請(qǐng)的應(yīng)用 id |
|
currencyType |
string |
|
是 |
幣種 |
|
platform |
string |
|
否 |
申請(qǐng)接入時(shí)的平臺(tái),platform 與應(yīng)用id有關(guān)。 |
|
buyQuantity |
number |
|
否 |
購(gòu)買數(shù)量。mode=game 時(shí)必填。購(gòu)買數(shù)量。詳見 buyQuantity 限制說(shuō)明。 |
|
zoneId |
string |
1 |
否 |
分區(qū) ID |
|
success |
function |
|
否 |
接口調(diào)用成功的回調(diào)函數(shù) |
|
fail |
function |
|
否 |
接口調(diào)用失敗的回調(diào)函數(shù) |
|
complete |
function |
|
否 |
接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行) |
|
object.mode 的合法值
值 |
說(shuō)明 |
---|
game |
購(gòu)買游戲幣 |
object.env 的合法值
值 |
說(shuō)明 |
---|
0 |
米大師正式環(huán)境 |
1 |
米大師沙箱環(huán)境 |
object.currencyType 的合法值
object.platform 的合法值
值 |
說(shuō)明 |
---|
android |
android |
fail 回調(diào)函數(shù)
參數(shù)
Object res
屬性 |
類型 |
說(shuō)明 |
支持版本 |
---|
errMsg |
string |
錯(cuò)誤信息 |
|
errCode |
number |
錯(cuò)誤碼 |
|
res.errCode 的合法值
值 |
說(shuō)明 |
---|
-1 |
系統(tǒng)失敗 |
-2 |
支付取消 |
-15001 |
虛擬支付接口錯(cuò)誤碼,缺少參數(shù) |
-15002 |
虛擬支付接口錯(cuò)誤碼,參數(shù)不合法 |
-15003 |
虛擬支付接口錯(cuò)誤碼,訂單重復(fù) |
-15004 |
虛擬支付接口錯(cuò)誤碼,后臺(tái)錯(cuò)誤 |
-15006 |
虛擬支付接口錯(cuò)誤碼,appId 權(quán)限被封禁 |
-15006 |
虛擬支付接口錯(cuò)誤碼,貨幣類型不支持 |
-15007 |
虛擬支付接口錯(cuò)誤碼,訂單已支付 |
1 |
虛擬支付接口錯(cuò)誤碼,用戶取消支付 |
2 |
虛擬支付接口錯(cuò)誤碼,客戶端錯(cuò)誤, 判斷到小程序在用戶處于支付中時(shí),又發(fā)起了一筆支付請(qǐng)求 |
3 |
虛擬支付接口錯(cuò)誤碼,Android 獨(dú)有錯(cuò)誤:用戶使用 Google Play 支付,而手機(jī)未安裝 Google Play |
4 |
虛擬支付接口錯(cuò)誤碼,用戶操作系統(tǒng)支付狀態(tài)異常 |
5 |
虛擬支付接口錯(cuò)誤碼,操作系統(tǒng)錯(cuò)誤 |
6 |
虛擬支付接口錯(cuò)誤碼,其他錯(cuò)誤 |
1000 |
參數(shù)錯(cuò)誤 |
1003 |
米大師 Portal 錯(cuò)誤 |
buyQuantity 限制說(shuō)明
購(gòu)買游戲幣的時(shí)候,buyQuantity 不可任意填寫。需滿足 buyQuantity * 游戲幣單價(jià) = 限定的價(jià)格等級(jí)。如:游戲幣單價(jià)為 0.1 元,一次購(gòu)買最少數(shù)量是 10。
有效價(jià)格等級(jí)如下:
價(jià)格等級(jí)(單位:人民幣) |
---|
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
開通了虛擬支付的小游戲,若扣除游戲幣的訂單號(hào)在有效時(shí)間內(nèi),可以通過(guò)本接口取消該筆扣除游戲幣的訂單
正式環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/cancelpay?access_token=ACCESS_TOKEN
沙箱環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/cancelpay?access_token=ACCESS_TOKEN
參數(shù)
參數(shù) |
類型 |
默認(rèn)值 |
是否必填 |
說(shuō)明 |
|
---|
openid |
string |
|
是 |
用戶唯一標(biāo)識(shí)符 |
|
appid |
string |
|
是 |
小程序 appId |
|
offer_id |
string |
|
是 |
米大師分配的offer_id |
|
ts |
number |
|
是 |
UNIX 時(shí)間戳,單位是秒 |
|
zone_id |
string |
|
是 |
游戲服務(wù)器大區(qū)id,游戲不分大區(qū)則默認(rèn)zoneId ="1",String類型。如過(guò)應(yīng)用選擇支持角色,則角色I(xiàn)D接在分區(qū)ID號(hào)后用"_"連接。 |
|
pf |
string |
|
是 |
平臺(tái) 安卓:android |
|
user_ip |
string |
|
否 |
用戶外網(wǎng) IP |
|
bill_no |
string |
|
是 |
訂單號(hào),業(yè)務(wù)需要保證全局唯一;相同的訂單號(hào)不會(huì)重復(fù)扣款。長(zhǎng)度不超過(guò)63,只能是數(shù)字、大小寫字母_- |
*@ |
pay_item |
string |
|
否 |
道具名稱 |
|
sig |
string |
|
是 |
以上所有參數(shù)(含可選最多9個(gè))+uri+米大師密鑰,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
|
access_token |
string |
|
是 |
接口調(diào)用憑證 |
|
mp_sig |
string |
|
是 |
以上所有參數(shù)(含可選最多11個(gè))+uri+session_key,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
|
返回值
參數(shù) |
類型 |
說(shuō)明 |
---|
errcode |
number |
錯(cuò)誤碼 |
errmsg |
number |
錯(cuò)誤信息 |
bill_no |
string |
扣除游戲幣的訂單號(hào) |
errcode 的合法值
值 |
說(shuō)明 |
---|
0 |
請(qǐng)求成功 |
-1 |
系統(tǒng)繁忙,此時(shí)請(qǐng)開發(fā)者稍候再試 |
90000 |
訂單不存在 |
90009 |
mp_sig簽名錯(cuò)誤 |
90010 |
用戶未登錄或登錄態(tài)已過(guò)期 |
90011 |
sig簽名錯(cuò)誤 |
90014 |
訂單已支付確認(rèn)完成,不允許當(dāng)前操作 |
90015 |
訂單已回退,不允許當(dāng)前操作 |
90016 |
訂單處理中 |
90017 |
沒(méi)有調(diào)用接口的權(quán)限 |
90018 |
參數(shù)錯(cuò)誤 |
POST 數(shù)據(jù)格式: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
開通了虛擬支付的小游戲,可以通過(guò)本接口查看某個(gè)用戶的游戲幣余額
正式環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/getbalance?access_token=ACCESS_TOKEN
沙箱環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/getbalance?access_token=ACCESS_TOKEN
參數(shù)
參數(shù) |
類型 |
默認(rèn)值 |
是否必填 |
說(shuō)明 |
---|
openid |
string |
|
是 |
用戶唯一標(biāo)識(shí)符 |
appid |
string |
|
是 |
小程序 appId |
offer_id |
string |
|
是 |
米大師分配的offer_id |
ts |
number |
|
是 |
UNIX 時(shí)間戳,單位是秒 |
zone_id |
string |
|
是 |
游戲服務(wù)器大區(qū)id,游戲不分大區(qū)則默認(rèn)zoneId ="1",String類型。如過(guò)應(yīng)用選擇支持角色,則角色I(xiàn)D接在分區(qū)ID號(hào)后用"_"連接。 |
pf |
string |
|
是 |
平臺(tái) 安卓:android |
user_ip |
string |
|
否 |
用戶外網(wǎng) IP |
sig |
string |
|
是 |
以上所有參數(shù)(含可選最多7個(gè))+uri+米大師密鑰,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
access_token |
string |
|
是 |
接口調(diào)用憑證 |
mp_sig |
string |
|
是 |
以上所有參數(shù)(含可選最多9個(gè))+uri+session_key,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
返回值
參數(shù) |
類型 |
說(shuō)明 |
---|
errcode |
number |
錯(cuò)誤碼 |
errmsg |
number |
錯(cuò)誤信息 |
balance |
number |
游戲幣個(gè)數(shù)(包含贈(zèng)送) |
gen_balance |
number |
贈(zèng)送游戲幣數(shù)量(贈(zèng)送游戲幣數(shù)量) |
first_save |
boolean |
是否滿足歷史首次充值 |
save_amt |
number |
累計(jì)充值金額的游戲幣數(shù)量 |
save_sum |
number |
歷史總游戲幣金額 |
cost_sum |
number |
歷史總消費(fèi)游戲幣金額 |
present_sum |
number |
歷史累計(jì)收到贈(zèng)送金額 |
errcode 的合法值
值 |
說(shuō)明 |
---|
0 |
請(qǐng)求成功 |
-1 |
系統(tǒng)繁忙,此時(shí)請(qǐng)開發(fā)者稍候再試 |
90009 |
mp_sig簽名錯(cuò)誤 |
90010 |
用戶未登錄或登錄態(tài)已過(guò)期 |
90011 |
sig簽名錯(cuò)誤 |
90017 |
沒(méi)有調(diào)用接口的權(quán)限 |
90018 |
參數(shù)錯(cuò)誤 |
first_save 的合法值
POST 數(shù)據(jù)格式:JSON
{
"openid":"odkx20ENSNa2w5y3g_qOkOvBNM1g",
"appid":"wx1234567",
"offer_id":"12345678",
"ts":1507530737,
"zone_id":"1",
"pf":"android",
"sig":"d1f0a41272f9b85618361323e1b19cd8cb0213f21b935aeaa39c160892031e97",
"mp_sig":"ff4c5bb39dea1002a8f03be0438724e1a8bcea5ebce8f221f9b9fea3bcf3bf76"
}
midasPay
開通了虛擬支付的小游戲,可以通過(guò)本接口扣除某個(gè)用戶的游戲幣。 由于可能存在接口調(diào)用超時(shí)或返回系統(tǒng)失敗,但是游戲幣實(shí)際已經(jīng)扣除的情況,所以當(dāng)該接口返回系統(tǒng)失敗時(shí),可以用相同的bill_no再次調(diào)用本接口,直到返回非系統(tǒng)失敗為止,不會(huì)重復(fù)扣款,也可以調(diào)用取消支付接口取消本次扣款。
正式環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/pay?access_token=ACCESS_TOKEN
沙箱環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/pay?access_token=ACCESS_TOKEN
參數(shù)
參數(shù) |
類型 |
默認(rèn)值 |
是否必填 |
說(shuō)明 |
|
---|
openid |
string |
|
是 |
用戶唯一標(biāo)識(shí)符 |
|
appid |
string |
|
是 |
小程序 appId |
|
offer_id |
string |
|
是 |
米大師分配的offer_id |
|
ts |
number |
|
是 |
UNIX 時(shí)間戳,單位是秒 |
|
zone_id |
string |
|
是 |
游戲服務(wù)器大區(qū)id,游戲不分大區(qū)則默認(rèn)zoneId ="1",String類型。如過(guò)應(yīng)用選擇支持角色,則角色I(xiàn)D接在分區(qū)ID號(hào)后用"_"連接。 |
|
pf |
string |
|
是 |
平臺(tái) 安卓:android |
|
user_ip |
string |
|
否 |
用戶外網(wǎng) IP |
|
amt |
number |
|
是 |
扣除游戲幣數(shù)量,不能為 0 |
|
bill_no |
string |
|
是 |
訂單號(hào),業(yè)務(wù)需要保證全局唯一;相同的訂單號(hào)不會(huì)重復(fù)扣款。長(zhǎng)度不超過(guò)63,只能是數(shù)字、大小寫字母_- |
*@ |
pay_item |
string |
|
否 |
道具名稱 |
|
app_remark |
string |
|
否 |
備注。會(huì)寫到賬戶流水 |
|
sig |
string |
|
是 |
以上所有參數(shù)(含可選最多11個(gè))+uri+米大師密鑰,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
|
access_token |
string |
|
是 |
接口調(diào)用憑證 |
|
mp_sig |
string |
|
是 |
以上所有參數(shù)(含可選最多13個(gè))+uri+session_key,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
|
返回值
參數(shù) |
類型 |
說(shuō)明 |
---|
errcode |
number |
錯(cuò)誤碼 |
errmsg |
number |
錯(cuò)誤信息 |
bill_no |
string |
訂單號(hào),有效期是 48 小時(shí) |
balance |
number |
預(yù)扣后的余額 |
used_gen_balance |
number |
本次扣的贈(zèng)送幣的余額 |
errcode 的合法值
值 |
說(shuō)明 |
---|
0 |
請(qǐng)求成功 |
-1 |
系統(tǒng)繁忙,此時(shí)請(qǐng)開發(fā)者稍候再試 |
90009 |
mp_sig簽名錯(cuò)誤 |
90010 |
用戶未登錄或登錄態(tài)已過(guò)期 |
90011 |
sig簽名錯(cuò)誤 |
90012 |
訂單已存在 |
90013 |
余額不足 |
90017 |
沒(méi)有調(diào)用接口的權(quán)限 |
90018 |
參數(shù)錯(cuò)誤 |
POST 數(shù)據(jù)格式: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
開通了虛擬支付的小游戲,可以通過(guò)該接口贈(zèng)送游戲幣給某個(gè)用戶。
正式環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/present?access_token=ACCESS_TOKEN
沙箱環(huán)境
POST https://api.weixin.qq.com/cgi-bin/midas/sandbox/present?access_token=ACCESS_TOKEN
參數(shù)
參數(shù) |
類型 |
默認(rèn)值 |
是否必填 |
說(shuō)明 |
|
---|
openid |
string |
|
是 |
用戶唯一標(biāo)識(shí)符 |
|
appid |
string |
|
是 |
小程序 appId |
|
offer_id |
string |
|
是 |
米大師分配的offer_id |
|
ts |
number |
|
是 |
UNIX 時(shí)間戳,單位是秒 |
|
zone_id |
string |
|
是 |
游戲服務(wù)器大區(qū)id,游戲不分大區(qū)則默認(rèn)zoneId ="1",String類型。如過(guò)應(yīng)用選擇支持角色,則角色I(xiàn)D接在分區(qū)ID號(hào)后用"_"連接。 |
|
pf |
string |
|
是 |
平臺(tái) 安卓:android |
|
user_ip |
string |
|
否 |
用戶外網(wǎng) IP |
|
bill_no |
string |
|
是 |
訂單號(hào),業(yè)務(wù)需要保證全局唯一;相同的訂單號(hào)不會(huì)重復(fù)扣款。長(zhǎng)度不超過(guò)63,只能是數(shù)字、大小寫字母_- |
*@ |
present_counts |
number |
|
是 |
贈(zèng)送游戲幣的個(gè)數(shù),不能為0 |
|
sig |
string |
|
是 |
以上所有參數(shù)(含可選最多9個(gè))+uri+米大師密鑰,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
|
access_token |
string |
|
是 |
接口調(diào)用憑證 |
|
mp_sig |
string |
|
是 |
以上所有參數(shù)(含可選最多11個(gè))+uri+session_key,用 HMAC-SHA256簽名,詳見 米大師支付簽名算法 |
|
返回值
參數(shù) |
類型 |
說(shuō)明 |
---|
errcode |
number |
錯(cuò)誤碼 |
errmsg |
number |
錯(cuò)誤信息 |
balance |
number |
贈(zèng)送后的余額 |
bill_no |
string |
贈(zèng)送游戲幣的訂單號(hào) |
errcode 的合法值
值 |
說(shuō)明 |
---|
0 |
請(qǐng)求成功 |
-1 |
系統(tǒng)繁忙,此時(shí)請(qǐng)開發(fā)者稍候再試 |
90009 |
mp_sig簽名錯(cuò)誤 |
90010 |
用戶未登錄或登錄態(tài)已過(guò)期 |
90011 |
sig簽名錯(cuò)誤 |
90012 |
訂單已存在 |
90017 |
沒(méi)有調(diào)用接口的權(quán)限 |
90018 |
參數(shù)錯(cuò)誤 |
POST 數(shù)據(jù)格式: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"
}