服务端接入指南


充值回调接口

接口说明

版署审核SDK为虚拟充值,不走实际的充值渠道。由SDK服务端将充值信息回调到游戏方服务端,游戏方服务端应在5秒内返回充值结果,否则将判定订单为异常订单。

接口定义

用户充值时,回调的游戏方接口,由游戏方告知充值结果

请求参数

字段 必填 数据类型 说明
orderid string SDK订单号,唯一,22位以内的字符串
p_type int 充值渠道id,约定版署审核的为1
uid unsigned int 版署审核用户uid
money int 充值金额,单位:元
gamemoney int 获得游戏币数量,兑换标准由双方共同约定
secret string secret 为 SDK服务端自动分配的通信秘钥,仅可用于服务端,请勿将其写入客户端代码中
mark string 游戏方订单号,游戏发起充值时生成唯一标识来标注该笔充值的相关信息时
time int 接口请求时间时间戳

sign签名说明

// 按顺序拼接各字段的md5值,php 示例

$sign = md5($orderid.$p_type.$uid.$money.$gamemoney.$secret.$mark.$time)

返回结果

{
    "status": 2,
    "code": null,
    "money": "1",
    "game_money": "10",
    "msg": "充值成功"
}
参数名 说明
status 1:异常
2:成功
3:失败(将钱返还给用户)
code 异常状态码,成功或失败为空。
sign_error:请求串的md5验证码错误
user_not_exist:用户账号不存在
orderid_exist:订单已提交(提交订单号必须唯一)
money_error:充值金额或兑换游戏币数量错
other_error:其他错误
money 用户充值的人民币金额,单位:元
gamemoney 用户实际兑换的游戏币的数量
msg 开发商自定义的内容(返回结果的说明等)