(转账模式)网上交市场支付平台商户接口编程指南-Java_Edition-V3.0.1.doc

商户端Java接口编程指南 编号 项目 电子商务网上交易市场平台项目 类别 项目 密级 内部 修订记录 日期 版本 修订目的描述 作者 2007-05-23 1.00 文档初建 电子商务组 2008-11-26 2.00 文档修改 李靖 2010-03-20 3.00 文档修改 李靖 2010-04-17 3.01 文档修改 李靖 目录 1 简介 1 1.1 目的 1 1.2 功能描述 1 1.3 总体架构图 1 2 接口开发软件包说明 2 3 安装步骤 2 3.1 安装前检查 2 3.2 接口开发软件包安装 2 3.3 接口开发软件包配置 3 3.4 配置测试应用 3 4 配置文件说明 3 5 交易说明 4 5.1 交易流程说明 4 5.1.1 客户发起交易 4 5.1.2 商户发起交易 5 5.2 交易说明 5 5.2.1 签约请求 5 5.2.2 解约请求 6 5.2.3 实时支付交易 7 5.2.4 付款交易 7 5.2.5 账单申请 8 5.2.6 账单支付 9 5.2.7 手续费查询 9 5.2.8 修改客户结算账户 10 5.2.9 交易资金专用账户余额查询 10 5.3 程序范例 11 5.3.1 签约交易范例 11 5.3.2 解约交易范例 13 5.3.3 实时支付交易范例 16 5.3.4 退/付款交易范例 18 5.4 报文结构说明 20 5.5 交易代码含义对照表 21 5.6 主机交易响应代码含义对照表 21 5.7 商户端接口包本地错误代码含义对照表 25 简介 目的 提供给商户交易网站开发人员，根据中国农业银行网上交易市场支付平台提供的商户端开发软件包实现功能的编程指南。 功能描述 按照本编程指南所描述的标准，商户交易网站可以呼叫调用银行提供的交易接口功能，并且具备接收银行系统结果响应等功能。 接口采用数字证书的方式来保证商户与网上交易市场支付平台间的身份验证、中间信息传递的完整性，以便进行电子商务安全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。 总体架构图 接口开发软件包说明 银行提供的接口开发软件包 EMarketClient-Java-Vx.x.x.zip（x.x.x为接口开发软件包的版本号）包含下列文档。 文件名称 说明 /docs/网上交易市场平台商户接口编程指南-Java-Edition-Vx.x.x.doc 本文件 /lib/EMarketClient-Vx.x.x.jar 农行网上交易市场支付平台商户端接口Java软件包 /lib/commons-codec-1.3.jar 农行网上交易市场支付平台商户端接口Java软件包依赖包 /lib/commons-httpclient-3.0.1.jar 农行网上交易市场支付平台商户端接口Java软件包依赖包 /lib/dom4j-1.6.1.jar 农行网上交易市场支付平台商户端接口Java软件包依赖包 /lib/jsse.jar 农行网上交易市场支付平台商户端接口Java软件包依赖包 /lib/ABCMerchantMperties 接口配置文件 /demo/Merchant.html 接口范例首页 /demo/SignUpQuery.html 签约范例页面 /demo/SignUpQuery.jsp 签约范例程序 /demo/SignOffQuery.html 解约范例页面 /demo/SignOffQuery.jsp 解约范例程序 /demo/PayQuery.html 实时支付交易范例页面 /demo/PayQuery.jsp 实时支付交易范例程序 /cert/abc.truststore 农行根证书 /cert/trustpay.cer 网上交易市场支付平台证书 /ABCIcon/*.jpg 用于商户在自行开发的页面上，如果有指向农行网站的图片链接，请使用这些图片做为农行标识。注意：图片的整体尺寸可以根据需要进行缩放，但是图片的内容和比例大小不能修改。 安装步骤 安装前检查 本接口软件包采用JDK 1.5 标准。 请确定服务器已经安装了下列软件：Sun JSSE V1.0 或更高的版本 接口开发软件包安装 将银行提供的接口开发软件包 EMarketClient-Java-Vx.x.x.zip（x.x.x为接口开发软件包的版本号）解压缩到商户自定的安装目录中。 请参考《农行网上交易市场支付平台 -商户使用手册 V1.0》登录网上交易市场支付平台下载商户交易证书，并将商户交易证书保存到服务器的硬盘或签名服务器中。 将lib目录下的EMarketClient -Vx.x.jar、commons-codec-1.3.ja