单机支付SDK服务器文档

1. 重要说明

本文档供支付服务器端开发使用。所有服务端接口必须接入,服务端所需【通信密钥】在游戏详细页面的SDK接入-支付SDK-配置管理】中获取。

通信密钥】在SDK申请成功后方可显示。

2. 充值回调接口

接口说明

本接口提供给开发商记录订单,方便补单处理。

接口定义

  • 接口名称:充值回调接口
  • 接口描述:用户充值成功时,手机平台将请求本接口通知游戏方进行充值
  • 接口协议:GET
  • 接口开发:游戏方

请求参数

字段 必填 数据类型 说明
orderid string (4399生成的订单号)22位以内的字符串 唯一
p_type int 充值渠道id
uid string my平台的用户uid
money float 用户充值的人民币金额,单位:元
gamemoney int 兑换的游戏币数量,兑换标准由双方共同约定,
serverid
int 要充值的服务区号(最多不超过8位)。只针对有分服的游戏有效。参数的格式为:区服id。 例如 1服 为 1, 11服为 11
mark string SDK生成的订单标识,仅用于签名验证
time int 发起请求时的时间戳
extra string 透传字段,如有需要在发起订单时设置,在回调时原封返回。
sign string 加密签名,签名计算为:$sign = md5($orderid . $uid . $money . $gamemoney . $serverid . $secret
$mark . $time.$extra); 
当参数$serverid,$mark$extra为空时,不参与签名计算。详见[签名说明]。

返回结

{
    "status":2,
    "code":null,
    "money":"1",
    "gamemoney":"10",
    "msg":"充值成功"
}

在进行第N次重新回调接口时,游戏方已成功订单必须返回成功的状态,但无需再发放游戏币。

参数名 说明
status

1:异常;

2:成功;

3:失败(将钱返还给用户)

code

异常状态码:成功或失败为空。

sign_error:请求串的md5验证码错误

user_not_exist:用户账号不存在

orderid_exist:订单已提交(提交订单号必须唯一)

money_error:充值金额或兑换游戏币数量错误,充值金额为正整数,需符合双方约定的兑换标准

other_error:其他错误

money 用户充值的人民币金额,单位:元
gamemoney 用户实际兑换的游戏币的数量
msg 开发商自定义的内容(返回结果的说明等)

3. 签名说明

参与签名的所有参数为接受到的原始参数,请不要在参与签名计算前对参数做任何处理

使用标准 MD5 算法对该字符串加密

$secrest为4399自动分配的通信秘钥,仅可用于服务端,请勿将其写入客户端代码中。

4.其他接口

敏感词检测接入文档

http://www.webgame138.com/wordmask.html