怎么理解卡卷会员接口

现在我们生活中的卡券非常非常多，因为卡券接口的存在，我们常见的加油卡、话费充值卡、各大商城购物卡、影视会员卡充值等等都是能见到卡券形式。

卡券API接口为我们实现了这种线上线下交易方式，不仅安全可靠，且操作简单，让你快速变现。

1、卡券接口就是进入公众号,系统默认识别当前城市的位置,如果没有显示正确请更改,当显示为所在城市,系统自动推荐当前城市范围内的热门商家。能直接打开,当然你还可以根据需要点击上面的商家分类,通过分类筛选你只需要的商家。

2、下单后可以在“我的”输入商品名称找到对应商品输入卡密兑换，简单易操作。

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如下：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失败，请稍后再试或者拆分提交处理。