中國農(nóng)業(yè)銀行網(wǎng)上支付平臺 交易市場 PHP商戶接口編程指南Java EditionV1.0 ,修訂歷史紀(jì)錄 ,目錄1. ...........

中國農(nóng)業(yè)銀行網(wǎng)上支付平臺 交易市場 PHP商戶接口編程指南

Java Edition

V1.0

修訂歷史紀(jì)錄

目錄

1. ................................................................................................................................................................ 簡介

1.1

1.2

1.3 目的............................................................................................................................................................ 3 功能描述.................................................................................................................................................... 3 總體架構(gòu)圖................................................................................................................................................ 3 3 2. 接口開發(fā)軟件包說明 . ................................................................................................................. 4 3. 安裝步驟 ...................................................................................................................................... 5

3.1

3.2

3.3

3.4 安裝前檢查................................................................................................................................................ 5 系統(tǒng)配置.................................................................................................................................................... 5 W EB S ERVICES 接口應(yīng)用配置 . .................................................................................................................. 5 配置測試應(yīng)用............................................................................................................................................ 6 4. 配置文件說明 .............................................................................................................................. 7 5. 范例交易說明 .............................................................................................................................. 8

5.1 交易流程.................................................................................................................................................... 8

5.1.1 Web Services技術(shù)的引入 . ................................................................................................................. 8

5.1.2 簽約和解約交易 ................................................................................................................................ 8

5.2 交易開發(fā)說明.......................................................................................................................................... 10

5.2.1 開發(fā)環(huán)境的配置 .............................................................................................................................. 10

5.2.2 編寫web services接口函數(shù) . ........................................................................................................... 10

5.2.3 編寫php 接口 .................................................................................................................................. 19

1. 簡介

1.1 目的

提供商戶端交易網(wǎng)站通過中國農(nóng)業(yè)銀行網(wǎng)上支付平臺提供的商戶端開發(fā)軟件包實(shí)現(xiàn)功能的編程指南。

1.2 功能描述

按照本編程指南所描述的標(biāo)準(zhǔn)，商戶交易網(wǎng)站可以呼叫調(diào)用，支持功能包括簽約、解約請求、掛單、撤單交易、實(shí)時(shí)成交、追加貨款交易、確認(rèn)付款交易、退貨交易、批量撤單、批量成交、批量交易結(jié)果查詢、到期支付，并且具備接收信用支付平臺結(jié)果響應(yīng)等功能。

接口采用數(shù)字證書的方式來保證商戶與信用支付平臺間的身份驗(yàn)證、中間信息傳遞的完整性，以便進(jìn)行電子商務(wù)安全當(dāng)中非常重要的交易身份辨識、不可抵賴、防止篡改等功能。

1.3 總體架構(gòu)圖

消費(fèi)者

2. 接口開發(fā)軟件包說明

銀行提供的接口開發(fā)軟件包 TrustPayClient-MARKET-PHP-Vx.x.x.zip（x.x.x 為接口開發(fā)軟件包的版本號）包含下列文檔。

3. 安裝步驟

3.1 安裝前檢查

1、本接口軟件包采用JDK 1.4 標(biāo)準(zhǔn)，php5標(biāo)準(zhǔn)，請檢查已經(jīng)安裝了php5和jdk1.4或以上版本的jvm 。

3.2 系統(tǒng)配置

本文檔以jdk1.5.0_18版本為JVM ，jakarta-tomcat-5.0.28作為Web Services服務(wù)器，

axis1.3作為SOAP 解析引擎為例，介紹如何在linux 平臺下構(gòu)建商戶端Web Services服務(wù)器環(huán)境及部署接口應(yīng)用。

1、下載jakarta-tomcat-5.0.28，解壓縮后放置安裝目錄下，下載axis-src-1_3，將axis 文件夾放入$CATALINA_HOMEwebapps目錄下。

注：均已提供在“供參考的Tomcat 應(yīng)用服務(wù)器”中。 2、安裝jdk1.5.0_18。在catalina.sh 中設(shè)置環(huán)境變量： export JAVA_HOME=/opt/IBM/was6admin/jdk1.5.0_18(根據(jù)實(shí)際安裝路徑來設(shè)置) export JAVA_OPTS=" -Xms256m -Xmx1024m" 3、在$CATALINA_HOMEbin下命令行方式下，鍵入：./catalina.sh start啟動服務(wù)器，然后在瀏覽器中鍵入地址http://127.0.0.1:8080/axis/，查看能否正常啟動。

3.3 Web Services接口應(yīng)用配置

1、將銀行提供的接口開發(fā)軟件包TrustPayClient-MARKET-PHP-Vx.x.x.zip （x.x 為接口開發(fā)軟件包的版本號）解壓縮到商戶自定的安裝目錄中。

2、請參考《農(nóng)行網(wǎng)上支付平臺 -商戶使用手冊 V1.0》登錄網(wǎng)上支付平臺下載商戶交易證書，并將商戶交易證書保存到服務(wù)器的硬盤或簽名服務(wù)器中。

