微信小程序虛擬支付（米大師）支付接口大全的使用說明

日期：2018-04-25　作者：管理員　來源：本站

微信小程序虛擬支付（米大師）支付接口大全的使用說明【微信小程序支付系統(tǒng)定制開發(fā)電話】midasCancelPay接口：開通了虛擬支付的小游戲，若扣除游戲幣的訂單號在有效時(shí)間內(nèi)，可以通過本接口取消該筆扣除游戲幣的訂單。midasGetBalance接口：開通了虛擬支付的小游戲，可以通過本接口查看某個(gè)用戶的游戲幣余額。midasPay接口：開通了虛擬支付的小游戲，可以通過本接口扣除某個(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接口：開通了虛擬支付的小游戲，可以通過該接口贈(zèng)送游戲幣給某個(gè)用戶。

微信小程序虛擬支付（米大師）支付接口大全的使用說明【微信小程序支付系統(tǒng)定制開發(fā)電話：400-000-1280】midasCancelPay接口：開通了虛擬支付的小游戲，若扣除游戲幣的訂單號在有效時(shí)間內(nèi)，可以通過本接口取消該筆扣除游戲幣的訂單。midasGetBalance接口：開通了虛擬支付的小游戲，可以通過本接口查看某個(gè)用戶的游戲幣余額。

微信小程序虛擬支付（米大師）支付接口大全的使用說明【微信小程序支付系統(tǒng)定制開發(fā)電話：400-000-1280】

wx.requestMidasPayment(Object object)

發(fā)起米大師支付

參數(shù)

Object object

屬性	類型	默認(rèn)值	是否必填	說明
mode	string		是	支付的類型，不同的支付類型有各自額外要傳的附加參數(shù)。
env	number	0	否	環(huán)境配置
offerId	string		是	在米大師側(cè)申請的應(yīng)用 id
currencyType	string		是	幣種
platform	string		否	申請接入時(shí)的平臺(tái)，platform 與應(yīng)用id有關(guān)。
buyQuantity	number		否	購買數(shù)量。mode=game 時(shí)必填。購買數(shù)量。詳見 buyQuantity 限制說明。
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 的合法值

值	說明
game	購買游戲幣

object.env 的合法值

值	說明
0	米大師正式環(huán)境
1	米大師沙箱環(huán)境

object.currencyType 的合法值

值	說明
CNY	人民幣

object.platform 的合法值

值	說明
android	android

fail 回調(diào)函數(shù)

參數(shù)

Object res

屬性	類型	說明	支持版本
errMsg	string	錯(cuò)誤信息
errCode	number	錯(cuò)誤碼

res.errCode 的合法值

值	說明
-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ā)起了一筆支付請求
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 限制說明

購買游戲幣的時(shí)候，buyQuantity 不可任意填寫。需滿足 buyQuantity * 游戲幣單價(jià) = 限定的價(jià)格等級。如：游戲幣單價(jià)為 0.1 元，一次購買最少數(shù)量是 10。

有效價(jià)格等級如下：

價(jià)格等級（單位：人民幣）
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

開通了虛擬支付的小游戲，若扣除游戲幣的訂單號在有效時(shí)間內(nèi)，可以通過本接口取消該筆扣除游戲幣的訂單

正式環(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ù)	類型	是否必填	說明
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類型。如過應(yīng)用選擇支持角色，則角色I(xiàn)D接在分區(qū)ID號后用"_"連接。
pf	string	是	平臺(tái) 安卓：android
user_ip	string	否	用戶外網(wǎng) IP
bill_no	string	是	訂單號，業(yè)務(wù)需要保證全局唯一；相同的訂單號不會(huì)重復(fù)扣款。長度不超過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ù)	類型	說明
errcode	number	錯(cuò)誤碼
errmsg	number	錯(cuò)誤信息
bill_no	string	扣除游戲幣的訂單號

errcode 的合法值

值	說明
0	請求成功
-1	系統(tǒng)繁忙，此時(shí)請開發(fā)者稍候再試
90000	訂單不存在
90009	mp_sig簽名錯(cuò)誤
90010	用戶未登錄或登錄態(tài)已過期
90011	sig簽名錯(cuò)誤
90014	訂單已支付確認(rèn)完成，不允許當(dāng)前操作
90015	訂單已回退，不允許當(dāng)前操作
90016	訂單處理中
90017	沒有調(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

開通了虛擬支付的小游戲，可以通過本接口查看某個(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ù)	類型	是否必填	說明
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類型。如過應(yīng)用選擇支持角色，則角色I(xiàn)D接在分區(qū)ID號后用"_"連接。
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ù)	類型	說明
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 的合法值

