# 拉取余额接口

# 接口URL

测试环境 https://test.creativity.qq.com:9311/getbalance

# 接口GET参数(必填)

appid:MOGS分配的appid

app_plat:平台类型, 1.微信 2.QQ 3.PC,目前仅支持微信,填 1

openid:用户openid

js_code: 自定义登陆态

# 接口字段说明 (POST数据)

# 请求描述

参数 类型 是否必填 描述
os_plat_id int32 ios还是android,目前仅支持android,填 1
session_key string 手Q需要填,小程序登录的 sessionkey

# 请求返回描述

参数 类型 描述
ret int 返回值 (0-成功 其他-失败)
errmsg string 错误信息,如果成功返回 "ok"
balance int 游戏币个数(包含赠送)
gen_balance int 赠送游戏币数量
is_first bool 是否满足历史首次充值
save_amt int 累计充值金额的游戏币数量
save_sum int 历史总游戏币金额
cost_sum int 历史总消费游戏币金额
present_sums int 历史累计收到赠送金额

# 调用示例

curl -X POST -d '{"os_plat_id": 1}' 'https://test.creativity.qq.com:9311/getbalance?appid=10000&app_plat=1&openid=opvxI4y_cVJx2pxsFCQrJ4FZB5gk&js_code=xxx'
1

# 扣游戏币接口

# 接口URL

测试环境 https://test.creativity.qq.com:9311/pay

# 接口GET参数(必填)

appid:MOGS分配的appid

app_plat:平台类型, 1.微信 2.QQ 3.PC,目前仅支持微信,填 1

openid:用户openid

js_code: 自定义登陆态

# 接口字段说明 (POST数据)

# 请求描述

参数 类型 是否必填 描述
os_plat_id int ios还是android,目前仅支持android,填 1
bill_no string 订单号,防止重复扣除。如果不填,服务器生成一个。强烈建议业务自己传入订单号,网络情况不好的情况下相同订单号不会重复扣款
pay_item string 记录用,无任何逻辑,可传可不传
amt int 扣除的游戏币数量
session_key string 手Q需要填,小程序登录的 sessionkey

# 请求返回描述

参数 类型 描述
ret int 返回值 (0-成功 其他-失败)
errmsg string 错误信息,如果成功返回 "ok"
balance int 余额
bill_no int 订单号,有效期是 48 小时
used_gen_amt int 本次扣的赠送币的金额

# 调用示例

curl -X POST -d '{"os_plat_id": 1, "amt": 10}' 'https://test.creativity.qq.com:9311/pay?appid=10000&app_plat=1&openid=opvxI4y_cVJx2pxsFCQrJ4FZB5gk&js_code=xxx'
1

# 取消支付接口

# 接口URL

测试环境 https://test.creativity.qq.com:9311/cancelpay

# 接口GET参数(必填)

appid:MOGS分配的appid

app_plat:平台类型, 1.微信 2.QQ 3.PC,目前仅支持微信,填 1

openid:用户openid

js_code: 自定义登陆态

# 接口字段说明 (POST数据)

# 请求描述

参数 类型 是否必填 描述
os_plat_id int ios还是android,目前仅支持android,填 1
bill_no string 取消的订单号
pay_item string 记录用,无任何逻辑,可传可不传
session_key string 手Q需要填,小程序登录的 sessionkey

# 请求返回描述

参数 类型 描述
ret int 返回值 (0-成功 其他-失败)
errmsg string 错误信息,如果成功返回 "ok"
bill_no int 订单号

# 调用示例

curl -X POST -d '{"os_plat_id": 1, "bill_no": "11111"}' 'https://test.creativity.qq.com:9311/cancelpay?appid=10000&app_plat=1&openid=opvxI4y_cVJx2pxsFCQrJ4FZB5gk&js_code=xxx'


# 赠送游戏币接口

### 接口URL

测试环境 https://test.creativity.qq.com:9311/present

### 接口GET参数(必填)
appid:MOGS分配的appid

app_plat:平台类型, 1.微信 2.QQ 3.PC,目前仅支持微信,填 1

openid:用户openid

js_code:	自定义登陆态

### 接口字段说明 (POST数据)
#### 请求描述
| 参数          | 类型 | 是否必填 |     描述      |
| ------------- | ---- |--| -------------------------------------- |
| os_plat_id          | int32       | 是 |ios还是android,目前仅支持android,填 1 |
| bill_no             | string      | 否 |订单号,防止重复扣除。如果不填,服务器生成一个。强烈建议业务自己传入订单号,网络情况不好的情况下相同订单号不会重复扣款 |
| amt                 | int         | 是 |赠送的游戏币数量,必须大于0 |
| session_key         | string      | 否 | 手Q需要填,小程序登录的 sessionkey  |

#### 请求返回描述
| 参数          | 类型  |   描述      |
| ----------      | -------- |--------------------------- |
| ret             | int     |返回值 (0-成功 其他-失败) |
| errmsg          | string  |错误信息,如果成功返回 "ok" |
| balance         | int     |余额 |
| bill_no         | int     |订单号,有效期是 48 小时 |


### 调用示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

curl -X POST -d '{"os_plat_id": 1, "amt": 10}' 'https://test.creativity.qq.com:9311/present?appid=10000&app_plat=1&openid=opvxI4y_cVJx2pxsFCQrJ4FZB5gk&js_code=xxx'