农行网上支付平台-交易市场接口编程指南
中国农业银行网上支付平台
交易市场 PHP商户接口编程指南
Java Edition
V1.0
修订历史纪录
日期版本说明作者2009/11/18V1.0初稿童益柱
目录
1.简介3
1.1目的3
1.2功能描述3
1.3总体架构图3
2.接口开发软件包说明4
3.安装步骤5
3.1安装前检查5
3.2系统配置5
3.3Web Services接口应用配置5
3.4配置测试应用6
4.配置文件说明7
5.范例交易说明8
5.1交易流程8
5.1.1Web Services技术的引入8
5.1.2签约和解约交易8
5.2交易开发说明10
5.2.1开发环境的配置10
5.2.2编写web services接口函数10
5.2.3编写php接口19
简介
目的
提供商户端交易网站通过中国农业银行网上支付平台提供的商户端开发软件包实现功能的编程指南。
功能描述
按照本编程指南所描述的标准,商户交易网站可以呼叫调用,支持功能包括签约、解约请求、挂单、撤单交易、实时成交、追加货款交易、确认付款交易、退货交易、批量撤单、批量成交、批量交易结果查询、到期支付,并且具备接收信用支付平台结果响应等功能。
接口采用数字证书的方式来保证商户与信用支付平台间的身份验证、中间信息传递的完整性,以便进行电子商务安全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。
总体架构图
接口开发软件包说明
银行提供的接口开发软件包 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农行网上支付平台商户端Web Services接口范例软件包。/lib/ABCMerchantMperties接口配置文件/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接口的相关文档和范例安装步骤
安装前检查
1、本接口软件包采用JDK 1.4 标准,php5标准,请检查已经安装了php5和jdk1.4或以上版本的jvm。
系统配置
本文档以jdk1.5.0_18版本为JVM,jakarta-tomcat-5.0.28作为Web Services服务器,axis1.3作为SOAP解析引擎为例,介绍如何在linux平台下构建商户端Web Services服务器环境及部署接口应用。
1、下载jakarta-tomcat-5.0.28,解压缩后放置安装目录下,下载axis-src-1_3,将axis文件夹放入$CATALINA_HOME\webapps目录下。
注:均已提供在“供参考的Tomcat应用服务器”中。
2、安装jdk1.5.0_18。在catalina.sh中设置环境变量:
export JAVA_HOME=/opt/IBM/was6admin/jdk1.5.0_18(根据实际安装路径来设置)
export JAVA_OPTS=" -Xms256m -Xmx1024m"
3、在$CATALINA_HOME\bin下命令行方式下,键入:./catalina.sh start启动服务器,然后在浏览器中键入地址:8080/a