基于手機繳費系統(tǒng)的接口實現(xiàn)

周 玫

（江西工業(yè)職業(yè)技術(shù)學(xué)院，江西 南昌 330039）

基于手機繳費系統(tǒng)的接口實現(xiàn)

周 玫

（江西工業(yè)職業(yè)技術(shù)學(xué)院，江西 南昌 330039）

文章以手機繳費管理系統(tǒng)為背景，闡述了第三方繳費的核心接口，通過本接口實現(xiàn)用戶手機費代繳。用戶只需通過提交手機號碼和繳納金額（話費），系統(tǒng)就會自動發(fā)送手機號碼和金額到第三方繳費接口上，給這個手機號碼繳納相應(yīng)的金額。本系統(tǒng)自上線以來適應(yīng)性強，用戶可以在網(wǎng)上實現(xiàn)足不出戶的繳費，大大提高了用戶生活質(zhì)量，是個值得提倡的手機繳費方式。

手機繳費；接口；管理系統(tǒng)

人們都希望足不出戶就能進行手機繳費，這個需要移動提供繳費接口。首先與合作商進行洽談，合作商包括商戶和代理商，商戶是所有通過本系統(tǒng)接入的企業(yè)或個人統(tǒng)稱為商戶，每個商戶在本系統(tǒng)中擁有唯一的商戶編號。代理商是商戶業(yè)務(wù)的主體，一個商戶可擁有多個代理商。其次規(guī)范，規(guī)范包括訂單防重和重復(fù)下單，訂單防重是在一個商戶的交易日內(nèi)，對每一個訂單，應(yīng)有唯一的訂單號。商戶號、商戶訂單日期、商戶訂單號決定唯一一筆訂單。重復(fù)下單是異常情況下商戶重復(fù)下單，系統(tǒng)會返回相關(guān)錯誤信息。商戶收到此信息請發(fā)起查詢交易確定該筆訂單狀態(tài)，切勿直接當(dāng)作失敗處理。最后接口，接口有3個基本約定：（1）接口以HTTP方式開放；（2）商戶通過數(shù)據(jù)流方式向接口發(fā)送數(shù)據(jù)；（3）編碼方式為UTF-8。

盡管接口千差萬別、級別也不一樣。但是去除一些細節(jié)資料后，接口的設(shè)計主要在報文格式的定義上面，報文格式定義好，接口也就能定義好。在報文格式的定義上接口的復(fù)雜程度各不相同，本文報文為JSON格式。請求報文包括基本元素（header）與業(yè)務(wù)元素（body），響應(yīng)報文包括結(jié)果元素（result）與業(yè)務(wù)元素（body）。

下面是接口如何實現(xiàn)詳細說明：

1 話費充值下單

此接口用于購買話費。請求地址：http://[ip:prot]/mobile/ charge.json

1.1 請求參數(shù)（見表1）

表1 請求參數(shù)

1.2 請求示例

1.3 響應(yīng)參數(shù)（見表2）

交易結(jié)果代碼為10000000僅表示本次請求受理成功，不表示繳費成功。繳費結(jié)果通過異步通知接口返回或由商戶主動發(fā)起查詢交易查詢。

表2 響應(yīng)參數(shù)

1.4 響應(yīng)示例

2 訂單結(jié)果查詢

此接口用于查詢訂單狀態(tài)。請求地址：http://[ip:prot]/common/query.json

2.1 請求參數(shù)（見表3）

表3 請求參數(shù)

2.2 請求示例

2.3 響應(yīng)參數(shù)（見表4）

表4 響應(yīng)參數(shù)

2.4 響應(yīng)示例

3 賬戶查詢

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

3.1 請求參數(shù)與響應(yīng)參數(shù)（見表5）

表5 請求參數(shù)

3.2 請求示例

3.3 響應(yīng)示例

4 異步通知接口

平臺對商戶的業(yè)務(wù)請求處理完成后，會將處理的最終結(jié)果通過服務(wù)器主動通知至商戶提供的異步通知地址。通知服務(wù)通過HTTP GET方式請求商戶服務(wù)。通知機制：最多通知3次，時間間隔為2分鐘。

4.1 請求參數(shù)（見表6）

表6 請求參數(shù)

4.2 請求示例

4.3 響應(yīng)參數(shù)

商戶成功接受通知后請返回字符串SUCCESS，否則繼續(xù)通知，直至通知機制完成。

手機繳費管理系統(tǒng)整個操作簡單。通過該系統(tǒng)提供的功能減少了系統(tǒng)使用者的工作量，節(jié)省使用者的時間。手機繳費管理系統(tǒng)具有很好的運行效率，能夠大批量對繳費數(shù)據(jù)進行自動繳費。手機繳費管理系統(tǒng)是個獨立的系統(tǒng)，只針對手機繳費應(yīng)用，由于該系統(tǒng)功能簡單，維護起來也很方便。

[1]黃華.AJAX技術(shù)及應(yīng)用綜述[J].科技資訊，2007（11）：87.

[2]冉春玉，童瑩.Web 2.0與Ajax技術(shù)解析[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— ），女，江蘇泰縣，碩士，副教授；研究方向：軟件工程。