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

流量自由充接口协议 目录 TOC \o 1-3 \h \z \u HYPERLINK \l _Toc451526589 1. 接口协议 PAGEREF _Toc451526589 \h 2 HYPERLINK \l _Toc451526590 2接口定义 PAGEREF _Toc451526590 \h 2 HYPERLINK \l _Toc451526591 2.1下单接口 PAGEREF _Toc451526591 \h 2 HYPERLINK \l _Toc451526592 2.2异步订单通知接口 PAGEREF _Toc451526592 \h 4 HYPERLINK \l _Toc451526593 2.3订单查询接口 PAGEREF _Toc451526593 \h 5 HYPERLINK \l _Toc451526594 2.4商户账户余额查询接口 PAGEREF _Toc451526594 \h 6 HYPERLINK \l _Toc451526595 2.5商户可用套餐查询接口 PAGEREF _Toc451526595 \h 7 HYPERLINK \l _Toc451526596 2.6对账文件下载接口 PAGEREF _Toc451526596 \h 8 HYPERLINK \l _Toc451526597 3省份代码表 PAGEREF _Toc451526597 \h 9 HYPERLINK \l _Toc451526598 4错误代码表 PAGEREF _Toc451526598 \h 10 HYPERLINK \l _Toc451526599 5．RSA加密算法 PAGEREF _Toc451526599 \h 11 HYPERLINK \l _Toc451526600 6．产品代码生成规则 PAGEREF _Toc451526600 \h 11 接口协议 接口采用HTTP POST标准通信协议传输模 接口所有数据以JSON格式传入和返回 字符编码采用UTF-8 接口数据采用RSA公钥加密方式，参考C# HYPERLINK \l _5．RSA加密算法 RSA加密算法 接口密码需要MD5大写 系统将分配用户名、接口密码、RSA加密公钥、请求URL 等配置 请求地址格式是: HYPERLINK http://xxx.xxx.xxx/Interface/Index.aspx 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 产品代码 是 所充流量的产品代码，可以通过流量产品查询接口获取,也可以根据产品代码生成规则产生，详情参考 HYPERLINK \l _6．产品代码生成规则 产品代码生成规则 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:HG2