# ―、引言 ## 1.1文档概述 本文档提供话费充值接口规范说明,提供一整套的完整的接入示例(http 接口)供商户参 考,可以帮助商户开发人员快速完成接口开发与联调,实现与话费充值系统的交易互联。 ## 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字符串是店铺IDmobile字符串是充值号码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字符串客户端请求ipv字符串客户端接口版本,目前是1.0format字符串默认jsonsign字符串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](https://router.wikeyun.cn/rest/Recharge/pushOrder?app_key=1037110417&timestamp=1624862089&client=127.0.0.1&format=json&v=1.0&sign=831EFFE3A7A59A530DA8CEC4A05D744) 然后对上面的url进行post传业务参数 附录 1、充值请求code 状态码 0000接口成功1003app_key不存在1004业务错误,具体看msg1005sign签名不对1006timestamp Out1007应用已禁用1008余额不足