服务端文档

一.签名规则

  1. 原始签名字符串

    设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
    特别注意以下重要规则：
    ◆ 参数名ASCII码从小到大排序（字典序）；
    ◆ 如果参数的值为空不参与签名；
    ◆ 参数名区分大小写；
    ◆ 传送的sign参数不参与签名，将生成的签名与该sign值作校验。
    ◆ 如果role_id,server_id是中文或包含特殊符号的情况下,需要urldecode一下,建议始终对这2个参数的值进行urldecode

  2. 拼接pay_key

    在stringA最后拼接上key[即 StringA + "&pay_key="+ pay_key ] 得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将MD5后的结果字符串转换为大写，得到sign。
           

  3. 计算MD5签名

    计算string sign=MD5(stringSignTemp),并把sign字符串转换为大写，得到sign。
           

二.玩家登录验证

  1. 接口说明

    玩家在游戏登录成功后,游戏服务端需要向我方二次校验玩家的合法性

  2. 请求URL

    http://sdk.588yyds.com/tools/gamefactor.ashx?action=factor_login

  3. 请求方式

    HTTP POST  application/x-www-form-urlencoded (即POST FROM 表单形式)


  4. 请求参数

    参数名称必填类型示例值描述
    app_id是String(16)1650e68cf57045c1我方游戏的app_id
    timestamp是String(10)173270223310位时间戳>
    uid是String(60)1-1或者1-1-1或者hord_15玩家身份id,客户端游戏端登录成功后返回的
    sign是String(32)C380BEC2BFD727A4B6845133519F3AD6签名值(大写),算法如下(把A,B,C,D替换为真实的值):MD5(app_id=A&timestamp=B&uid=C&pay_key=D)

  5. 返回参数(JSON格式)

    参数名称必填类型示例值描述
    status是Int(32)1或者0 1表示成功,0表示失败
    realname否String(64)张三玩家真实姓名
    idcard否String(64)320110200000000000玩家身份证号码
    msg       否String(64)用户不存在,请检查uid失败原因描述

  6. 返回示例数据

    成功返回:

    {"status":1}

      

    失败返回:

    {"status":0, "msg":"用户不存在 请检查uid"}

三.充值结果回调接口

  1. 接口说明

    充值成功后，将由SDK服务器（我方）向游戏服务器（你方）发起POST请求


  2. 请求URL

    游戏研发或者游戏厂商提供，如果quick出包，请在quick后台获取

  3. 请求方式

    HTTP POST  application/x-www-form-urlencoded (即POST FROM 表单形式)        

  4. 请求参数

    参数名称必填类型示例值描述
    app_id是String(16)1650e68cf57045c1我方游戏的app_id
    timestamp是String(10)173270223310位时间戳        
    uid是String(60)1-1或者1-1-1或者hordroid_15等等  玩家身份id,客户端游戏端登录成功后返回的
    cp_order_id是String(60)CPORDER123456789游戏厂商订单号,在客户端调起支付时,你方传入的订单号
    order_id是String(60)241125110055642由SDK平台生成的订单号,即我方的订单号
    order_amount是decimal(18,2)6.00订单金额,始终保留2位小数
    server_id是String(60)10001区服ID
    role_id是String(60)ZEvSaxo游戏角色ID
    extras_params否String(128)1_112_123游戏厂商下单时传递的透传参数,原样urlencode后返回此参数不参与签名
    sign是String(32)C380BEC2BFD727A4B6845133519F3AD6签名值(大写),算法如下(把A,B,C,D~I替换为真实的值): MD5(app_id=A&cp_order_id=B&order_amount=C&order_id=D
    &role_id=E&server_id=F&timestamp=G&uid=H&pay_key=I)         

  5. 你方返回示例数据

    成功返回7个大写字母:

    SUCCESS

    失败返回:

    非SUCCESS字符串