電子商務系統(tǒng)商戶接入

1、電子商務系統(tǒng)商戶接入 軟件開發(fā)中心 應用開發(fā)三部 n商戶接入介紹 n商戶接口包 n商戶接口包部署 n商戶接口包部署常見問題 軟件開發(fā)中心 應用開發(fā)三部 軟件開發(fā)中心 應用開發(fā)三部 分行操作員添加商戶 給商戶添加商戶管理員 下載商戶管理員證書 商戶管理員登陸電子商務商戶服務系統(tǒng) 下載服務器證書 下載軟件接口包 軟件開發(fā)中心 應用開發(fā)三部 商戶軟件包-類型 b2c通用支付系統(tǒng)商戶軟件包 java asp asp.net php（未正式發(fā)布） b2b通用支付系統(tǒng)商戶軟件包 java asp 通用賬單支付系統(tǒng)商戶軟件包 java asp 網(wǎng)上交易市場支付系統(tǒng)商戶軟件包 java asp php（未正式

2、發(fā)布） 基金直銷支付系統(tǒng)商戶軟件包 java 軟件開發(fā)中心 應用開發(fā)三部 abcicon 我行的行標 cert 支付平臺證書公鑰 電子商務證書信任鏈 demo 頁面及程序開發(fā)范例 docs 商戶接口編程指南 lib 接口包 配置文件 軟件開發(fā)中心 應用開發(fā)三部 商戶接口包部署-java java的應用服務器部署相關web應用 拷貝接口包里的lib目錄下的*.jar到web應用的web-inf/lib目 錄下，trustpayclient-v*.*.jar, (jcert.jar,jnet.jar,jsse.jar看使用 的jdk是否包含安全包) 拷貝接口包里的lib目錄下的.property文

3、件到web應用的 web-inf/classes目錄下 根據(jù)本地web應用的實際情況修改.property文件的配置內(nèi)容 拷貝接口包里的demo目錄下的全部文件到web應用目錄下 啟動web應用 訪問web應用的merchant.html 訪問接口包里的交易范例 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-java配置文件 trustpayconnectmethod=https網(wǎng)上支付平臺通訊方式 trustpayservername=網(wǎng)上支付平臺服務器ip trustpayserverport=443網(wǎng)上支付平臺交易端口 trustpaytrxurl=/b2c/trustpay/receiv

4、emerchanttrxreqservlet網(wǎng)上支付平臺交易 網(wǎng)址 trustpaycertfile=c:/path/cert/trustpay.cer網(wǎng)上支付平臺證書 truststorefile=c:/path/cert/abc.truststore 農(nóng)行根證書文件 truststorepassword=changeit農(nóng)行根證書文件密碼 merchantid=200902011111111商戶編號（電子商務系統(tǒng)商戶終端號） logpath=c:/path/logs交易日志文件存放目錄 merchantcertfile=c:/path/cert/200902011111111new.pfx

5、商戶證書儲存目錄檔名 merchantcertpassword=111111商戶私鑰加密密碼 sign server地址 目前不支持忽略 proxyuse=true proxyhost=6 proxyport=1080代理連接時使用的代理 服務器 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-java的demo運行 修改配置文件 重新啟動web應用 訪問demo里面的html 錄入交易模擬數(shù)據(jù) 提交交易 b2c支付交易開發(fā)示例 根據(jù)交易處理結(jié)果引導客戶瀏覽器的頁面 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-開發(fā)示例-支付交易流程 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署

6、-開發(fā)示例-java-b2c支付交易 取得支付請求所需要的信息，頁面的參數(shù) 根據(jù)頁面參數(shù)，生成訂單對象 生成訂單對象，并將訂單明細加入定單中（可選信息） 生成支付請求對象 傳送支付請求并取得支付網(wǎng)址 根據(jù)支付請求對象生成請求的xml報文 使用商戶服務器證書merchantcertfile對支付請求報文進行簽名 建立同我行網(wǎng)上支付平臺交易網(wǎng)址的https連接，需要truststorefile農(nóng)行根證書文件 將支付請求按照http協(xié)議發(fā)送給我行網(wǎng)上支付平臺 接收我行網(wǎng)上支付平臺的響應報文 利用trustpaycertfile（網(wǎng)上支付平臺證書）對支付請求響應進行驗簽 判斷支付請求是否處理成功 成功

