}
}
4、回调通知
参数名 | 类型 | 参数说明 |
status | string | 充值订单号 |
order_no | string | 官方订单号 |
cms_order_num | string | 对接方订单号(cms用户对接方) |
sign | string | 签名md5(app_key+app_secret+order_num) |
收到回调后,必须同步返回小写 success ,否则平台认为没有收到通知,会重复发送多次
5、卡券、直充订单列表(post 表单提交)
网关URL:https://router.wikeyun.cn/rest/Quanyi/myOrder
参数名 | 类型 | 必填 | 参数说明 |
store_id | string | 是 | 店铺ID |
page | string | 是 | 第几页 |
page_size | string | 是 | 一页显示多少条数据 |
status | string | 否 | 订单状态:传空=全部,-1=支付超时,0=未付款 ,1=已付款,2=购买充值中,3=已使用,4=失败(未退款),5=失败(已退款) |
keyword | string | 否 | 订单号或商品名模糊搜索 |
order_type | string | 否 | 订单类型:传空=全部,0=充值订单,1=卡券订单 |
g_id | string | 否 | 商品id:传空=全部,传其他id则查该商品下的订单 |
响应参数:
参数名 | 类型 | 示例值 | 描述 |
code | string | 0000 | 状态码 |
msg | string | 获取成功 | 信息提示 |
data | array | 订单信息 |
data数据信息
参数名 | 类型 | 示例值 | 描述 |
list | array | 订单列表 | |
order_no | string | 202111111111xxx | 订单号 |
cms_order_num | 对接方订单号 | ||
store_id | string | 100 | 所属店铺id |
g_id | string | 1 | 商品id |
g_name | string | 腾讯视频 | 商品名称 |
pic_url | string | http://xxx.xxx.xxx/1.jpg | 订单主图 |
spec_id | string | 80 | 规格id |
spec_title | string | 腾讯视频VIP会员 | 规格名称 |
original_price | string | 9.00 | 原价(元),官方价 |
discount_price | string | 2.33 | 优惠金额(元) |
amount | string | 6.67 | 实付金额(元) |
account | string | 138xxx | 充值账号 |
status | string | 1 | 订单状态:-1=支付超时,0=未付款 ,1=已付款,2=购买充值中,3=充值成功,4=失败(未退款),5=失败(已退款) |
order_type | string | 0 | 订单类型,0=直充订单,1=卡券订单 |
goods_card_data | array | 卡券二维码图或者卡号卡密(卡券特有字段) | |
goods或card_password | array | goods卡券二维码图、card_password卡号卡密(中间有逗号的是卡号卡密,逗号前为卡号,逗号后为卡密)(卡券特有字段) | |
original_rebate | string | 0.62 | 预估佣金(元) |
create_time | string | 1636013816 | 订单创建时间戳 |
create_time_data | string | 订单创建时间 | |
count | string | 10 | 总条数 |
成功返回数据格式:
{
"code": "0000",
"msg": "获取成功",
"time": "1636077180",
"data": {
"list": [
{
"order_no": "2021110413816751213217", //订单号
"cms_order_num": "", //对接方订单号
"store_id": "1",
"g_id": "1", //商品id
"g_name": "腾讯视频/QQ", //商品名称
"pic_url": "", //主图
"spec_id": "80", //规格id
"spec_title": "腾讯视频VIP会员", //规格名称,如:腾讯视频vip会员
"original_price": "9.00", //原价(元),官方价
"discount_price": "2.33", //优惠金额(元)
"amount": "6.67", //实付金额(元)
"account": "13888888888", //充值账号
"status": "1", //订单状态:-1=支付超时,0=未付款 ,1=已付款,2=购买充值中,3=充值成功,4=失败(未退款),5=失败(已退款)
"order_type": "0", //订单类型,0=直充订单,1=卡券订单
"goods_card_data": [ //卡券二维码图或者卡号卡密
{
"goods": "http://b2dfdc47e670.66bbn.com/uploads/20210323/c96a819c8d37e1252014a9fd0929059d.png"
}
],
"original_rebate": "0.62", //预估佣金
"create_time": "1636013816", //订单创建时间戳
"create_time_data": "2021-11-04 16:16:56" //订单创建时间
}
],
"count": "1" //总条数
}
}
6、卡券、直充订单详情(post 表单提交)
网关URL:https://router.wikeyun.cn/rest/Quanyi/orderDetail
参数名 | 类型 | 必填 | 参数说明 |
store_id | string | 是 | 店铺ID |
order_no | string | 是 | 官方订单号 (和外部对接方订单号选择传一个) |
cms_order_num | string | 是 | 对接方订单号 |
响应参数:
参数名 | 类型 | 示例值 | 描述 |
code | string | 0000 | 状态码 |
msg | string | 获取成功 | 信息提示 |
data | array | 订单信息 |
data数据信息
参数名 | 类型 | 示例值 | 描述 |
order_no | string | 202111111111xxx | 订单号 |
cms_order_num | 对接方订单号 | ||
store_id | string | 100 | 所属店铺id |
g_id | string | 1 | 商品id |
g_name | string | 腾讯视频 | 商品名称 |
pic_url | string | http://xxx.xxx.xxx/1.jpg | 订单主图 |
spec_id | string | 80 | 规格id |
spec_title | string | 腾讯视频VIP会员 | 规格名称 |
original_price | string | 9.00 | 原价(元),官方价 |
discount_price | string | 2.33 | 优惠金额(元) |
amount | string | 6.67 | 实付金额(元) |
account | string | 138xxx | 充值账号 |
status | string | 1 | 订单状态:-1=支付超时,0=未付款 ,1=已付款,2=购买充值中,3=充值成功,4=失败(未退款),5=失败(已退款) |
order_type | string | 0 | 订单类型,0=直充订单,1=卡券订单 |
goods_card_data | array | 卡券二维码图或者卡号卡密(卡券特有字段) | |
goods或card_password | array | goods卡券二维码图、card_password卡号卡密(中间有逗号的是卡号卡密,逗号前为卡号,逗号后为卡密)(卡券特有字段) | |
original_rebate | string | 0.62 | 预估佣金(元) |
create_time | string | 1636013816 | 订单创建时间戳 |
成功返回数据格式:
{
"code": "0000",
"msg": "获取成功",
"time": "1636953779",
"data": {
"order_no": "2021111112499848902906", //官方订单号
"cms_order_num": "1223456789", //对接方订单号
"store_id": "1", //店铺id
"g_id": "30", //商品id
"g_name": "饿了么会员", //商品名称
"pic_url": "http://b2dfdc47e670.66bbn.com/uploads/20210323/3bf83e87ea510292989da5147d30f025.png", //权益主图
"spec_id": "101", //规格id
"spec_title": "超级吃货卡", //规格名称(接口方),如:腾讯视频vip会员
"original_price": "15.00", //原价(元),官方价
"discount_price": "5.03", //优惠金额(元)
"amount": "9.97", //实付金额(元)
"account": "13888888888", //充值账号
"status": "5", //订单状态:-1=支付超时,0=未付款 ,1=已付款,2=购买充值中(第三方支付成功),3=充值成功,4=失败(未退款),5=失败(已退款)
"order_type": "0", //订单类型,0=充值订单,1=卡券订单
"goods_card_data": [//卡券二维码图或者卡号卡密
{
"card_password": "cdJI56d45SIujelkdffoLS" //订单创建时间
}
],
"original_rebate": "0.00", //预估佣金
"create_time": "1636612499" //订单创建时间戳
}
}
- 签名算法
1、系统参数:
以下参数必须传参,全部采用get传参(拼接至url内),系统参数包括:
参数名 | 类型 | 参数说明 |
app_key | 字符串 | 应用唯一表示 |
timestamp | 字符串 | unix时间戳(秒单位) |
client | 字符串 | 客户端请求ip |
v | 字符串 | 客户端接口版本,目前是1.0 |
format | 字符串 | 默认json |
sign | 字符串 | sign签名 |
2、sign签名算法
把业务参数+系统参数合并成一个数组,然后对数组进行ksort排序(按ASCII由小到大排序),然后对合并后的数组进行循环拼接,格式如下:key1value1key2value2key3value3的形式拼接,最终首尾各拼接一个app_secret,对最终字符串进行md5大写加密。
- sign案例
以话费下单为例,假设appkey=123 , app_secret=456
456app_key123mobile15978771435money50notify_urlhttp://127.1.0.1order_no20216006496recharge_type1store_id1timestamp1636430302v1.0456
然后对上面的url 进行post传业务参数 (x-www-form-urlencoded)