文档介绍：云之讯流量充值协议
目录
1. 请求和响应报文 3
2. API请求地址 3
3. 消息单元定义 3
. 单号码充流量 3
. 批量充流量 4
. 卡密充流量 4
. 获取流量包定义 5
. 查询余额 6
. 查询状态 6
. 推送状态 7
4. 错误定义 8
5. 签名算法 8
请求和响应报文
接口采用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
命令
flowRecharge
V
版本号
固定值
Range
流量类型
0 全国流量 1省内流量，不带改参数时默认为0
OutTradeNo
商户订单号
商户系统内部的订单号,64个字符内、可包含字母，可为空
Account
帐号 (签名)
Mobile
号码 (签名)
Package
套餐 (签名)
流量包大小(必须在返回流量包选择内)
Sign
签名
参见签名算法
响应
TaskID
任务编码
失败为空
Code
代码
Message
消息
例:?v=&action=charge&account=帐号&mobile=手机号&package=100&sign=MD5
增加错误码
011
商户订单号超过长度限制64个字符
012
非法IP地址请求
013
账号已经失效
014
账号已经暂停
015
账号设置IP接入限制
016
CP订单号重复错误
017
运营商套餐包非法
批量充流量
请求
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