7、則取得支付的網(wǎng)址 將客戶的頁面導向到銀行的支付頁面 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-開發(fā)示例-java-b2c支付結(jié)果接收 兩種通知方式 通過顯示給消費者的支付結(jié)果接收頁面通知商戶 通過支付平臺服務器通知商戶 區(qū)別 頁面通知的方式將支付結(jié)果通知給商戶，如果消費者的瀏覽器里安裝了一些彈出 窗口攔截軟件（例如：3721），就會導致頁面無法彈出，商戶也就無法接收到通 知消息 采用服務器通知的方法，網(wǎng)上支付平臺會將支付結(jié)果消息通過服務器直接發(fā)送給 商戶指定的url，而且發(fā)送失敗以后可以重復發(fā)送，這樣就保證了商戶可以不受消 費者本地設置的影響，正確的接收到支付結(jié)果通知。 服務器通知失敗，會調(diào)

8、用頁面通知方式進行通知 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-開發(fā)示例-java-b2c支付結(jié)果接收 接收服務器通知的頁面（serverurl） 取得網(wǎng)上支付平臺post 的msg參數(shù) 利用此參數(shù)生成支付結(jié)果對象com.hitrust.trustpay.client.b2c.paymentresult 使用支付結(jié)果對象的issuccess()方法辨別支付是否成功 若支付成功，則商戶可以使用支付結(jié)果對象的getvalue()方法取得下列回傳值來進 行后續(xù)的作業(yè) 若請求失敗，可以使用交易結(jié)果對象的returncode 及errormessage屬性取得交易失 敗原因。 該頁面的html代碼里

9、應該包含一個準備展示給消費者支付結(jié)果的url鏈接（ customerurl），鏈接之間需要用包含 展示給消費者支付結(jié)果信息的頁面（customerurl） 根據(jù)情況自行開發(fā)頁面 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-java配置文件-多商戶模式 配置文件 merchantid=200902011111111，200902012222222，200902013333333 merchantcertfile=c:/path/cert/200902011111111.pfx,c:/path/cert/20090201 2222222.pfx,c:/path/cert/2009020133333

10、33.pfx merchantcertpassword=111111,22222222,33333333 發(fā)送請求時附帶交易的商戶號 trxresponse ttrxresponse = tpaymentrequest.postrequest(); 默認按照第一 個商戶發(fā)送交易請求 trxresponse ttrxresponse = tpaymentrequest.extendpostrequest(1);按照參 數(shù)設定的商戶順序發(fā)送交易請求 軟件開發(fā)中心 應用開發(fā)三部 商戶接口包部署-asp 確定服務器已經(jīng)安裝了以下軟件： microsoft .net framework 1.1或更高的版

11、本 microsoft web services enhancements 2.0 service pack 2 for microsoft .net，用于實現(xiàn)簽名驗簽、ssl連接 執(zhí)行命令注冊接口包的dll 中包含的所有公共類 framework_homeregasm.exe /codebase trustpayclient.dl 配置接口配置文件xxx.ini（ trustmerchant.ini ） 設定系統(tǒng)環(huán)境變量 trustmerchantinifile，將ini文件拷貝到此目錄 將ini文件拷貝到c:winntsystem32 目錄下 打開iis，建立虛擬目錄，指向接口軟件包解壓縮

12、后的demo 啟動iis相關站點 訪問該站點的merchant.html 訪問demo里的交易范例 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-a 確定服務器已經(jīng)安裝了以下軟件： microsoft .net framework 2.0或更高的版本 microsoft web services enhancements 2.0 service pack 2 for microsoft .net，用于實現(xiàn)簽名驗簽、ssl連接 接口軟件包中的demo目錄解壓縮 bin目錄，接口dll文件。 web.config文件，配置文件 merchant.html，入口頁面，接口包支持的交易列表 .aspx文

