新充值面板
一. 网页说明
-
网页例子:
https://my.4399.com/webgame/home/pay?app=&username=4399厦门充值测试&money=1&server_id=1&mark=mark123&goods=游戏商品名称&time=xxxxx&nonce=xxxxx&sign=xxxxxxxx&isPc=0
网页地址由平台方提供(格式可自定义),游戏方只提供参数(网页例子的红色部分)
-
网页说明:
游戏内点击“充值”时弹出该页面,页面大小自适应。
游戏内弹出充值页面由游戏方自行自做弹窗以及关闭弹窗功能。
二. 参数说明
| 参数 | 说明 | 例子 | 备注 |
|---|---|---|---|
| app | 游戏key |
必须,固定字符串,由4399提供,严禁修改, 修改后无法正确获取折扣。 |
|
| username | 4399平台账号 | 4399厦门充值测试 | 必须,4399平台账号(登录接口中的 account 字段, 非 username 字段) |
| money | 商品的金额 | 50 |
必须,默认选择填写的商品金额 |
| server_id | 服务器id | 1 | 必须,服务器id,(登录接口中serverid 字段) 必须是存在且4399这边已经配置好的服务器 |
| mark | 透传参数 | string |
必须:最多128位,仅支持数字、大小写字母、_、-、| 游戏方有传mark参数,充值请求的时候我方会将mark字段回传给接入方 |
| goods | 游戏商品名称 | 商品名称 | |
| time | 时间戳(秒) | 1770175161 | |
| nonce | 随机字符串(32位) | xxxxxxxxxx | 例子:php:md5(uniqid(mt_rand(), true)) |
| sign | 加密参数 | xxxxxxxxxx |
如果无服务端加密请提前说明 必须:md5(app+urlencode(username)+money+server_id+mark+urlencode(goods)+time+nonce+秘钥),秘钥为平台配置中的其他接口秘钥 |
| isPc | 是否pc端 | 1 |
必须: |
三. 返回值说明
| 返回值说明 | 弹窗状态 | 备注 |
|---|---|---|
| 正确返回 | 无弹窗 | PC充值过程是通过扫码完成的,手机调用微信或者支付宝支付 |
| 错误返回 | 页面内下单时会吐司相关错误信息! | 检查传递参数是否错误,app、username、server_id、money、mark必传 |
四. 示例展示
| 步骤 | 说明 | 备注 |
|---|---|---|
| 1 | 用户点击充值按钮 | |
| 2 | 游戏内弹窗快捷充值的页面 | 页面的地址,由游戏方自行拼接 |
| 3 | 页面没有关闭功能,需要游戏方自己提供关闭的功能 |