充值接口
一. 接口说明
-
接口例子:
http://api.gameurl.com/pay.php?p=2011121510471152443002|301362655|10|1323917231|e89f29e5d0b811195c52832269d0e22b|1|0&charge=0.999&serverid=1&user_pay_amount=1
接口地址由游戏方提供（格式可自定义），平台方只提供参数（接口例子的红色部分）
-
充值白名单ip限制:
必须设置ip限制，限制充值请求的来源ip为：115.182.52.* ip段 及 113.107.149.212、62.234.26.171、58.87.94.201
-
参数“p”的组装规则
PayNum | PayToUser | PayGold | time | flag | PayRMB | channel -
接口请求方式
需要同时支持 "GET" 和 "POST" 两种传参方式 -
该游戏为：H5类型游戏，需要注意：
*. 是否支持游戏外选服（即：指定登陆的区服，跳过游戏内的选服，直接进入游戏）。或者区服ID和游戏内服务器对应
*. 如果不支持游戏外选服并且无法区服ID对应游戏内服务器，则充值和登陆的区服ID均为：1 -
直购说明：详细说明
关于游戏内直购功能的，只需要在快捷充值面板的链接上传个mark参数给我们，充值回调的时候我们这边会回传给你们，然后根据mark字段来确认具体要发放的商品
二. 参数说明
| 参数 | 说明 | 例子 | 备注 |
|---|---|---|---|
| PayNum | 充值订单号 | 2017070709272926573 | 平台自行组装（不得重复） |
| PayToUser | 充值用户 | 1648739519 | 该值已超过21亿 （字段如果为整形 必须设置成int 无符号类型 ） |
| PayGold | 游戏币数量 | 100 | int类型 ， 游戏内游戏币按该值发放 （最后对账也是根据实际发放的游戏币值来对的） |
| PayRMB | 人民币数量 | 10 | float类型，平台实际收到的人民币数，单位：元。（该值为扣除手续费后的值，即 玩家实际充值的人民币数 - 渠道手续费） 实际金额=PayGold / 兑换比例 |
| time | UNIX时间戳 | 1499160012 | 时间戳 |
| flag | 加密签名 | uAEu6IZ4yb0lUCVRzK8sa9LWewN31p2w | 加密规则： md5(PayNum + PayToUser + PayGold + PayRMB + time + 充值接口密钥) |
| channel | 渠道 | 20 | 用户充值时，使用的渠道。敬请记录该参数，对账时可能会有需要（以数字代替具体的渠道，例如：20 表示 4399一卡通。） |
| charge | 手续费选项 | 0.9 | 表示渠道充值时，实际充值金额比率， 取值范围为：0~0.999。当应用需要确认用户实际充值金额时，可以由此参数换算得到。具体说明如下： 1.charge值为0时，表示游币直接兑换游戏币，不存在手续费 2.charge值为0.999时，表示充值渠道不收取手续费（这里可以将0.999视为1） 3.其他小数值，表示平台收到的充值金额（PayRMB)与用户实际充值金额的比率。例如：假设渠道手续费是12%， 用户充值100元，则平台实际收到88元（既参数PayRMB所传的参数）。charge的值为0.88（既88/100 = 0.88) |
| serverid | 服务器id | 1 | 区服id |
| user_pay_amount | 用户支付金额，未扣手续费 | 1 | |
| mark | 透传参数 | string |
1. 默认不会有该参数，若有需要用到请提前告知相关对接人员
2. 长度 <= 32位，且只能由数字、字母、'-'和'_' 组成的字符串。 3. 若有配置支持，游戏方有传mark参数，充值请求的时候我方会将mark字段回传给接入方 4. 因为该字段并不参与加密，有可能存在被串改的可能，接入方若有根据mark字段发放商品，请务必核对所要发放的用户和商品价值是否 PayToUser、PayGold 参数一致 5. 商品价值实际金额=PayGold / 兑换比例，必须要验证 |
三. 返回值说明
| 返回值说明 | 返回值 | 备注 |
|---|---|---|
| 充值成功 | 1 | 充值的游戏币到账 |
| 订单重复 | 2 | |
| 提交参数不全 | -1 | |
| 验证失败 | -2 | |
| 用户不存在 | -3 | 接口需要验证用户是否存在 |
| 充值比例异常 | -5 | PayGold / PayRMB > 兑换比例 / 0.5 兑换比例：游戏配置 - 联运方配置，游戏币兑换配置中的兑换比例，如1元=10元宝 则兑换比例为10 |
| 请求ip验证失败。 | -6 | 请限制充值请求的来源ip为： 115.182.52.* ip段 及 113.107.149.212、62.234.26.171、58.87.94.201 |
| 要充值的服务器不存在 | -7 | |
| 其他原因导致的充值失败 | -99 |
四. 接口测试
ERROR 403
当前状态为文档访问模式，不支持接口测试功能
相关权限开通，请联系4399相关技术人员