话费电费中控搭建,api接口h5，公众号，小程序app

应用场景：
1、传统的虚拟商品分销，如话费、水电费、油卡费、游戏点卡、视频会员、各类虚拟电子券的分销
2、虚拟商品对接电商平台的销售，如对接淘宝、拼多多等平台做虚拟商品相关的销售，譬如：话费、电费、视频会员、电子教程等，虚拟商品不用发实体货物，可以轻松实现自动化赚钱。
3、粉丝变现，虚拟商品都是常见的虚拟消费品，通过平台可以把抖音、微信公众号等粉丝流量快速变现
4、营销推广，系统可以从以下两方面来实现营销推广：
a、利用虚拟商品实现拉新
b、利用发行优惠券等功能实现增流
5、其余可归纳为相似虚拟商品交易行为的功能实现，如：在线进行号码卡的推广销售，支付宝在线转账等。
系统优势
1、全新的架构，让系统解决能力更加安全强大，服务器配置要求不高，降低了使用成本。
2、全新设计的功能框架，使用了插件式的结构，需要什么功能安装什么，告别了冗余和累赘，使系统变得更加简洁。
3、商品设置更加灵活，可以通过规格设置自由组合出各种虚拟商品的设置
4、订单管理及相关设置更加友好
5、功能实现在线安装，客户可自行安装

话费充值接口文档
接口版本：1.0

―、引言
1.1文档概述
本文档提供话费充值接口规范说明，提供一整套的完整的接入示例(http 接口)供商户参 考，可以帮助商户开发人员快速完成接口开发与联调，实现与话费充值系统的交易互联。
公司官网：http://www.wikeyun.cn/

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

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

二、话费充值接口
1、充值请求下单（post 表单提交）
网关URL：https://router.wikeyun.cn/rest/Recharge/pushOrder

参数名	类型	必填	参数说明
store_id	字符串	是	店铺ID
mobile	字符串	是	充值号码
order_no   	字符串	是	充值订单号
money	整数	是	充值金额（50,100,200）
recharge_type	整型	是	1快充 0慢充
notify_url	字符串	是	异步回调地址（POST）
change	整数	否	失败更换渠道充值 0 否 1是
不传系统根据设置判断
source	整形	否	是否强制渠道
注意：因为每个渠道价格不同，不同用户提交的业务不同，默认不强制；
失败返回数据格式：
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式：
{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}



2、回调通知

参数名	类型	参数说明
order_no	字符串	充值订单号
order_number	字符串	官方订单号
status	字符串	交易结果（0 待支付 1 已付 充值中 2充值成功 3充值失败 需要退款 4退款成功 6待充值 7 已匹配）
收到回调后，商户必须同步返回字符串	success，否则平台认为商户没有收到回调，会重复发送5
次回调。

3、查询接口（post 表单提交）
网关URL：https://router.wikeyun.cn/rest/Recharge/query

参数名	类型	必填	参数说明
order_number	字符串	是	官方订单号
失败返回数据格式：
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式：
{"code":"0000","msg":"获取成功","data":{"order_number":"xxxx","status":"1","mobile":"13786517891","amount":"100","order_no":"xxxx"}}
4、查询余额接口（post 表单提交）
网关URL：https://router.wikeyun.cn/rest/User/query

数据格式：
{"code":"0000","msg":"获取成功","data":{"money":"100","id":1234}}

三、油卡充值接口

1、添加充值卡
网关URL：https://router.wikeyun.cn/rest/Oil/addCard

参数名	类型	必填	参数说明
store_id	字符串	是	店铺ID
card_num	字符串	是	充值卡号
name	字符串	是	姓名
phone	字符串	是	手机号
user_num	             字符串	是	身份证
card_type	整数	否	0中石化 1中石油
2、编辑充值卡
网关URL：https://router.wikeyun.cn/rest/Oil/editCard

参数名	类型	必填	参数说明
card_id	字符串	是	卡ID
card_num	字符串	是	充值卡号
name	字符串	是	姓名
phone	字符串	是	手机号
user_num	             字符串	是	身份证
card_type	整数	否	0中石化 1中石油
3、油卡详情/删除
删除URL：https://router.wikeyun.cn/rest/Oil/delCard
详情URL：https://router.wikeyun.cn/rest/Oil/cardInfo

参数名	类型	必填	参数说明
card_id	字符串	是	卡ID

2、充值下单请求（post 表单提交）
网关URL：https://router.wikeyun.cn/rest/Oil/pushOrder

参数名	类型	必填	参数说明
store_id	字符串	是	店铺ID
cardId	整数	是	充值卡ID,来自创建接口
order_no   	字符串	是	充值订单号
amount	整数	是	充值金额（500）
recharge_type	整型	是	1快充 0慢充，目前请传0
notify_url	字符串	是	异步回调地址（POST）
失败返回数据格式：
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式：
{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}
   
3、回调通知

参数名	类型	参数说明
order_no	字符串	充值订单号
order_number	字符串	官方订单号
status	字符串	交易结果（0 待支付 1 已付 充值中 2充值成功 3充值失败 需要退款 4退款成功 6待充值 7 已匹配）
收到回调后，商户必须同步返回字符串	success，否则平台认为商户没有收到回调，会重复发送5
次回调。

4、查询接口（post 表单提交）
网关URL：https://router.wikeyun.cn/rest/Oil/query

参数名	类型	必填	参数说明
order_number	字符串	是	官方订单号
失败返回数据格式：
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式：
{"code":"0000","msg":"获取成功","data":{"order_number":"xxxx","status":"1","mobile":"13786517891","amount":"100","order_no":"xxxx"}}

四、电费充值接口

1、添加充值卡
网关URL：https://router.wikeyun.cn/rest/Power/addCard