查询余额接口
目录 |
1. 功能说明
获取用户游戏币余额
移动端的应用，按照游戏币的充值数量进行结算，每月结算时依据当月玩家游戏币的充值总量进行分成。
2. 调用说明
2.1 URL地址
【现网】https://openapi.tencentyun.com/mpay/get_balance_m
【沙箱】http://119.147.19.43/mpay/get_balance_m
2.2 请求参数
| Cookie里面需要包含的参数： |
|---|
| 参数名 | 参数说明 |
|---|---|
| session_id | 用户账户类型，session_id =“openid”(固定传“openid”，不是传openid值) |
| session_type | session类型，session_type = “kp_actoken”(固定传”kp_actoken”，不是传kp_actoken值) |
| org_loc | 需要填写: /mpay/get_balance_m |
| appip | （可选）来源的第三方应用的服务IP |
注意：cookie里面参数的值，需要进行urlencode
| 请求参数： |
|---|
| 参数名 | 参数说明 |
|---|---|
| openid | 从手Q登录态中获取的openid的值 |
| openkey | 从手Q登录态中获取的access_token 的值 |
| pay_token | 从手Q登录态中获取的pay_token的值 |
| appid | 应用的唯一ID。可以通过appid查找APP基本信息。这个appid在数值上和支付ID也就是客户端设置的offerid是相同的 |
| ts | UNIX时间戳（从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数）。 |
| sig | 请求串的签名（可以参考下面具体示例，或者到 OpenApi签名验证工具 验证签名）。 |
| pf | 平台来源，平台-注册渠道-系统运行平台-安装渠道-业务自定义。 例如： qq_m_qq-10000144-android-10000144-xxxx |
| pfkey | 登录时候获取，跟平台来源和openkey根据规则生成的一个密钥串。注：腾讯公司自己研发的应用固定传 pfkey="pfkey" |
| zoneid | 账户分区ID_角色。每个应用都有一个分区ID为1的默认分区，分区可以在cpay.qq.com/mpay上自助配置。如过应用选择支持角色，则角色接在分区ID号后用"_"连接，角色需要进行urlencode。 注意：如果游戏PC端和移动端是游戏币互通模式，zoneid 的数值保持和PC侧接入支付时传递的一致。例如，游戏A在PC上运行是接入过支付，PC上有分区0和分区1，再接入移动支付是要求移动端账户和PC端账户互通，那么接入移动支付时，zoneid根据需要由业务自己传递PC上配置的分区ID，对0分区操作就传0，对1分区操作就传1 |
| userip | （可选）用户的外网IP |
| accounttype | （可选）帐户类型ID， 基础货币（common）， |
| format | （可选）json、jsonp_$func。默认json。如果jsonp，前缀为：$func 例如：format=jsonp_sample_pay，返回格式前缀为：sample_pay() |
2.3 请求示例
示例：（仅演示sig生成使用）
Appkey: Lf6AtMEB1QlE8BYS&
method:GET
url_path: /mpay/get_balance_m
[openid] => F11669C63D76BAB0BC2F6CC869B19E53
[openkey] => 3968DD5F3F14427EF103A05E00AB59B4
[pf] => desktop_m_qq-10000144-android-2002-
[pfkey] => 5971dce2d3035669e49a1496d590f1ba
[pay_token] => 6554E0A9225B05A1CE4C4AF215A8C369
[ts] => 1396522716
[zoneid] => 1
[format] => json
[appid] => 1101255891
把参数按规则排序后组装：
GET&%2Fmpay%2Fget_balance_m&appid%3D1101255891%26format%3Djson%26openid%3DF11669C63D76BAB0BC2F6CC86
9B19E53%26openkey%3D3968DD5F3F14427EF103A05E00AB59B4%26pay_token%3D6554E0A9225B05A1CE4C4AF215A8C36
9%26pf%3Ddesktop_m_qq-10000144-android-2002-%26pfkey%3D5971dce2d3035669e49a1496d590f1ba%26ts%3D139
6522716%26zoneid%3D1
请求串：
http://119.147.19.43/mpay/get_balance_m?openid=F11669C63D76BAB0BC2F6CC869B19E53&
openkey=3968DD5F3F14427EF103A05E00AB59B4&pf=desktop_m_qq-10000144-android-2002-&pfkey=5971dce2d30
35669e49a1496d590f1ba&pay_token=6554E0A9225B05A1CE4C4AF215A8C369&ts=1396522716&zoneid=1&format=js
on&appid=1101255891&sig=w0swu02BmhUPQyrAiS%2BpwuRgCcI%3D
2.4 返回参数说明
示例：
| ret | 返回码 | |
|---|---|---|
| 0 | 成功 | |
| 1001 | 参数错误 | |
| 1018 | 登陆校验失败 | |
| 其它 | 失败 | |
| balance | 游戏币个数（包含了赠送游戏币） | |
| gen_balance | 赠送游戏币个数 | |
| first_save | 是否满足首次充值，1：满足，0：不满足 | |
| save_amt | 累计充值金额 |
2.5 返回示例
正确返回示例
Content-type: text/html; charset=utf-8
{"ret":0,"balance":200,"gen_balance":0,"first_save":1,"save_amt":200}
错误返回示例
Content-type: text/html; charset=utf-8
{"ret":1018,"msg":"请先登录"}
以上信息是否解决您的问题？