【微客云】直冲卡券接口源码

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大写加密。

1. sign案例

以话费下单为例，假设appkey=123 , app_secret=456

456app_key123mobile15978771435money50notify_urlhttp://127.1.0.1order_no20216006496recharge_type1store_id1timestamp1636430302v1.0456