深圳硕软技术有限公司 技术支持中心 24小时服务电话:0755-82682968 在线远程协助QQ:2513402938
搜索:     高级搜索

直通车接口之机主余额查询协议(HTTP)

文章ID: 56
最近更新: 2016年 04月 15日
Revision: 4
添加评论
查看: 908
评论: 0
发表: 2015年 03月 11日
通过 Ltisn L.
更新: 2016年 04月 15日
通过 Ltisn L.

*版本更新记录

141229 Http查询机主协议

一、话费余额查询Http协议

注:适合于代理商营业系统的技术开发人员参照使用。

本接口限使用Http方式请求,鉴权使用用户在管理端配置的秘钥(MD5key,从服务商获取)签名;

本接口限直通车机主余额查询使用;

通信方式:HTTP Get/Post      链接地址:由服务商提供

字符编码:gb2312         报文编码:Base64报文        

端口:50015             签名方式:MD5(小写)

HTTP请求(Base64编码之前)字串:

如:Sign =MD5(AgentAccount=SH2009&Phone=13800138000&Password=F1A1F0CC7F9D83BB)

AgentAccount =SH2009&Phone=13800138000&Sign=b8360240cf9080653708f9826e05970d

字段说明:

序号

字段名

字段含义

字段长度

说明

1

AgentAccount

商户账号

1-20字节

由服务方提供

2

Phone

充值号码

12字节

电话号码数字0..9

3

Password

商户密钥

1-20字节

用户自定义的商户密钥(管理端-账户管理-web接口-MD5秘钥)不直接发送,仅参与MD5

4

Sign

校验码

32字节

MD5值,小写

服务端返回字符串(对字串做base64解码后得到的数据)

Version=1.0&Phone=13800138000&Name=1cXI/Q==&Balance=100.00&Area=ueO2q8qhye7b2srQ&Package=MTY4zNeyzQ==&Brand=tq+40LXYtPg=&IsSuccess=1&ErrorMsg=&Flow=MTIzNA==&Sign=f64512beedb2a89e00d27d8e32714379

返回字段说明:

序号

字段名

字段含义

说明

1

Version

协议版本

用于驱分该数据包用什么方式解码

2

Phone

查询号码

电话号码数字0..9

3

Password

商户密钥

商户密钥,注 :密钥不直接发送,仅参与MD5

4

Name

机主姓名

电话号码机主姓名

5

Balance

机主余额

电话号码余额

6

Package

号码套餐

号码开通套餐

7

Brand

号码品牌

号码品牌(如动感地带)

8

Area

号码归属地

号码归属地

9

IsSuccess

查询结果

是否查询成功 (1 表示成功 3 表示失败)

10

ErrorMsg

错误信息

查询错误内容

11

Flow

流量

流量

12

Sign

校验码

MD5值,小写

这篇文章是:  
前一个   下一个
API通用接口之机主余额查询协议(TCP)     API商户协议-多业务接口