13、件，模擬交易頁面 打開iis，建立虛擬目錄，指向接口軟件包解壓縮后的demo 根據(jù)本地情況修改web.config文件內(nèi)容，基本同java配置文件內(nèi)容。 啟動iis相關站點 訪問該站點的merchant.html 訪問demo里的交易范例 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-php 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-php-續(xù) 接口包部署發(fā)布 下載jakarta-tomcat-5.0.28，解壓縮后放置安裝目錄下（$catalina_home） 下載axis-src-1_3，將axis文件夾放入$catalina_homewebapps目錄下。 安裝jdk1.5.0_18。在

14、tomcat安裝目錄下的catalina.sh中設置環(huán)境變量： export java_home=/xxxx/xxx/jdk1.5.0_18(根據(jù)實際安裝路徑來設置) export java_opts= -xms256m -xmx1024m“ 在$catalina_homebin下命令行方式下，敲入：./catalina.sh start啟動服務器，然后在瀏覽器 中鍵入地址:8080/axis/，查看能否正常啟動 把java接口包和配置文件等發(fā)布到axis應用中 將trustmperties文件放置到axis應用的web-infclasses

15、目錄下 將接口包文件webservices_xxx_php_vx.x.jar， jcert.jar，jnet.jar，jsse.jar 放入axis應用的 web-inflib目錄下。 web services配置文件server-config.wsdd放入axis應用的web-inf中 修改$catalina_homewebappsaxisweb-inf的web.xml文件，添加log4j初始化的servlet配 置，并在該目錄下建立文件夾config，放置perties配置文件（該文件中，可以指 定web services段代碼日志輸出格式及輸出地址）。這里我們默認的日志

16、是放在 $catalina_homelogs下 重新啟動tomcat 修改php.ini配置文件，添加對soap的支持，具體做法是：將extension=php_soap.dll前的注釋字 符刪除； 通過php調(diào)用web services接口，從而與網(wǎng)上支付平臺進行交互。 軟件開發(fā)中心 應用開發(fā)三部 接口程序包部署-軟件包的卸載 java 刪除web-inf/lib目錄下的農(nóng)行接口軟件包提供的jar 刪除web-inf/classes目錄下的配置文件property 刪除web-inf目錄下的demo文件 asp 在接口軟件包安裝目錄lib 下執(zhí)行以下的命令移除trustpayclient.d

17、ll 在系統(tǒng)中的公共類注冊 framework_homeregasm.exe /unregister trustpayclient.dll 刪除接口軟件包安裝目錄 刪除配置文件xxx.ini a 刪除web站點bin目錄下的接口包dll文件 刪除web.config文件里面相關的配置項 刪除站點中的模擬交易頁面（aspx） php jakarta-tomcat-5.0.28-b2c目錄下所有文件 部署在php server 的所有的demo文件（html及php demo文件） 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法 1、無法連接（適用所有接口包） 一般表現(xiàn)： 頁面提示信息“

18、1202無法連線網(wǎng)上支付平臺”； 頁面提示信息“無法連接443端口”； 原因分析： 商戶服務器網(wǎng)絡環(huán)境不通； 商戶服務器網(wǎng)絡環(huán)境權(quán)限控制引起； 問題解決思路： 在商戶服務器上用瀏覽器訪問，查看網(wǎng)絡是否通暢，如果沒有問題，可能是防火 墻或者其他網(wǎng)絡設置阻止了通訊，需要商戶根據(jù)實際情況去查找具體原因； 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 2、提示出現(xiàn)無法預期的錯誤 一般表現(xiàn)： 提示出現(xiàn)無法預期的錯誤 問題原因： asp 本接口軟件包采用microsoft .net framework 1.1 標準，確認安裝了microsoft .net framework 1.1或更高的

19、版本 a 本接口軟件包采用microsoft .net framework 2.0標準，確認安裝了microsoft .net framework 2.0或更高的版本 java 本接口軟件包采用jdk 1.3 標準。請確定服務器已經(jīng)安裝了下列軟件：sun jsse v1.0 或更高的版本，具體需要的jar包為（ jcert.jar、 jnet.jar、 jsse.jar） 解決辦法： 根據(jù)接口包的要求，準備基礎的運行環(huán)境。 3、wse2.0安裝不上 請上microsoft官方網(wǎng)站查找問題解決辦法； 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 4、無法讀取證書文檔 一般表現(xiàn)：

