商户流量充值协议(1.1)技术总结.doc

商户流量充值协议(1.1) 2016-03-02 目录  TOC \o 1-3 \f \h \z \u  HYPERLINK \l _Toc444180612 1. 请求和响应报文  PAGEREF _Toc444180612 \h 3  HYPERLINK \l _Toc444180613 2. API请求地址  PAGEREF _Toc444180613 \h 3  HYPERLINK \l _Toc444180614 3. 消息单元定义  PAGEREF _Toc444180614 \h 3  HYPERLINK \l _Toc444180621 3.1. 单号码充流量  PAGEREF _Toc444180621 \h 3  HYPERLINK \l _Toc444180622 3.2. 批量充流量  PAGEREF _Toc444180622 \h 4  HYPERLINK \l _Toc444180623 3.3. 卡密充流量  PAGEREF _Toc444180623 \h 4  HYPERLINK \l _Toc444180624 3.4. 获取流量包定义  PAGEREF _Toc444180624 \h 5  HYPERLINK \l _Toc444180625 3.5. 查询余额  PAGEREF _Toc444180625 \h 6  HYPERLINK \l _Toc444180626 3.6. 获取状态  PAGEREF _Toc444180626 \h 6  HYPERLINK \l _Toc444180627 3.7. 推送状态  PAGEREF _Toc444180627 \h 7  HYPERLINK \l _Toc444180628 3.8. 主动状态查询(不建议使用)  PAGEREF _Toc444180628 \h 8  HYPERLINK \l _Toc444180629 4. 错误定义  PAGEREF _Toc444180629 \h 8  HYPERLINK \l _Toc444180630 5. 签名算法  PAGEREF _Toc444180630 \h 9   请求和响应报文 接口采用http进行交互，所有提交参数均需要UTF-8的urlencode编码后传输，支持GET和POST方式提交(数据量大则建议采用POST)。 返回报文统一使用JSON，编码为UTF-8，报文中某个可选参数的值为空，则该标签可以不出现。 请接入用户登录到平台在用户基本信息页获取 ApiKey 标注 (签名) 的参数需要对其进行签名校验，签名算法参见文档尾 API请求地址 /api.aspx其中为实际的流量平台域名 消息单元定义 单号码充流量 请求Action命令chargeV版本号1.1 固定值Range流量类型0 全国流量 1省内流量，不带改参数时默认为0OutTradeNo商户订单号商户系统内部的订单号,64个字符内、可包含字母，可为空Account帐号 (签名) Mobile号码 (签名)Package套餐 (签名)流量包大小(必须在返回流量包选择内)Sign签名参见签名算法 响应TaskID任务编码 失败为空Code代码Message 消息 例:/api.aspx?v=1.1action=chargeaccount=帐号mobile=手机号package=100sign=MD5 批量充流量 请求Action命令chargeBatV版本号1.1 固定值Range流量类型0 全国流量 1省内流量，不带改参数时默认为0OutTradeNo商户订单号商户系统内部的订单号,64个字符内、可包含字母，可为空Account帐号(签名)CMPackage移动套餐(签名)如有移动号码则必传 传值参考getPackage返回参数CUPackage联通套餐(签名)如有联通号码则必传 传值参考getPackage返回参数CTPackage电信套餐(签名)如有电信号码则必传 传值参考getPackage返回参数Mobile号码(签名)半角逗号(,)分割Sign签名参见签名算法 响应TaskID任务编码失败为空Code代码Message消息 例:/api.aspx?v=1.1a