基于手机缴费系统的接口实现

周 玫

（江西工业职业技术学院，江西 南昌 330039）

基于手机缴费系统的接口实现

周 玫

（江西工业职业技术学院，江西 南昌 330039）

文章以手机缴费管理系统为背景，阐述了第三方缴费的核心接口，通过本接口实现用户手机费代缴。用户只需通过提交手机号码和缴纳金额（话费），系统就会自动发送手机号码和金额到第三方缴费接口上，给这个手机号码缴纳相应的金额。本系统自上线以来适应性强，用户可以在网上实现足不出户的缴费，大大提高了用户生活质量，是个值得提倡的手机缴费方式。

手机缴费；接口；管理系统

人们都希望足不出户就能进行手机缴费，这个需要移动提供缴费接口。首先与合作商进行洽谈，合作商包括商户和代理商，商户是所有通过本系统接入的企业或个人统称为商户，每个商户在本系统中拥有唯一的商户编号。代理商是商户业务的主体，一个商户可拥有多个代理商。其次规范，规范包括订单防重和重复下单，订单防重是在一个商户的交易日内，对每一个订单，应有唯一的订单号。商户号、商户订单日期、商户订单号决定唯一一笔订单。重复下单是异常情况下商户重复下单，系统会返回相关错误信息。商户收到此信息请发起查询交易确定该笔订单状态，切勿直接当作失败处理。最后接口，接口有3个基本约定：（1）接口以HTTP方式开放；（2）商户通过数据流方式向接口发送数据；（3）编码方式为UTF-8。

尽管接口千差万别、级别也不一样。但是去除一些细节资料后，接口的设计主要在报文格式的定义上面，报文格式定义好，接口也就能定义好。在报文格式的定义上接口的复杂程度各不相同，本文报文为JSON格式。请求报文包括基本元素（header）与业务元素（body），响应报文包括结果元素（result）与业务元素（body）。

下面是接口如何实现详细说明：

1 话费充值下单

此接口用于购买话费。请求地址：http://[ip:prot]/mobile/ charge.json

1.1 请求参数（见表1）

表1 请求参数

1.2 请求示例

1.3 响应参数（见表2）

交易结果代码为10000000仅表示本次请求受理成功，不表示缴费成功。缴费结果通过异步通知接口返回或由商户主动发起查询交易查询。

表2 响应参数

1.4 响应示例

2 订单结果查询

此接口用于查询订单状态。请求地址：http://[ip:prot]/common/query.json

2.1 请求参数（见表3）

表3 请求参数

2.2 请求示例

2.3 响应参数（见表4）

表4 响应参数

2.4 响应示例

3 账户查询

此接口用于查询代理商资金余额。接口地址：http:// [ip:prot]/common/account.json。

3.1 请求参数与响应参数（见表5）

表5 请求参数

3.2 请求示例

3.3 响应示例

4 异步通知接口

平台对商户的业务请求处理完成后，会将处理的最终结果通过服务器主动通知至商户提供的异步通知地址。通知服务通过HTTP GET方式请求商户服务。通知机制：最多通知3次，时间间隔为2分钟。

4.1 请求参数（见表6）

表6 请求参数

4.2 请求示例

4.3 响应参数

商户成功接受通知后请返回字符串SUCCESS，否则继续通知，直至通知机制完成。

手机缴费管理系统整个操作简单。通过该系统提供的功能减少了系统使用者的工作量，节省使用者的时间。手机缴费管理系统具有很好的运行效率，能够大批量对缴费数据进行自动缴费。手机缴费管理系统是个独立的系统，只针对手机缴费应用，由于该系统功能简单，维护起来也很方便。

[1]黄华.AJAX技术及应用综述[J].科技资讯，2007（11）：87.

[2]冉春玉，童莹.Web 2.0与Ajax技术解析[J].河南科技，2010（9）：55-56.

Interface implementation based on mobile payment system

Zhou Mei
（Jiangxi Industry Polytechnic College, Nanchang 330039 , China）

Based on the background of mobile phone payment management system, this paper expounds the core interface of third party payment, and pays the fee through the realization of mobile phone user interface. Users only need to submit the mobile phone number and the amount(calls), and then the system will automatically send the mobile phone number and amount to third party payment interface, paying the corresponding amount of this system. Since the on-line adaptability, users can realize the online payment without going out, greatly improving the quality of life of the user. Such mobile phone payment is worth promoting.

mobile payment; interface; management system

周玫（1981— ），女，江苏泰县，硕士，副教授；研究方向：软件工程。