什么是话费充值api接口,话费充值api接口,对接流程
什么是话费充值api接口?因为话费充值市场很好,所以很多人都想要分这块蛋糕,但是要想做话费充值的话,不是说我们自己做就能够做的,必须得有平台嫁接才能够做,不然的话是没有办法做的。s18638662696
因此,话费充值api接口出来了,话费充值api接口就是专门实现大家要做话费充值的目的,通过话费充值api接口接入之后,那么就能够实现话费充值,界面展示跟大家在官方平台充值的页面都是一样的。充值范围可以自动配置,并且可以支持三大运营商的话费充值。
话费充值api接口就是能够专门让大家实现话费充值平台的一个接口,只有接入了话费充值api接口才能够实现话费充值,话费接口的是具备非常多优势的。
话费接口优势一:高效完善话费充值采用api接口的话,能够使得整个话费充值的流程便捷,并且api接口的性能是十分出色的话费充值系统,并配备功能完善的数据、资金管理后台,商家可以方便快捷的接入话费充值资源。
话费接口优势二:安全稳定话费充值api接口,无论是基础硬件设施、底层系统架构、核心业务逻辑,以及先进的技术栈,使我们能够提供可靠的安全、稳定性保障。话费充值安全稳定性是十分重要的,这样才能够让客户放心地进行话费充值。
文档概述
本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成接口开发与联调,实现与话费充值系统的交易互联。
公司官网:http://www.wikeyun.cn/
阅读对象
本文阅读对象:开发人员与微客云系统对接支付相关的技术人员。
业务流程
打开控制台 https://control.wikeyun.cn/ 进行注册账号
点击添加店铺,只勾选CMS即可,或者店铺ID保存。
联系客服申请 app_key与app_secret 。
开发对接,需求在控制台进行预存。
二、对接接口
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) |
失败返回数据格式:
{"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退款成功) |
收到回调后,商户必须同步返回字符串 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、系统参数:
以下参数必须传参,全部采用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如下:https://router.wikeyun.cn/rest/Recharge/pushOrder?app_key=1037110417×tamp=1624862089&client=127.0.0.1&format=json&v=1.0&sign=831EFFE3A7A59A530DA8CEC4A05D744
然后对上面的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失败,请稍后再试或者拆分提交处理。
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~