3、將商戶的證書文件夾Certificate 放入$CATALINA_HOMEbin目錄下，包括商戶服務(wù)器證書*.pfx，農(nóng)行根證書abc.truststore(生產(chǎn)環(huán)境證書，測試環(huán)境證書為abctest.truststore) 和支付平臺證書TrustPay.cer (生產(chǎn)環(huán)境證書，測試環(huán)境證書為TrustPayTest.cer) 。

4、將ABCMerchantMarket.properties 文件放置到$CATALINA_HOMEwebappsaxisWEB-INFclasses目錄下，該文件包含銀行端訪問地址，商戶id, 相關(guān)證書路徑，證書密碼的配置，日志路徑等。商戶需要注意進(jìn)行正確的配置（具體參考配置文件說明）。將java 接口包EMarketClient-Vx.x.x.jar 文件放入$CATALINA_HOMEwebappsaxisWEB-INFlib下。

5、將Web Services接口包WebServices_market_php_vx.x .jar 放入

$CATALINA_HOMEwebappsaxisWEB-INFlib下。在lib 下加入包log4j-1.2.8.jar ，dom4j-

1.6.1.jar ，jsse.jar ，commons-httpclient-3.0.1.jar ，commons-codec-1.3.jar 。

6、將Web Services配置文件server-config.wsdd 放入

$CATALINA_HOMEwebappsaxisWEB-INF中。

7、修改$CATALINA_HOMEwebappsaxisWEB-INF的web.xml 文件，添加log4j 初始化的servlet 配置，并在該目錄下建立文件夾config ，放置log4j.properties 配置文件（該文件中，可以指定web services段代碼日志輸出格式及輸出地址）。這里我們默認(rèn)的日志是放在

$CATALINA_HOMElogs下。

8、重新啟動tomcat 應(yīng)用服務(wù)器。 9、通過php 調(diào)用web services接口，從而與農(nóng)行電子商務(wù)系統(tǒng)進(jìn)行交互。 注：以上 配置均已提供在“供參考的Tomcat 應(yīng)用服務(wù)器”中，以供參考。

3.4 配置測試應(yīng)用

1、配置WebApp ，指向接口軟件包安裝目錄?mo 。 2、開啟瀏覽器進(jìn)入 ，確定接口軟件包是否已正確安裝及配置。

4. 配置文件說明

5. 范例交易說明

在java 接口的相關(guān)說明文檔中，已經(jīng)給出了如何利用農(nóng)行提供的java 接口包進(jìn)行商戶接口開發(fā)的說明，請參考“信用平臺商戶接口編程指南-Java_Edition-V2.1.0.doc”。php 商戶由于不能直接在程序中調(diào)用農(nóng)行java 接口，所以需要通過一個(gè)中間件間接調(diào)用農(nóng)行java 接口，本文檔以交易市場中典型的簽約和解約交易為例，介紹如何進(jìn)行對農(nóng)行java 接口包的間接調(diào)用。

注意：由于php 系統(tǒng)商戶接口開發(fā)是對java 接口包進(jìn)行的一個(gè)封裝調(diào)用，所以商戶在開發(fā)過程中，需要首先熟悉java 接口包的使用，運(yùn)行java 接口包中的demo 頁面。

5.1 交易流程

本節(jié)將說明商戶交易平臺如何與網(wǎng)上支付平臺通信，來完成交易的過程。

5.1.1 Web Services技術(shù)的引入

由于php 商戶在php 程序中不能直接調(diào)用農(nóng)行提供的java 接口包，所以我們需要一種機(jī)制使得可以在php 程序中間接調(diào)用java 接口包。Web Services技術(shù)就可以提供這樣一種功能。

Web Services技術(shù)是由業(yè)界領(lǐng)袖IBM 、Microsoft 等公司倡導(dǎo)使用，并由國際標(biāo)準(zhǔn)組織W3C 、ws-i 等制定了SOAP 、WSDL 等協(xié)議和規(guī)范，使得Web Services技術(shù)可以將已有的功能代碼進(jìn)行封裝發(fā)布，凡遵循Web Services技術(shù)規(guī)范的其他平臺和程序都可以通過SOAP 協(xié)議進(jìn)行訪問。所以，將農(nóng)行java 接口利用Web Services技術(shù)進(jìn)行功能封裝，就可以在php 程序中進(jìn)行跨平臺、跨語言訪問。

下面，本文檔將交易市場中常用的簽約解約功能進(jìn)行Web Services封裝，并通過php 程序進(jìn)行跨平臺調(diào)用訪問，商戶開發(fā)人員可以參考這兩支交易，進(jìn)行其它接口功能的開發(fā)。

5.1.2 簽約和解約交易

簽約或解約交易因?yàn)樾枰降呐浜希蛻?、商戶交易網(wǎng)站、信用支付平臺），且交易流程是分兩階段進(jìn)行，所以商戶交易平臺針對每個(gè)交易需要開發(fā)兩個(gè)主要的程序才能完成整個(gè)簽約或解約交易流程，此兩支程序?yàn)椤昂灱s或解約請求程序”及“簽約或解約結(jié)果接收程序”。交易流程如下圖所述：