值	說明
0	請求成功
-1	系統(tǒng)繁忙，此時(shí)請開發(fā)者稍候再試
90009	mp_sig簽名錯(cuò)誤
90010	用戶未登錄或登錄態(tài)已過期
90011	sig簽名錯(cuò)誤
90017	沒有調(diào)用接口的權(quán)限
90018	參數(shù)錯(cuò)誤

first_save 的合法值

值	說明
1	滿足
2	不滿足

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

開通了虛擬支付的小游戲，可以通過本接口扣除某個(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ù)	類型	是否必填	說明
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類型。如過應(yīng)用選擇支持角色，則角色I(xiàn)D接在分區(qū)ID號后用"_"連接。
pf	string	是	平臺(tái) 安卓：android
user_ip	string	否	用戶外網(wǎng) IP
amt	number	是	扣除游戲幣數(shù)量，不能為 0
bill_no	string	是	訂單號，業(yè)務(wù)需要保證全局唯一；相同的訂單號不會(huì)重復(fù)扣款。長度不超過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ù)	類型	說明
errcode	number	錯(cuò)誤碼
errmsg	number	錯(cuò)誤信息
bill_no	string	訂單號，有效期是 48 小時(shí)
balance	number	預(yù)扣后的余額
used_gen_balance	number	本次扣的贈(zèng)送幣的余額

errcode 的合法值

值	說明
0	請求成功
-1	系統(tǒng)繁忙，此時(shí)請開發(fā)者稍候再試
90009	mp_sig簽名錯(cuò)誤
90010	用戶未登錄或登錄態(tài)已過期
90011	sig簽名錯(cuò)誤
90012	訂單已存在
90013	余額不足
90017	沒有調(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

開通了虛擬支付的小游戲，可以通過該接口贈(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ù)	類型	是否必填	說明
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類型。如過應(yīng)用選擇支持角色，則角色I(xiàn)D接在分區(qū)ID號后用"_"連接。
pf	string	是	平臺(tái) 安卓：android
user_ip	string	否	用戶外網(wǎng) IP
bill_no	string	是	訂單號，業(yè)務(wù)需要保證全局唯一；相同的訂單號不會(huì)重復(fù)扣款。長度不超過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ù)	類型	說明
errcode	number	錯(cuò)誤碼
errmsg	number	錯(cuò)誤信息
balance	number	贈(zèng)送后的余額
bill_no	string	贈(zèng)送游戲幣的訂單號

errcode 的合法值

值	說明
0	請求成功
-1	系統(tǒng)繁忙，此時(shí)請開發(fā)者稍候再試
90009	mp_sig簽名錯(cuò)誤
90010	用戶未登錄或登錄態(tài)已過期
90011	sig簽名錯(cuò)誤
90012	訂單已存在
90017	沒有調(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"
 }

掃二維碼手機(jī)查看該文章

TAG標(biāo)簽 微信支付接口 小程序支付接口 小游戲支付接口

當(dāng)前網(wǎng)址：http://yngytx.cn/wechat/550.html

上一篇：微信小游戲防沉迷系統(tǒng)最新技術(shù)文檔
下一篇：最新微信小游戲圈接口開發(fā)文檔

微信小程序虛擬支付（米大師）支付接口大全的使用說明

wx.requestMidasPayment(Object object)

參數(shù)

Object object

fail 回調(diào)函數(shù)

參數(shù)

Object res

buyQuantity 限制說明

midasCancelPay

正式環(huán)境

沙箱環(huán)境

參數(shù)

返回值

POST 數(shù)據(jù)格式：JSON

midasGetBalance

正式環(huán)境

沙箱環(huán)境

參數(shù)

返回值

POST 數(shù)據(jù)格式：JSON

midasPay

正式環(huán)境

沙箱環(huán)境

參數(shù)

返回值

POST 數(shù)據(jù)格式：JSON

midasPresent

正式環(huán)境

沙箱環(huán)境

參數(shù)

返回值

POST 數(shù)據(jù)格式：JSON

相關(guān)資訊