20、頁面提示信息：trustpayclient 錯誤 80131500 無法讀取證書文檔； 原因分析： 配置文件中提到3個證書文檔（網(wǎng)上支付平臺證書、農(nóng)行根證書文件和商戶證書儲存目錄檔名 ），能夠引起這種錯誤的情況很多，主要是以下幾種： 證書文檔路徑不正確； 權(quán)限不夠； 證書文檔密碼不正確； 其他原因； 問題解決思路： 檢查配置文件中各個證書文件的路徑 檢查密碼是否正確，在windows環(huán)境下雙擊證書文件，會提示是否導入到瀏覽器，然后輸入配 置的密碼驗證是否能到下一步； 檢查這三個證書文件是否給asp.net用戶讀的權(quán)限； 檢查其他情況，主要是商戶服務器的操作系統(tǒng)和網(wǎng)絡環(huán)境權(quán)限設置等； 軟件開發(fā)中

21、心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 5、返回報文簽名驗證失敗 一般表現(xiàn)： 頁面提示信息：簽名驗證失敗“2302”； 原因分析： 商戶號和證書文件不匹配； 其他原因； 問題解決思路： 檢查商戶號和證書文件是否匹配； 問題解決思路： 確認配置里面的商戶號與商戶服務器證書是否一致。可以雙擊在windows環(huán)境下雙 擊服務器證書文件，導入瀏覽器之后，查看證書信息的主題， cn = b2c.b2cmerchant.2110000000000000s.200902011111111.0006，倒數(shù)第二項就是商 戶終端號。 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 6、商

22、戶不存在 一般表現(xiàn)： 商戶發(fā)起交易請求，返回錯誤商戶不存在 原因分析： 商戶號配置不對 開通相關交易的商戶終端號 非pos商戶號 非電子商務支付平臺商戶號 商戶接入的環(huán)境同商戶所開立的環(huán)境不一致 測試環(huán)境開立的商戶只能連接測試環(huán)境 生產(chǎn)環(huán)境開立的商戶只能連接生產(chǎn)環(huán)境 非測試狀態(tài)的商戶連接測試環(huán)境 問題解決思路： 配置正確的商戶號 連接正確的域名 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 7、驗證網(wǎng)上支付平臺返回報文簽名失敗 一般表現(xiàn)： 交易返回錯誤信息：驗證網(wǎng)上支付平臺返回報文簽名失敗 原因分析： 驗證簽名的證書配置不對 返回報文被篡改 商戶的應用服務器的默認語言為非簡體中

23、文 返回報文不完整，沒有簽名域 問題解決思路： 配置正確的驗簽證書，生產(chǎn)環(huán)境使用trustpay.cer，培訓環(huán)境使用trustpaytest.cer 調(diào)整應用服務器的默認語言為簡體中文 查看接口包產(chǎn)生的日志，是否因為某種原因造成響應報文沒有簽名就返回，具體錯誤原因查看 沒有簽名的返回報文里面信息。 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 8、商戶服務器證書無效 一般表現(xiàn)： 交易提交產(chǎn)生錯誤信息：商戶服務器證書無效 原因分析： 導出的商戶服務器證書格式不對，導出證書的時候連同私鑰一同導出，只導出公鑰是無效的。 導出后的證書后綴是 .pfx。 問題解決思路： 重新導出pkcs12格式的證書 9、無法寫入交易日志文檔 一般表現(xiàn)： 交易提交產(chǎn)生錯誤信息：無法寫入日志文檔 原因分析： 商戶配置文件中沒有指明日志文檔路徑 日志文件夾沒有手工建立好 問題解決思路： 配置日志文檔路徑信息 手工建立好日志文件夾 軟件開發(fā)中心 應用開發(fā)三部 接口程序包常見錯誤及解決方法-續(xù) 10、類型初始值設定引發(fā)異常 一般表現(xiàn)： 頁面提示信息：80131534“com.hitrust.trustpay.client.merchantconfig”的類型初始值設定項 引發(fā)異常； 原因分析： wse沒有安裝； wse版本問題； 其他原因； 問題解決思路： 檢查