2.发货通知

版本说明：

版本号 日期 说明
V1.0 2023-03-16 初始版本

简要描述：

  • 玩家在完成充值后,ulu server会按照此接口协议向游戏提供的地址POST数据（简称为发货通知），通知接入方进行发货。
  • 接入方在收到请求后应验证相关信息并向玩家发送道具。
  • 接入方应判断是否重复发放道具。
  • 接入方在接收并处理成功后应即时进行响应，当响应的code码=0时，ulu server将不再通知，否则平台将进入补单流程.
  • 补单流程会在订单完成后的若干时间范围内进行重新进行请求。
  • 建议cp server对ulu server的ip地址进行白名单处理。
  • sign签名算法，详情请见1.3 MD5的sign签名算法示例： 签名信息，根据参数名称a-z排序，将参数值拼接后+ secret(密钥) finalString，在进行md5小写加密。

接入要求：

  • 必接

请求URL：

  • 接入方提供

请求方式：

  • POST

支持方式：

  • applicaton/json

参数：

参数名 必传 类型 说明
orderId 是 str(50) ulu生成的唯一id
gameId 是 int(10) ulu与接入方定义的游戏id
extraData 是 str(500) 角色信息返回的透传参数
uluServerEnv 是 int(1) 请求发起的ulu服务器环境： 0:正式环境，1:非正式环境
roleId 是 str(255) 角色id
roleName 是 str(255) 角色名
serverId 是 str(255) 服务器id
serverName 是 str(255) 服务器名
userId 是 str(50) 用户在ulu的唯一id
payDateMs 是 int(20) 购买时间，毫秒值时间戳
goodsAmount 是 str(20) 商品单价金额,随着商品固定不变,建议用作比对参数。
quantity 是 int(5) 购买数量
payAmount 是 str(20) 实际支付金额,不固定,不建议用作比对参数。
goodsCurrency 是 str(3) 商品币种
goodsId 是 str(100) 游戏方提供的商品id
goodsName 是 str(255) 商品名称
goodsNum 是 int(11) 商品内容包含的基本数量
goodsExtraNum 是 int(11) 商品内容包含的额外赠送数量
signature 是 str(32) 签名

请求示例

{
    "orderId":"1544990963624099842",
    "gameId":"100000",
    "extraData":"",
    "uluServerEnv":1,
    "roleId":"10011111",
    "roleName":"안녕",
    "serverId":"10011",
    "serverName ":"S.10011",
    "userId":"1199976566352814082",
    "payDateMs":"1677148735817",
     "goodsAmount":1500,
    "quantity":10,
    "payAmount":14900,
    "goodsCurrency":"KRW",
    "goodsId":"8999",
    "goodsName":"钻石",
    "goodsNum":100,
    "goodsExtraNum":5,
    "signature":"db125296fead97fba019c54bcc26fbf0"
}

响应示例

成功

{
    "code": 0，
    "msg":"SUCCESS"
 }

失败

{
    "code": 500，
    "msg":"roleId does not exist"
 }

响应参数说明

参数名 必传 类型 说明 示例
code 是 int 成功返回：0，失败返回失败码。 0
msg 是 string 成功返回"SUCCESS",失败返回失败原因 "SUCCESS"

results matching ""

    No results matching ""