3.订单查询
版本说明:
版本号 |
日期 |
说明 |
V1.0 |
2023-04-11 |
初始版本 |
简要描述:
- 提供给接入方相关订单信息。
- 建议cp server对ulu server的ip地址进行白名单处理。
- sign签名算法,详情请见1.3 MD5的sign签名算法示例: 签名信息,根据参数名称a-z排序,将参数值拼接后+ secret(密钥) finalString,在进行md5小写加密。
接入要求:
请求URL:
请求方式:
支持方式:
参数:
参数名 |
必传 |
类型 |
说明 |
orderId |
是 |
str(50) |
ulu生成的唯一订单id |
signature |
是 |
str(32) |
签名 |
请求示例
{
"orderId":"1544990963624099842",
"signature":"db125296fead97fba019c54bcc26fbf0"
}
响应示例
成功
{
"code": 0,
"msg": "SUCCESS",
"data": {
"orderId":"1544990963624099842",
"gameId":"100000",
"goodsName":"金币",
"goodsId":"12",
"goodsNum":100,
"goodsExtraNum":5,
"appName":"2x",
"roleId":"10010"
"roleName":"안녕",
"serverId":"10011",
"serverName ":"S.10011",
"userId":"1199976566352814082",
"payDateMs":"1677148735817",
"goodsAmount":1500,
"quantity":10,
"goodsTotalPrice":15000,
"createTime":"1677148735817",
"payAmount":14900,
"goodsCurrency":"KRW",
"payStatus":1
}
}
返回参数详情
返回字段 |
字段类型 |
说明 |
orderId |
str |
订单号 |
gameId |
str |
游戏id (appid) |
goodsName |
str |
商品名称 |
goodsId |
str |
商品id |
goodsNum |
int |
商品数量 |
goodsExtraNum |
int |
商品赠送数量 |
appName |
str |
游戏名称 |
roleId |
str |
角色id |
roleName |
str |
角色名称 |
serverId |
str |
服务器id |
serverName |
str |
服务器名称 |
userId |
str |
用户uid |
payDateMs |
str |
支付时间 |
goodsAmount |
str |
商品单价 |
quantity |
int |
购买数量 |
payAmount |
str |
实付金额 |
goodsCurrency |
str |
币种 |
payStatus |
int |
0:等待支付状态,1:完成支付,2:取消支付。 |
goodsTotalPrice |
str |
商品总价 |
createTime |
str |
下单时间 |
失败
{
"code": 500,
"msg":"",
"data":null
}
响应参数说明
参数名 |
必传 |
类型 |
说明 |
示例 |
code |
是 |
int |
成功返回:0,失败返回失败码。 |
0 |
msg |
是 |
string |
成功返回"SUCCESS",失败返回失败原因 |
"SUCCESS" |