电费充值api接⼝，⽀持国家电⽹+南⽅电信
话费充值接⼝⽂档
接⼝版本：1.0
―、引⾔
1.
1. ⽂档概述
本⽂档提供话费充值接⼝规范说明，提供⼀整套的完整的接⼊⽰例(http 接⼝)供商户参 考，可以帮助商户开发⼈员快速完成接⼝开发与联调，实现与话费充值系统的交易互联。
1.
1. 阅读对象
本⽂阅读对象：开发⼈员与微客云系统对接⽀付相关的技术⼈员。
1.
1. 业务流程
2. 打开控制台 control.wikeyun/ 进⾏注册账号
3. 点击添加店铺，只勾选CMS即可，或者店铺ID保存。
4. 申请 app_key与app_secret 。
5. 开发对接，需求在控制台进⾏预存。
⼆、话费充值接⼝
1、充值请求下单（post 表单提交）
参数名类型必填参数说明
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 表单提交）
参数名类型必填参数说明
order_number字符串是官⽅订单号失败返回数据格式：
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式：
{"code":"0000","msg":"获取成功","data":
{"order_number":"xxxx","status":"1","mobile":"137********","amount":"100","order_no":"xxxx"}}
4、查询余额接⼝（post 表单提交）
数据格式：
{"code":"0000","msg":"获取成功","data":{"money":"100","id":1234}}
油卡充值接⼝
1、添加充值卡
参数名类型必填参数说明
store_id字符串是店铺ID
card_num字符串是充值卡号百度api接口
name字符串是姓名
phone字符串是⼿机号
user_num            字符串是⾝份证
card_type整数否0中⽯化 1中⽯油
2、充值下单请求（post 表单提交）
参数名类型必填参数说明
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 表单提交）
参数名类型必填参数说明
order_number字符串是官⽅订单号失败返回数据格式：
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式：
{"code":"0000","msg":"获取成功","data":
{"order_number":"xxxx","status":"1","mobile":"137********","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接⼝成功
1003app_key不存在
1004业务错误，具体看msg
1005sign签名不对
1006timestamp Out
1007应⽤已禁⽤
1008余额不⾜
1009相同⾯值太多，请拆分充值或者稍后再试
注意事项（话费快充）
1、请勿同⼀时间段推送⼤量订单。
2、请勿推送⼤量相同⾯值的订单，⽐如全是50，全是100，⼜或者50,100相间有规律的⾦额
3、系统会严格审核充值⾦额，同时出现多个⾦额相同的单⼦，就会返回1009失败，请稍后再试或者拆分提交处理。

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。