卡卷特权接口API源码

• 卡券、直充接口

1、获取卡券特权数据（直充、卡券）

网关URL：https://router.wikeyun.cn/rest/Quanyi/privilege

参数名	类型	必填	参数说明
id	int	否	权益id，不传或传空字符串=全部
pro_type	int	否	产品类型，不传或传空字符串=全部，0=直充，1=卡券

响应参数：

参数名	类型	示例值	描述
code	string	0000	状态码
msg	string	获取成功	信息提示
data	array		权益列表

      data数据信息

参数名	类型	示例值	描述
id	int	1	权益id
title	string	腾讯视频
pic_url	string	权益主图url
introduce	string	会员6折起	权益简单描述
pro_type	int	0	产品类型，0=直充，1=卡券

成功返回数据格式：

{

  "code": "0000",

  "msg": "获取成功",

  "time": "1636008244",

  "data": [//权益集合列表

        {

          "id": 1,//权益自增id

          "title": "腾讯视频/QQ",//权益名称

          "pic_url": "http://b2dfdc47e670.66bbn.com/uploads/20210323/e005daa2c1e0f444fdaa3e81ab542e76.png",//权益主图url

          "introduce": "会员6折起",//权益简单描述

          "pro_type": 0 //产品类型，0=惠花直充，1=惠花卡券

        }

  ]

}

2、获取卡券、直充初始化信息（详情）（post 表单提交）

网关URL：https://router.wikeyun.cn/rest/Quanyi/getThirdProInfo

参数名	类型	必填	参数说明
store_id	string	是	店铺ID
id	string	是	权益id

响应参数：

参数名	类型	示例值	描述
code	string	0000	状态码
msg	string	获取成功	信息提示
data	array		商品详情信息

      data数据信息

参数名	类型	示例值	描述
pro_type	int	0	产品类型，0=直充，1=卡券
group_info	array		商品详情信息
g_name	string	腾讯视频	商品名称
account_type	string	QQ号	充值的账号类型，直充特有字段
xuzhi	string	官方充值。。。	使用须知
g_id	string	1	商品id
spec	array		商品规格集合
spec_title	string	腾讯视频vip会员	规格名称
spec_list	array		此规格数据列表
spec_id	string	80	规格id
title	string	腾讯视频vip会员	规格名称
times	string	7天	时长，直充特有字段
official_price	string	9.00	官方价格，划线价
cms_price	string	6.35	给平台用户的成本价
price	string	6.67	平台用户销售价（用户购买时需付款的价格）

成功返回数据格式：

{

  "code": "0000",

  "msg": "获取成功",

  "time": "1636010531",

  "data": {

    "pro_type": "0", //产品类型，0=惠花直充，1=惠花卡券

    "pro_info": {//商品详情信息

      "g_name": "腾讯视频/QQ", //商品名称

      "account_type": "QQ号（仅支持QQ号登录）",//充值的账号类型，直充特有字段

      "xuzhi": "

1.官方直充，提交QQ账号 充值秒到。充值前有确认是否可以安装腾讯视频（云视听极光），非质量问题不可退/换货，谢谢！

", //使用须知

      "g_id": "1",//商品id

      "spec": [//商品规格集合

        {

          "spec_title": "腾讯视频VIP会员", //规格名称

          "spec_list": [

            {

              "spec_id": "80",//规格id

              "title": "腾讯视频VIP会员",//规格名称

              "times": "7天",//时长，直充特有字段

              "official_price": "9.00",//官方价格（划线价）

              "cms_price": "6.35",//给平台用户的成本价

              "price": "6.67"//平台用户销售价（用户购买时需付款的价格）

            }

          ]

        }

      ]

    }

  }

}

3、卡券、直充下单（post 表单提交）

网关URL：https://router.wikeyun.cn/rest/Quanyi/saveOrder

参数名	类型	必填	参数说明
store_id	string	是	店铺ID
id	string	是	权益id
spec_id	string	是	规格id
account	string	否	需要充值的账号，直充特有字段
notify_url	string	是	回调地址

响应参数：

参数名	类型	示例值	描述
code	string	0000	状态码
msg	string	获取成功	信息提示
data	array		订单信息

      data数据信息

参数名	类型	示例值	描述
order_no	string	202111101212xxx	订单号

成功返回数据格式：

{

  "code": "0000",

  "msg": "操作成功",

  "time": "1635926032",

  "data": {

    "order_no": "2021110326033602398402" //订单号

  }

}

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

1. sign案例

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

456app_key123mobile15978771435money50notify_urlhttp://127.1.0.1order_no20216006496recharge_type1store_id1timestamp1636430302v1.0456

最终拼接完成的URL如下：https://router.wikeyun.cn/rest/Recharge/pushOrder?app_key=123×tamp=1624862089&client=127.0.0.1&format=json&v=1.0&sign=831EFFE3A7A59A530DA8CEC4A05D744

然后对上面的url 进行post传业务参数 （x-www-form-urlencoded）

附录

1、充值请求code 状态码

0000	接口成功
1003	app_key不存在
1004	业务错误，具体看msg
1005	sign签名不对
1006	timestamp Out
1007	应用已禁用
1008	余额不足
1009	相同面值太多,请拆分充值或者稍后再试

注意事项（话费快充）

1、请勿同一时间段推送大量订单。

2、请勿推送大量相同面值的订单，比如全是50，全是100，又或者50,100相间有规律的金额

3、系统会严格审核充值金额，同时出现多个金额相同的单子，就会返回1009失败，请稍后再试或者拆分提交处理。