1、开发者账号
account:***** apikey:****************** (这两个参数登入平台开发者中心获取)
订单提交接口地址:http:// 39.108.114.124/Submit.php
订单查询接口地址:http:// 39.108.114.124/Query.php
账户余额查询接口地址:http:// 39.108.114.124/Balance.php
请求方法:POST
请求参数:
类别 |
参数名称 |
为空标识 |
类型 |
说明 |
输入 |
account |
必须 |
string |
平台申请的独立API账号 |
输入 |
action |
必须 |
string |
操作(固定值Charge) |
输入 |
phone |
必须 |
string(11) |
手机号码 |
输入 |
size |
必须 |
int |
流量包大小 |
输入 |
range |
必须 |
int |
充值范围。0 :全国; 1 :省内; |
输入 |
timeStamp |
必须 |
int |
格林威治时间1970年1月1日0时0分0秒到现在的秒数 |
输入 |
orderNo |
可选 |
String |
商户订单号 |
输入 |
sign |
必须 |
string |
请求签名。apiKey+account=XXXXX&action=Charge&phone=XXXXX&range=0
&size=10&timeStamp=********+apiKey
|
响应参数:
类别 |
参数名称 |
为空标识 |
类型 |
说明 |
输出 |
respCode |
必须 |
string |
返回码 |
输出 |
respMsg |
必须 |
string |
返回信息 |
输出 |
orderID |
可选 |
string |
当下单成功后,返回当前订单号信息 |
说明:
1.接口采用http进行交互,POST方式提交。
2.返回报文统一使用JSON,编码为UTF-8,报文中某个可选参数的值为空,则该标签可以不出现。
3.请接入用户登录到平台开发者中心页获取 account、apikey。
4.签名操作必须完全按照所有提交的参数键名升序排序,按照格式key=value&key=value 拼接后,将用户获取的apikey 拼接在参数的首尾进行md5加密,否则会导致校验错误。
JSON返回示例 :
{"respCode":"0000","respMsg":"\u4e0b\u5355\u6210\u529f","orderID":"25"}
1、查询结果
请求参数:
类别 |
参数名称 |
为空标识 |
类型 |
说明 |
输入 |
account |
必须 |
string |
平台申请的独立API账号 |
输入 |
action |
必须 |
string |
操作(固定值Query) |
输入 |
orderID |
必须 |
string(11) |
订购请求产生的唯一orderID |
输入 |
timeStamp |
必须 |
int |
格林威治时间1970年1月1日0时0分0秒到现在的秒数 |
输入 |
sign |
必须 |
string |
请求签名 |
响应参数:
类别 |
参数名称 |
为空标识 |
类型 |
说明 |
输出 |
respCode |
必须 |
string |
返回码 |
输出 |
respMsg |
必须 |
string |
返回信息 |
输出 |
orderID |
可选 |
string |
当下单成功后,返回当前订单号信息 |
输出 |
phoneNo |
可选 |
string |
当前订单手机号 |
说明:
1.接口采用http进行交互,支持POST方式提交。
2.返回报文统一使用JSON,编码为UTF-8,报文中某个可选参数的值为空,则该标签可以不出现。
3.请接入用户登录到平台在用户基本信息页获取 account、apikey。
4.签名操作必须完全按照所有提交的参数键名升序排序,按照格式key=value&key=value 拼接后,将用户获取的apikey 拼接在参数的首尾进行md5加密,否则会导致校验错误。
SON返回示例 :
{"respCode":'0002',"orderID":"18232124007886104378827326333123","phoneNo":"18022831350","respMsg":"\u5145\u503c\u6210\u529f"}
1、回调结果
请求参数:
类别 |
参数名称 |
为空标识 |
类型 |
说明 |
输入 |
respCode |
必须 |
string |
返回码 |
输入 |
respMsg |
必须 |
string |
返回信息 |
输入 |
orderno_ID |
必须 |
string |
商户订单号 |
输入 |
orderID |
可选 |
string |
当下单成功后,返回当前订单号信息 |
响应参数:
类别 |
参数名称 |
为空标识 |
类型 |
说明 |
输出 |
null |
必须 |
string |
直接输出:'Success'(不包含引号,非JSON) |
说明:
1.接口采用http进行交互,支持POST方式提交。
2.返回报文统一使用JSON,编码为UTF-8,报文中某个可选参数的值为空,则该标签可以不出现。
3.请接入用户登录到平台在用户基本信息页获取 account、apikey。
4.签名操作必须完全按照所有提交的参数键名升序排序,按照格式key=value&key=value 拼接后,将用户获取的apikey 拼接在参数的首尾进行md5加密,否则会导致校验错误。
5.回调执行结果(按照执行时间倒序展示)
返回示例 :
Success
1、账户余额查询
请求参数:
类别/td>
| 参数名称 |
为空标识 |
类型 |
说明 |
输入 |
account |
必须 |
string |
平台申请的独立API账号 |
输入 |
action |
必须 |
string |
操作(固定值Balance) |
输入 |
timeStamp |
必须 |
int |
格林威治时间1970年1月1日0时0分0秒到现在的秒数。 |
输入 |
sign |
必须 |
string |
请求签名 |
响应参数:
类别/td>
| 参数名称 |
为空标识 |
类型 |
说明 |
输出 |
respCode |
必须 |
string |
返回码 |
输出 |
respMsg |
必须 |
string |
账户余额(如果返回码不是0004,则为错误说明) |
说明:
1.接口采用http进行交互,支持POST方式提交。
2.返回报文统一使用JSON,编码为UTF-8,报文中某个可选参数的值为空,则该标签可以不出现。
3.请接入用户登录到平台在用户基本信息页获取 account、apikey。
4.签名操作必须完全按照所有提交的参数键名升序排序,按照格式key=value&key=value 拼接后,将用户获取的apikey 拼接在参数的首尾进行md5加密,否则会导致校验错误。
JSON返回示例 :
{"respCode":'0004',"respMsg":"11748.00"}
1、返回代码参照:
返回码(respCode) |
返回码信息(respMsg) |
0000 |
下单成功 |
0001 |
充值中 |
0002 |
充值成功 |
0003 |
充值失败 |
1000 |
用户不存在 |
3003 |
无效区域代号 |
3004 |
无效流量包大小 |
3005 |
无法找到相应的产品 |
3006 |
无法找到相应的库存 |
4000 |
余额不足 |
4001 |
余额不足(上级) |
8000 |
其他错误。请联系工程师跟进。 |
1000 |
用户不存在 |
1001 |
IP鉴权失败 |