发布时间 : 星期四 文章(转账模式)网上交易市场支付平台商户接口编程指南-Java_Edition-V3.0.1更新完毕开始阅读3f2a67b8f121dd36a32d8213
<商户接口编程指南>
3) 将lib目录下的EMarketClient -Vx.x.jar、commons-codec-1.3.jar、commons-httpclient-3.0.1.jar、
dom4j-1.6.1.jar,jsse.jar加入应用服务器的CLASSPATH中。
3.3 接口开发软件包配置
开启接口配置文件ABCMerchantMarket.properties，依照银行提供的信息设定相对应的参数。并将ABCMerchantMarket.properties所在的目录加入应用服务器的CLASSPATH中。详细配置文件的说明请参考下一章的说明。
3.4 配置测试应用
1) 配置WebApp，指向接口软件包安装目录\\demo。
2) 开启浏览器进入 http://your.server.name/your.virtual.directory/Merchant.html，确定接口软件
包是否已正确安装及配置。
4 配置文件说明
配置段 参数名称 数值类型 说明 网上交易市场支付平台通讯方式 TrustPayConnectMethod 字符串 http：使用HTTP通讯方式 https：使用HTTPS通讯方式（必需） 网上交易市场支付平台 系统配置段 *请依照银行的指示设定 TrustPayServerName TrustPayServerPort TrustPayNewLine TrustPayServerTimeOut TrustPayTrxURL TrustPayCertFile TrustStoreFile TrustStorePassword 商户资料段 MerchantID LogPath MerchantKeyStoreType 商户系统配置段 MerchantCertFile MerchantCertPassword 字符串 字符串 字符串 数字 数字 数字 字符串 字符串 字符串 字符串 字符串 字符串 数字 网上交易市场支付平台服务器名 可以使用服务器的域名或服务器的IP地址 网上交易市场支付平台交易端口 网上交易市场支付平台接口特性 1 或 2 网上交易市场支付平台服务超时时间 毫秒 网上交易市场支付平台交易网址 网上交易市场支付平台证书 农行根证书文件 农行根证书文件密码 商户编号 日志文件存放绝对目录。*请勿输入文件名 证书储存媒体 0: File 1: 硬件签名服务器 商户证书储存目录档名 当KeyStoreType=0时，必须设定。 必须为PKCS#12的文件格式。 商户私钥加密密码 ? Copyright ABC. 2008 第 3 页
<商户接口编程指南>
当KeyStoreType=0时，必须设定。 SignServerIP SignServerPort SignServerPassword 字符串 数字 字符串 签名服务器IP地址 当KeyStoreType=1时，必须设定。 签名服务器端口 当KeyStoreType=1时，必须设定。 签名服务器密码 当KeyStoreType=1时，必须设定。 5 交易说明
农行网上交易市场支付平台商户接口采用面向对象的方式设计，商户在交易的过程中会需要使用到各个不同的类来完成所需要的交易。交易流程
本节将说明商户交易平台如何与网上交易市场支付平台通信，来完成交易的过程。
5.1 交易流程说明
5.1.1 客户发起交易
客户发起交易，指客户通过商户交易网站完成的交易，此类交易需要由客户发起，商户交易网站在收到客户交易请求后，把请求发送到银行系统，接收银行系统返回结果，同时通知客户交易结果。此类交易主要有：签约、解约、挂单、撤单、追加货款、确认付款、实时支付、客户授权、账单支付等等。交易流程如下图所述（签约、解约为例）：
? Copyright ABC. 2008 第 4 页
<商户接口编程指南>
5.1.2 商户发起交易
商户发起交易，指不需要客户的参与，由商户交易系统自行发起的交易请求。此类交易包括有：付款、实时支付交易以及各种查询交易等等。交易流程分别如下图所述：
5.2 交易说明
1) 客户签约、解约请求交易
客户在交易市场网站上，选择签约、解约交易。 2) 实时支付交易
客户在交易市场网站上，交纳会员费时，选择实时支付由客户发起请求。 3) 账单申请交易
交易市场填写相关信息，发起账单申请交易请求，。 4) 账单支付交易
客户在交易市场网站上，选择账单发起账单支付请求。
5.2.1 签约请求
客户由交易市场发起签约交易，用于客户、商户与电子商务网上交易市场平台的相关协议，电子商务平台对客户、商户进行身份验证并记录签约信息，步骤说明如下：
1，生成签约请求对象
包：com.hitrust.trustpay.client.market 类名：SignUpRequest
SignUpRequest tRequest = new SignUpRequest(); 2，设置签约请求对象属性
RequestID 交易请求流水号（必要信息）
MerchantID 交易市场在农行的注册商户号（必要信息） MerchantName 交易市场在农行的注册名称（必要信息）
NeedTwoCheck 双人复核标志（值“2”为需要双人复核，可选） CustSignInfo 客户签名信息 （必要信息）
? Copyright ABC. 2008 第 5 页
<商户接口编程指南>
tRequest.setCustSignInfo(tCustSignInfo); //设置客户签名信息（必要信息） tRequest.setRequestID(tRequestID); //设置请求流水号（必要信息） tRequest.setBusinessID(IBusinessType.MARKET); // 设置交易类型 tRequest.setFunctionID(IFunctionID.MARKET_SIGNUP);//设置交易ID tRequest.setCustName(tCustName); //设置客户名称（必要信息） tRequest.setMerchantName(tMerchantName); //设置交易市场名称（必要信息） tRequest.setNeedTwoCheck(tNeedTwoCheck); //设置是否需要双人复核标志 3，调用签约请求对象的postRequest()方法传送签约请求并取得交易结果对象 4，使用交易结果对象的isSuccess()方法辨别交易是否成功
5，若交易成功，则商户可以取得交易结果对象的其他属性来进行后续的作业 ReturnMsg 签约返回信息
6, 若交易失败,使用交易结果对象的getReturnCode ()及getErrorMessage()方法取得交易失败原因。
7, 交易结果对象的getReturnCode ()所回传的响应码请参考《附录二、响应码一览表》的说明。
5.2.2 解约请求
客户由交易市场发起解约交易，用于客户、商户与银行电子商务网上交易市场平台相关协议，电子商务网上交易市场平台对客户、商户进行身份验证并记录解约信息，步骤说明如下：
1，生成解约请求对象
包：com.hitrust.trustpay.client.market 类名：SignUpRequest
SignUpRequest tRequest = new SignUpRequest(); 2，设置解约请求对象属性
RequestID 交易请求流水号（必要信息） CustSignInfo 客户户签名信息 （必要信息） MerchantID 商户农行注册商户号（必要信息） MerchantName 商户农行注册商户名（必要信息） Customer 客户号（必要信息） CustName 客户名（必要信息）
tRequest.setCustSignInfo(tCustSignInfo); //客户签名信息（必要信息） tRequest.setRequestID(tRequestID); //请求流水号（必要信息） tRequest.setCustomer(tCustomer); //设置客户号
tRequest.setBusinessID(IBusinessType.MARKET);//设置交易类型
tRequest.setFunctionID(IFunctionID.MARKET_SIGNOFF);//设置交易ID tRequest.setCustName(tCustName); //客户名称（必要信息） tRequest.setMerchantName(tMerchantName); //交易市场名称（必要信息） 3，调用解约约请求对象的postRequest()方法传送解约请求并取得交易结果对象
? Copyright ABC. 2008 第 6 页