周 玫
(江西工業職業技術學院,江西 南昌 330039)
基于手機繳費系統的接口實現
周 玫
(江西工業職業技術學院,江西 南昌 330039)
文章以手機繳費管理系統為背景,闡述了第三方繳費的核心接口,通過本接口實現用戶手機費代繳。用戶只需通過提交手機號碼和繳納金額(話費),系統就會自動發送手機號碼和金額到第三方繳費接口上,給這個手機號碼繳納相應的金額。本系統自上線以來適應性強,用戶可以在網上實現足不出戶的繳費,大大提高了用戶生活質量,是個值得提倡的手機繳費方式。
手機繳費;接口;管理系統
人們都希望足不出戶就能進行手機繳費,這個需要移動提供繳費接口。首先與合作商進行洽談,合作商包括商戶和代理商,商戶是所有通過本系統接入的企業或個人統稱為商戶,每個商戶在本系統中擁有唯一的商戶編號。代理商是商戶業務的主體,一個商戶可擁有多個代理商。其次規范,規范包括訂單防重和重復下單,訂單防重是在一個商戶的交易日內,對每一個訂單,應有唯一的訂單號。商戶號、商戶訂單日期、商戶訂單號決定唯一一筆訂單。重復下單是異常情況下商戶重復下單,系統會返回相關錯誤信息。商戶收到此信息請發起查詢交易確定該筆訂單狀態,切勿直接當作失敗處理。最后接口,接口有3個基本約定:(1)接口以HTTP方式開放;(2)商戶通過數據流方式向接口發送數據;(3)編碼方式為UTF-8。
盡管接口千差萬別、級別也不一樣。但是去除一些細節資料后,接口的設計主要在報文格式的定義上面,報文格式定義好,接口也就能定義好。在報文格式的定義上接口的復雜程度各不相同,本文報文為JSON格式。請求報文包括基本元素(header)與業務元素(body),響應報文包括結果元素(result)與業務元素(body)。
下面是接口如何實現詳細說明:
此接口用于購買話費。請求地址:http://[ip:prot]/mobile/ charge.json
1.1 請求參數(見表1)

表1 請求參數
1.2 請求示例

1.3 響應參數(見表2)
交易結果代碼為10000000僅表示本次請求受理成功,不表示繳費成功。繳費結果通過異步通知接口返回或由商戶主動發起查詢交易查詢。

表2 響應參數
1.4 響應示例

此接口用于查詢訂單狀態。請求地址:http://[ip:prot]/common/query.json
2.1 請求參數(見表3)

表3 請求參數
2.2 請求示例

2.3 響應參數(見表4)

表4 響應參數
2.4 響應示例

此接口用于查詢代理商資金余額。接口地址:http:// [ip:prot]/common/account.json。
3.1 請求參數與響應參數(見表5)

表5 請求參數
3.2 請求示例

3.3 響應示例

平臺對商戶的業務請求處理完成后,會將處理的最終結果通過服務器主動通知至商戶提供的異步通知地址。通知服務通過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— ),女,江蘇泰縣,碩士,副教授;研究方向:軟件工程。