标签：慢充 code 快充 接口 充值 API 参数 字符串 order
话费充值接口文档
接口版本：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 |
整数 |
是 |
充值金额（100，200） |
|
recharge_type |
整型 |
是 |
1快充 0慢充 |
|
notify_url |
字符串 |
是 |
异步回调地址（POST） |
|
change |
整数 |
否 |
失败更换渠道充值 0 否 1是 不传系统根据设置判断 |
|
source |
整形 |
否 |
是否强制渠道 |
注意：因为每个渠道价格不同，不同用户提交的业务不同，默认不强制；
传source字段则可以强制某渠道，强制快充走94折则，source传6
失败返回数据格式：
{"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、充值下单请求（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、系统参数：
以下参数必须传参，全部采用get传参(拼接至url内)，系统参数包括：
|
参数名 |
类型 |
参数说明 |
|
app_key |
字符串 |
应用唯一表示 |
|
timestamp |
字符串 |
unix时间戳（秒单位） |
|
client |
字符串 |
客户端请求ip |
|
v |
字符串 |
客户端接口版本，目前是1.0 |
|
format |
字符串 |
默认json |
|
sign |
字符串 |
sign签名 |
2、sign签名算法
把业务参数+系统参数合并成一个数组，然后对数组进行ksort排序(按ASCII由小到大排序)，然后对合并后的数组进行循环拼接，格式如下：key1value1key2value2key3value3的形式拼接，最终首尾各拼接一个app_secret，对最终字符串进行md5大写加密。
3、sign案例
然后对上面的url 进行post传业务参数
附录
1、充值请求code 状态码
|
0000 |
接口成功 |
|
1003 |
app_key不存在 |
|
1004 |
业务错误，具体看msg |
|
1005 |
sign签名不对 |
|
1006 |
timestamp Out |
|
1007 |
应用已禁用 |
|
1008 |
余额不足 |
|
1009 |
相同面值太多,请拆分充值或者稍后再试 |
注意事项（话费快充）
1、请勿同一时间段推送大量订单。
2、请勿推送大量相同面值的订单，比如全是50，全是100，又或者50,100相间有规律的金额
3、系统会严格审核充值金额，同时出现多个金额相同的单子，就会返回1009失败，请稍后再试或者拆分提交处理。
标签：慢充,code,快充,接口,充值,API,参数,字符串,order 来源： https://www.cnblogs.com/wikeyun/p/15388069.html
本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享； 2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关； 3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关； 4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除； 5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。