搜索
中国农业银行网上支付平台交易市场PHP商户接口编程指南JavaEditionV1.0农行网上支付平台商户接口编程指南–PHPEdition–V1.0网上支付平台开发小组1of31修订历史纪录日期版本说明作者2009/11/18V1.0初稿童益柱农行网上支付平台商户接口编程指南–PHPEdition–V1.0网上支付平台开发小组2of31目录1.................................................................................................................................................................简介31.1目的............................................................................................................................................................31.2功能描述....................................................................................................................................................31.3总体架构图................................................................................................................................................32.接口开发软件包说明..................................................................................................................43.安装步骤......................................................................................................................................53.1安装前检查................................................................................................................................................53.2系统配置....................................................................................................................................................53.3WEBSERVICES接口应用配置...................................................................................................................53.4配置测试应用............................................................................................................................................64.配置文件说明..............................................................................................................................75.范例交易说明..............................................................................................................................85.1交易流程....................................................................................................................................................85.1.1WebServices技术的引入..................................................................................................................85.1.2签约和解约交易................................................................................................................................85.2交易开发说明..........................................................................................................................................105.2.1开发环境的配置..............................................................................................................................105.2.2编写webservices接口函数............................................................................................................105.2.3编写php接口..................................................................................................................................19农行网上支付平台商户接口编程指南–PHPEdition–V1.0网上支付平台开发小组3of311.简介1.1目的提供商户端交易网站通过中国农业银行网上支付平台提供的商户端开发软件包实现功能的编程指南。1.2功能描述按照本编程指南所描述的标准，商户交易网站可以呼叫调用，支持功能包括签约、解约请求、挂单、撤单交易、实时成交、追加货款交易、确认付款交易、退货交易、批量撤单、批量成交、批量交易结果查询、到期支付，并且具备接收信用支付平台结果响应等功能。接口采用数字证书的方式来保证商户与信用支付平台间的身份验证、中间信息传递的完整性，以便进行电子商务安全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。1.3总体架构图中国农业银行网上支付平台Internet商户交易网站服务器消费者发起交易交易请求/响应进行交易WebServices服务器农行网上支付平台商户接口编程指南–PHPEdition–V1.0网上支付平台开发小组4of312.接口开发软件包说明银行提供的接口开发软件包TrustPayClient-MARKET-PHP-Vx.x.x.zip（x.x.x为接口开发软件包的版本号）包含下列文档。文件名称说明/docs/农行网上支付平台-交易市场商户接口编程指南-PHP-Edition-Vx.x.pdf本文件/lib/EMarketClient-Vx.x.x.jar农行网上支付平台商户端接口Java软件包。/lib/WebServices_market_php_vx.x.jar农行网上支付平台商户端WebServices接口范例软件包。/lib/ABCMerchantMarket.properties接口配置文件/lib/jakarta-tomcat-5.0.28-market-yyyymmdd.tar.gz供参考的Tomcat应用服务器，包含相关配置/lib/api_market.phpPhp接口/demo/Merchant.html接口范例首页/demo/SignUpReq.php签约请求交易php范例页面1/demo/SignUpQuery.php签约请求交易php范例页面2/demo/SignOffReq.php解约请求交易php范例页面1/demo/SignOffQuery.php解约请求交易php范例页面2/cert/abc.truststore生产环境农行根证书/cert/abctest.truststore测试环境农行根证书/cert/trustpay.cer生产环境网上支付平台证书/cert/TrustPayTest.cer测试环境网上支付平台证书其他范例页面和文档参考“信用平台商户接口编程指南-Java_Edition-V2.1.0.doc”备注：由于php接口是对原有java接口基础上的进一步封装，所以需要参考java接口的相关文档和范例农行网上支付平台商户接口编程指南–PHPEdition–V1.0网上支付平台开发小组5of313.安装步骤3.1安装前检查1、本接口软件包采用JDK1.4标准，php5标准，请检查已经安装了php5和jdk1.4或以上版本的jvm。3.2系统配置本文档以jdk1.5.0_18版本为JVM，jakarta-tomcat-5.0.28作为WebServices服务器，axis1.3作为SOAP解析引擎为例，介绍如何在linux平台下构建商户端WebServices服务器环境及部署接口应用。1、下载jakarta-tomcat-5.0.28，解压缩后放置安装目录下，下载axis-src-1_3，将axis文件夹放入$CATALINA_HOME\webapps目录下。注：均已提供在“供参考的Tomcat应用服务器”中。2、安装jdk1.5.0_18。在catalina.sh中设置环境变量：exportJAVA_HOME=/opt/IBM/was6admin/jdk1.5.0_18(根据实际安装路径来设置)exportJAVA_OPTS=-Xms256m-Xmx1024m3、在$CATALINA_HOME\bin下命令行方式下，键入：./catalina.shstart启动服务器，然后在浏览器中键入地址，查看能否正常启动。3.3WebServices接口应用配置1、将银行提供的接口开发软件包TrustPayClient-MARKET-PHP-Vx.x.x.zip（x.x为接口开发软件包的版本号）解压缩到商户自定的安装目录中。2、请参考《农行网上支付平台-商户使用手册V1.0》登录网上支付平台下载商户交易证书，并将商户交易证书保存到服务器的硬盘或签名服务器中。3、将商户的证书文件夹Certificate放入$CATALINA_HOME\bin目录下，包括商户服务器证书*.pfx，农行根证书abc.truststore(生产环境证书，测试环境证书为abctest