文档概述
本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成接口开发与联调,实现与话费充值系统的交易互联。
公司官网:微客云 - 淘宝客CMS,公众号,小程序,淘客APP,外卖返利系统
阅读对象
本文阅读对象:开发人员与微客云系统对接支付相关的技术人员。
业务流程
打开控制台 微客云 进行注册账号
点击添加店铺,只勾选CMS即可,或者店铺ID保存。
联系客服申请 app_key与app_secret 。
开发对接,需求在控制台进行预存。
二、话费充值接口
1、充值请求下单(post 表单提交)
网关URL:https://router.wikeyun.cn/rest/Recharge/pushOrder
注意:因为每个渠道价格不同,不同用户提交的业务不同,默认不强制;
传source字段则可以强制某渠道,强制快充走94折则,source传6
失败返回数据格式:
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式:
{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}
2、回调通知
收到回调后,商户必须同步返回字符串 success,否则平台认为商户没有收到回调,会重复发送5
次回调。
网关URL:https://router.wikeyun.cn/rest/Recharge/query
失败返回数据格式:
{"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"}}
查询余额接口(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
网关URL:https://router.wikeyun.cn/rest/Oil/pushOrder
失败返回数据格式:
{"code":"1003","msg":"app_key不能为空","time":"1624868000","data":null}
成功返回数据格式:
{"code":"0000","msg":"推送成功","data":{"order_number":"xxxx"}}
3、回调通知
收到回调后,商户必须同步返回字符串 success,否则平台认为商户没有收到回调,会重复发送5
次回调。
网关URL:https://router.wikeyun.cn/rest/Oil/query
失败返回数据格式:
{"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内),系统参数包括:
sign签名算法
把业务参数+系统参数合并成一个数组,然后对数组进行ksort排序(按ASCII由小到大排序),然后对合并后的数组进行循环拼接,格式如下:key1value1key2value2key3value3的形式拼接,最终首尾各拼接一个app_secret,对最终字符串进行md5大写加密。
3、sign案例
然后对上面的url 进行post传业务参数
附录
1、充值请求code 状态码
注意事项(话费快充)
1、请勿同一时间段推送大量订单。
2、请勿推送大量相同面值的订单,比如全是50,全是100,又或者50,100相间有规律的金额
3、系统会严格审核充值金额,同时出现多个金额相同的单子,就会返回1009失败,请稍后再试或者拆分提交处理。