【最新】视频平台会员权益接口分享

―、引言

1. 文档概述

本文档提供会员权益接口规范说明，提供一整套的完整的接入示例(http 接口)供商户参 考，可以帮助商户开发人员快速完成接口开发与联调，实现与系统的交易互联。

公司官网：http://www.wikeyun.cn/

1. 阅读对象

本文阅读对象：开发人员与微客云系统对接支付相关的技术人员。

1. 业务流程
2. 打开控制台 https://control.wikeyun.cn/ 进行注册账号
3. 点击添加店铺，只勾选CMS即可，或者店铺ID保存。
4. 联系客服申请 app_key与app_secret 。
5. 开发对接，需求在控制台进行预存。

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": "<p>1.官方直充，提交QQ账号 充值秒到。充值前有确认是否可以安装腾讯视频（云视听极光），非质量问题不可退/换货，谢谢！</p>", //使用须知 "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 ,否则平台认为没有收到通知,会重复发送多次