网上话费充值

话费充值API接⼝,三⽹API，快充慢充api

话费充值接⼝⽂档

接⼝版本：1.0

―、引⾔

1.1⽂档概述

本⽂档提供话费充值接⼝规范说明，提供⼀整套的完整的接⼊⽰例(http接⼝)供商户参考，可以帮助商户开发⼈员快速完成接⼝开发与联

调，实现与话费充值系统的交易互联。

1.2阅读对象

本⽂阅读对象：开发⼈员与微客云系统对接⽀付相关的技术⼈员。

1.3业务流程

2、点击添加店铺，只勾选CMS即可，或者店铺ID保存。

3、联系客服申请app_key与app_cret。

4、开发对接，需求在控制台进⾏预存。

⼆、话费充值接⼝

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":"","amount":"100","order_no":"xxxx"}}

4、查询余额接⼝（post表单提交）

数据格式：

{"code":"0000","msg":"获取成功","data":{"money":"100","id":1234}}

三、油卡充值接⼝

1、添加充值卡

参数名类型必填参数说明

store_id字符串是店铺ID

card_num字符串是充值卡号

name字符串是姓名

phone字符串是⼿机号

ur_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":"","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_cret，对最终字符串进⾏md5⼤写加密。

3、sign案例

然后对上⾯的url进⾏post传业务参数

附录

1、充值请求code状态码

0000接⼝成功

1003app_key不存在

1004业务错误，具体看msg

1005sign签名不对

1006timestampOut

1007应⽤已禁⽤

1008余额不⾜

1009相同⾯值太多,请拆分充值或者稍

后再试

注意事项（话费快充）

1、请勿同⼀时间段推送⼤量订单。

2、请勿推送⼤量相同⾯值的订单，⽐如全是50，全是100，⼜或者50,100相间有规律的⾦额

3、系统会严格审核充值⾦额，同时出现多个⾦额相同的单⼦，就会返回1009失败，请稍后再试或者拆分提交处理。