文档介绍：商户流量充值协议()
2016-03-02
目录
1. 请求和响应报文 3
2. API请求地址 3
3. 消息单元定义 3
. 单号码充流量 3
. 批量充流量 4
. 卡密充流量 4
. 获取流量包定义 5
. 查询余额 6
. 获取状态 6
. 推送状态 7
. 主动状态查询(不建议使用) 8
4. 错误定义 8
5. 签名算法 9
请求和响应报文
接口采用http进行交互,所有提交参数均需要UTF-8的urlencode编码后传输,支持GET和POST方式提交(数据量大则建议采用POST)。
返回报文统一使用JSON,编码为UTF-8,报文中某个可选参数的值为空,则该标签可以不出现。
请接入用户登录到平台在用户基本信息页获取 ApiKey
标注(签名) 的参数需要对其进行签名校验,签名算法参见文档尾
API请求地址
/
为实际的流量平台域名
消息单元定义
单号码充流量
请求
Action
命令
charge
V
版本号
固定值
Range
流量类型
0 全国流量 1省内流量,不带改参数时默认为0
OutTradeNo
商户订单号
商户系统内部的订单号,64个字符内、可包含字母,可为空
Account
帐号(签名)

Mobile
号码(签名)
Package
套餐(签名)
流量包大小(必须在返回流量包选择内)
Sign
签名
参见签名算法
响应
TaskID
任务编码
失败为空
Code
代码
Message
消息
例:/?v=&action=charge&account=帐号&mobile=手机号&package=100&sign=MD5
批量充流量
请求
Action
命令
chargeBat
V
版本号
固定值
Range
流量类型
0 全国流量 1省内流量,不带改参数时默认为0
OutTradeNo
商户订单号
商户系统内部的订单号,64个字符内、可包含字母,可为空
Account
帐号(签名)
CMPackage
移动套餐(签名)
如有移动号码则必传传值参考getPackage返回参数
CUPackage
联通套餐(签名)
如有联通号码则必传传值参考getPackage返回参数
CTPackage
电信套餐(签名)
如有电信号码则必传传值参考getPackage返回参数
Mobile
号码(签名)
半角逗号(,)分割
Sign
签名
参见签名算法
响应
TaskID
任务编码
失败为空
Code
代码
Message
消息
例:/?v=&action=chargeBat&account=帐号&mobile=手机号逗号分割&cmPackage=100&cuPackage=100&ctPackage=100&sign=MD5
卡密充流量
请求
Action
命令
chargeCard
V
版本号
固定值
Account
帐号(签名)
Mobile
号码(签名)
CardNo