示范接口參數文檔

模塊一

1、說明

　　文檔主要提供的是與系統對接時參數的相關說明。以下幾點需要注意：

　　1、  系統間交互參數以JSON格式進行傳輸；

　　2、  加簽驗簽：系統會給接入者提供秘鑰，發送請求需要根據秘鑰進行加簽，通過后才能進行交易請求；同樣，對於返回的結果系統也會進行加簽，接收方需要用秘鑰進行原交易加簽並進行比較驗證數據的完整性。

　　注：加簽驗簽方法調用提供的jar包調用相應的方法即可。加簽類為Sign。

    　　　交易請求時request.setHeaders(“code”);若在head標簽中存放了當前機構code的MAP值，則支付系統的返回值sign標簽會帶有加簽串。若不傳則返回的sign為null.

　　　　 所有的接口含有異步應答的不論是否傳輸上訴字段返回的sign都需要進行驗簽。

　　3、  驗簽串傳輸：應用發起請求前需要將調用加簽工具類返回的加簽串存放在key為sign的Map中，並在發送http請求時增加request.setHeaders(Map)方法。

　　4、  返回格式報文：不同業務返回不一樣，格式都是JSON，具體開發進行調試或者參考SDK開發包。

基本樣例：

　　{"sign":"88888888888888888888","result":{"errorCode":"900017","errorMsg":"未找到原交易信息","tokUrl":null, "data":{"traceNo":"418548"}}}

　　所有交易的返回格式都如上面的報文，主體分為兩部分，sign為驗簽串，result為結果集。其中result中的errorCode和errorMsg為參考應答碼部分;backUrl為預留，暫不使用；

　　data是根據不同交易返回不同的值；

　　l  具體參考提供的開發SDK，里面提供了所有交易的模擬傳輸過程。

　　l  ☆☆☆ 注：在驗證支付返回的加簽串是否正確的時候，應用獲取到result后調用加密方法傳入的MAP值的KEY一定要為result，否則將會導致驗簽不過。☆☆☆

　　l  文檔中所有交易的請求URL都為測試環境，測試通過后請更換生產環境鏈接地址。

2、接口一

　　請求URL 　　http://127.0.0.1:8080/test_store/UserServlet?method=userRegist

　　請求參數

　　應答參數

請求報文樣例

 

　　　　　

 

 

應答報文樣例