华高平台数据接入接口协议3.1--16.6.3.doc

流量自由充接口协议 目录 1. 接口协议 2 2接口定义 2 2.1下单接口 2 2.2异步订单通知接口 4 2.3订单查询接口 5 2.4商户账户余额查询接口 6 2.5商户可用套餐查询接口 7 2.6对账文件下载接口 8 3省份代码表 9 4错误代码表 10 5．RSA加密算法 11 6．产品代码生成规则 11 接口协议 接口采用HTTP POST标准通信协议传输模 接口所有数据以JSON格式传入和返回 字符编码采用UTF-8 接口数据采用RSA公钥加密方式，参考C#RSA加密算法 接口密码需要MD5大写 系统将分配用户名、接口密码、RSA加密公钥、请求URL 等配置 请求地址格式是: http://xxx.xxx.xxx/Interface/Index.aspx 所以JSON参数都用小写 2接口定义 2.1下单接口 接口请求参数 序号 字段标识 字段名称 是否必传 字段描述 1 action 接口命令字 是 固定值：charge 2 username 用户名 是 系统登录帐号 3 password 接口密码 是 系统API接口密码 4 orderid 商户交易流水号 是 商户系统的交易流水号，用于订单查询和回掉（注意：必须保证每次下单的ORDERID是唯一的，不能重复） 5 mobile 手机号码 是 用于充值的手机号码 6 productcode 产品代码 是 所充流量的产品代码，可以通过流量产品查询接口获取,也可以根据产品代码生成规则产生，详情参考产品代码生成规则 7 callbackurl 异步通知地址 是 受理完成之后，平台将调用客户接口反馈最终受理结果 请求示例： {username:133XXXXXXXX,action:charge,data:oiAQtnWtH/sAwzSBCxssWqyRXiyoyfcs+HMXKT+hae7td9h2opSr6VUs88M3Hi4RoR+13bKsMVHsrHLXJ92zA9uXdHYe9dug5DmIv5Uf4YCOO+A1LE9OjvFnxU2p1XHm5Tz4HEs1EhhXH6v0Q5YqWlmk5Jf4ZWXQE0+phYhwVMJ+7z8/XZ3D36PRF6pyD5dyK8S3p2zmg9EMX1hSHDoOtqEgT+dAVukVgzgZF15EfwU4lGiZ5/k/ymJ9Qyz97ci8dXKrPw6UxHWo5NIEo17/EpjQ0M+TD3IYKaWpy3coPcShmms3GOtQbtJdhO9GMI59iyCCUs49Pa6okL50dszcsA==} 其中data为RSA加密生成的数据，RSA的加密公钥有系统提供，加密前的数据格式为： {password:827CCB0EEA8A706C4C34A16891F84E7B,orderlist:[{productcode:100100861000010,orderid:HG20160519105755755251244,mobile:135XXXXXXXX},{productcode:100100861100010,orderid:HG20160519105755755251321,mobile:132XXXXXXXX}],callbackurl:http://xxx.xxx.xxx/Interface/ordercb.aspx} 接口响应 响应参数 序号 字段标识 字段名称 字段描述 1 status 交易状态 请求状态码，0表示成功，其它失败 2 message 交易信息 成功或失败的信息 3 results 订单结果 请求订单的结果对象 4 orderstatus 订单状态码 包括在results中，表示订单的提交状态，0表示订单提交成功，其它失败 5 orderid 商户提交的订单号 包括在results中 6 ordermsg 订单状态信息 包括在results中， 订单的成功或失败的信息 返回示例 {status:0,message:成功,results:[{orderstatus:0,orderid: HG20160519105755755251244,ordermsg:提交成功}，{orderstatus:2,orderid: HG20160519105755755251321,ordermsg:无效的订单产品}]} 2.2异步订单通知接口 接口说明 异步通知接口为平台向商户系统发起的请求，请求方式为HTTP POST， 数据格式为JSON。商户系统在接收到推送请求后返回success， 在推送没有收到返回success的情况下我们会多次推送。在手动充值或API下单接口没有回调地址（callbackurl