话费慢充API接口,三网慢充,最慢72小时到账

―、引言

1. 1. 文档概述

本文档提供话费充值接口规范说明，提供一整套的完整的接入示例(http 接口)供商户参 考，可以帮助商户开发人员快速完成接口开发与联调，实现与话费充值系统的交易互联。

1. 1. 阅读对象

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

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

二、对接接口

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

次回调。

• 签名算法

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	余额不足