游戲幣扣除接口

2020-02-15 00:44 更新
本接口應(yīng)在后端服務(wù)器調(diào)用

扣除游戲幣。開通小游戲支付后,可以調(diào)用該接口扣除某個用戶的游戲幣。接口調(diào)用異常,可以通過相同的訂單號再次請求該接口,不會重復(fù)扣款。

POST https://developer.toutiao.com/api/apps/game/wallet/game_pay


請求參數(shù)

屬性類型默認值是否必填說明
openidstring用戶唯一標(biāo)識
appidstring小程序唯一標(biāo)識
offer_idstring擴展字段,目前未使用,可不填
tsnumberUNIX 時間戳,單位秒
zone_idstring游戲服務(wù)器大區(qū) id,游戲不分大區(qū)則默認填寫"1"。如果應(yīng)用支持多角色,則角色 ID 接在分區(qū) ID 后,用"_"連接
pfstring平臺 安卓:android
user_ipstring用戶外網(wǎng) IP
amtnumber扣除游戲幣數(shù)量,不能為 0
bill_nostring訂單號,業(yè)務(wù)需要保證全局唯一。相同的訂單號不會重復(fù)扣款。長度不超過 63,只能是數(shù)字、大小寫字母_-
pay_itemstring道具名稱
app_remarkstring備注,會寫到賬戶流水
sigstring擴展字段,目前未使用,可不填
access_tokenstring身份驗證
mp_sigstring支付簽名,本次請求的所有非空參數(shù)+uri+支付密鑰,用 HMAC-SHA256 簽名


返回值

Object ,包含以下屬性

屬性類型說明
errcodenumber錯誤碼
errmsgstring錯誤信息
bill_nostring訂單號,有效期是 48 小時
balancenumber預(yù)扣后的余額
used_gen_amtnumber本次扣的贈送幣的金額

errcode 枚舉說明

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

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

{
  "openid": "fge35vh5h3f2",
  "appid": "tthdch45hd2df",
  "zone_id": "1",
  "mp_sig": "d1f0a41272f9b85618361323e1b19cd8cb0213f2",
  "access_token": "hds2rt6bhgh5wfg5nf4gdh6",
  "ts": 1507530737,
  "pf": "android",
  "amt": 10,
  "bill_no": 1234567890000
}
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號