新版充值接口

一. 接口说明

  • 接口例子:

    http://api.gameurl.com/pay

    接口地址由游戏方提供（格式可自定义），平台方只提供参数

  • 充值白名单ip限制:

    必须设置ip限制，限制充值请求的来源ip为：62.234.26.171、58.87.94.201、82.157.188.16、101.43.150.183

  • 接口请求方式
    需要同时支持 "GET" 和 "POST" 两种传参方式
  • 该游戏为：H5类型游戏，需要注意：

    *. 是否支持游戏外选服（即：指定登陆的区服，跳过游戏内的选服，直接进入游戏）。或者区服ID和游戏内服务器对应
    *. 如果不支持游戏外选服并且无法区服ID对应游戏内服务器，则充值和登陆的区服ID均为：1

二. 参数说明

参数 类型 备注
order string 充值订单号
game_union int 游戏的充值ID（每个游戏唯一充值标识）
uid int

4399uid（登录接口中的username），该值已超过21亿 （可使用bigint）
username string 4399用户名（登录接口中的account）
money Decimal 用户实际支付金额（人名币，单位为元，折扣后的金额）
type_id int 支付渠道ID, 如需更多具体值找4399技术。54：微信H5支付、71：支付宝H5支付、111：微信扫码支付、132：支付宝扫码支付
mark string

透传参数

，游戏订单标识（最多128位，仅支持数字、大小写字母、_、-、|）
pay_time string 订单支付时间(格式为 yyyy-MM-dd HH:mm:ss 例如：2015-04-27 15:45:57)
v string (版本号，目前固定为 v2)
sign string

加密字符串, 构造方式如下:

1: 将 order,uid,money,key,type_id,mark 按顺序拼接得到字符串A

2: 将 对A进行base64转码得到 字符串B

3: 将 字符串B,进行md5加密，得到字符串C

4: 从C字符串，第1位开始取，总取16位，得到字符串 sign， 例如C=123456789abcdefghijklmn123456789，得到的sign=23456789abcdefgh

game_amount Decimal 游戏币，实际支付金额*游戏币的兑换比例
server int 游戏服ID

三. 返回值说明

返回值说明 返回值 备注
充值成功 success 固定字符串
订单重复 2
提交参数不全 -1
验证失败 -2
用户不存在 -3 接口需要验证用户是否存在
请求ip验证失败。 -6 请限制充值请求的来源ip为： 62.234.26.171、58.87.94.201、82.157.188.16、101.43.150.183
要充值的服务器不存在 -7
其他原因导致的充值失败 -99

四. 接口测试

ERROR 403

当前状态为文档访问模式，不支持接口测试功能

相关权限开通，请联系4399相关技术人员