电子商务系统商户接入

1、电子商务系统商户接入 软件开发中心 应用开发三部 n商户接入介绍 n商户接口包 n商户接口包部署 n商户接口包部署常见问题 软件开发中心 应用开发三部 软件开发中心 应用开发三部 分行操作员添加商户 给商户添加商户管理员 下载商户管理员证书 商户管理员登陆电子商务商户服务系统 下载服务器证书 下载软件接口包 软件开发中心 应用开发三部 商户软件包-类型 b2c通用支付系统商户软件包 java asp asp.net php（未正式发布） b2b通用支付系统商户软件包 java asp 通用账单支付系统商户软件包 java asp 网上交易市场支付系统商户软件包 java asp php（未正式

2、发布） 基金直销支付系统商户软件包 java 软件开发中心 应用开发三部 abcicon 我行的行标 cert 支付平台证书公钥 电子商务证书信任链 demo 页面及程序开发范例 docs 商户接口编程指南 lib 接口包 配置文件 软件开发中心 应用开发三部 商户接口包部署-java java的应用服务器部署相关web应用 拷贝接口包里的lib目录下的*.jar到web应用的web-inf/lib目 录下，trustpayclient-v*.*.jar, (jcert.jar,jnet.jar,jsse.jar看使用 的jdk是否包含安全包) 拷贝接口包里的lib目录下的.property文

3、件到web应用的 web-inf/classes目录下 根据本地web应用的实际情况修改.property文件的配置内容 拷贝接口包里的demo目录下的全部文件到web应用目录下 启动web应用 访问web应用的merchant.html 访问接口包里的交易范例 软件开发中心 应用开发三部 接口程序包部署-java配置文件 trustpayconnectmethod=https网上支付平台通讯方式 trustpayservername=网上支付平台服务器ip trustpayserverport=443网上支付平台交易端口 trustpaytrxurl=/b2c/trustpay/receiv

4、emerchanttrxreqservlet网上支付平台交易 网址 trustpaycertfile=c:/path/cert/trustpay.cer网上支付平台证书 truststorefile=c:/path/cert/abc.truststore 农行根证书文件 truststorepassword=changeit农行根证书文件密码 merchantid=200902011111111商户编号（电子商务系统商户终端号） logpath=c:/path/logs交易日志文件存放目录 merchantcertfile=c:/path/cert/200902011111111new.pfx

5、商户证书储存目录档名 merchantcertpassword=111111商户私钥加密密码 sign server地址 目前不支持忽略 proxyuse=true proxyhost=6 proxyport=1080代理连接时使用的代理 服务器 软件开发中心 应用开发三部 接口程序包部署-java的demo运行 修改配置文件 重新启动web应用 访问demo里面的html 录入交易模拟数据 提交交易 b2c支付交易开发示例 根据交易处理结果引导客户浏览器的页面 软件开发中心 应用开发三部 接口程序包部署-开发示例-支付交易流程 软件开发中心 应用开发三部 接口程序包部署

6、-开发示例-java-b2c支付交易 取得支付请求所需要的信息，页面的参数 根据页面参数，生成订单对象 生成订单对象，并将订单明细加入定单中（可选信息） 生成支付请求对象 传送支付请求并取得支付网址 根据支付请求对象生成请求的xml报文 使用商户服务器证书merchantcertfile对支付请求报文进行签名 建立同我行网上支付平台交易网址的https连接，需要truststorefile农行根证书文件 将支付请求按照http协议发送给我行网上支付平台 接收我行网上支付平台的响应报文 利用trustpaycertfile（网上支付平台证书）对支付请求响应进行验签 判断支付请求是否处理成功 成功

7、则取得支付的网址 将客户的页面导向到银行的支付页面 软件开发中心 应用开发三部 接口程序包部署-开发示例-java-b2c支付结果接收 两种通知方式 通过显示给消费者的支付结果接收页面通知商户 通过支付平台服务器通知商户 区别 页面通知的方式将支付结果通知给商户，如果消费者的浏览器里安装了一些弹出 窗口拦截软件（例如：3721），就会导致页面无法弹出，商户也就无法接收到通 知消息 采用服务器通知的方法，网上支付平台会将支付结果消息通过服务器直接发送给 商户指定的url，而且发送失败以后可以重复发送，这样就保证了商户可以不受消 费者本地设置的影响，正确的接收到支付结果通知。 服务器通知失败，会调

8、用页面通知方式进行通知 软件开发中心 应用开发三部 接口程序包部署-开发示例-java-b2c支付结果接收 接收服务器通知的页面（serverurl） 取得网上支付平台post 的msg参数 利用此参数生成支付结果对象com.hitrust.trustpay.client.b2c.paymentresult 使用支付结果对象的issuccess()方法辨别支付是否成功 若支付成功，则商户可以使用支付结果对象的getvalue()方法取得下列回传值来进 行后续的作业 若请求失败，可以使用交易结果对象的returncode 及errormessage属性取得交易失 败原因。 该页面的html代码里

9、应该包含一个准备展示给消费者支付结果的url链接（ customerurl），链接之间需要用包含 展示给消费者支付结果信息的页面（customerurl） 根据情况自行开发页面 软件开发中心 应用开发三部 接口程序包部署-java配置文件-多商户模式 配置文件 merchantid=200902011111111，200902012222222，200902013333333 merchantcertfile=c:/path/cert/200902011111111.pfx,c:/path/cert/20090201 2222222.pfx,c:/path/cert/2009020133333

10、33.pfx merchantcertpassword=111111,22222222,33333333 发送请求时附带交易的商户号 trxresponse ttrxresponse = tpaymentrequest.postrequest(); 默认按照第一 个商户发送交易请求 trxresponse ttrxresponse = tpaymentrequest.extendpostrequest(1);按照参 数设定的商户顺序发送交易请求 软件开发中心 应用开发三部 商户接口包部署-asp 确定服务器已经安装了以下软件： microsoft .net framework 1.1或更高的版

11、本 microsoft web services enhancements 2.0 service pack 2 for microsoft .net，用于实现签名验签、ssl连接 执行命令注册接口包的dll 中包含的所有公共类 framework_homeregasm.exe /codebase trustpayclient.dl 配置接口配置文件xxx.ini（ trustmerchant.ini ） 设定系统环境变量 trustmerchantinifile，将ini文件拷贝到此目录 将ini文件拷贝到c:winntsystem32 目录下 打开iis，建立虚拟目录，指向接口软件包解压缩

12、后的demo 启动iis相关站点 访问该站点的merchant.html 访问demo里的交易范例 软件开发中心 应用开发三部 接口程序包部署-a 确定服务器已经安装了以下软件： microsoft .net framework 2.0或更高的版本 microsoft web services enhancements 2.0 service pack 2 for microsoft .net，用于实现签名验签、ssl连接 接口软件包中的demo目录解压缩 bin目录，接口dll文件。 web.config文件，配置文件 merchant.html，入口页面，接口包支持的交易列表 .aspx文

13、件，模拟交易页面 打开iis，建立虚拟目录，指向接口软件包解压缩后的demo 根据本地情况修改web.config文件内容，基本同java配置文件内容。 启动iis相关站点 访问该站点的merchant.html 访问demo里的交易范例 软件开发中心 应用开发三部 接口程序包部署-php 软件开发中心 应用开发三部 接口程序包部署-php-续 接口包部署发布 下载jakarta-tomcat-5.0.28，解压缩后放置安装目录下（$catalina_home） 下载axis-src-1_3，将axis文件夹放入$catalina_homewebapps目录下。 安装jdk1.5.0_18。在

14、tomcat安装目录下的catalina.sh中设置环境变量： export java_home=/xxxx/xxx/jdk1.5.0_18(根据实际安装路径来设置) export java_opts= -xms256m -xmx1024m“ 在$catalina_homebin下命令行方式下，敲入：./catalina.sh start启动服务器，然后在浏览器 中键入地址:8080/axis/，查看能否正常启动 把java接口包和配置文件等发布到axis应用中 将trustmperties文件放置到axis应用的web-infclasses

15、目录下 将接口包文件webservices_xxx_php_vx.x.jar， jcert.jar，jnet.jar，jsse.jar 放入axis应用的 web-inflib目录下。 web services配置文件server-config.wsdd放入axis应用的web-inf中 修改$catalina_homewebappsaxisweb-inf的web.xml文件，添加log4j初始化的servlet配 置，并在该目录下建立文件夹config，放置perties配置文件（该文件中，可以指 定web services段代码日志输出格式及输出地址）。这里我们默认的日志

16、是放在 $catalina_homelogs下 重新启动tomcat 修改php.ini配置文件，添加对soap的支持，具体做法是：将extension=php_soap.dll前的注释字 符删除； 通过php调用web services接口，从而与网上支付平台进行交互。 软件开发中心 应用开发三部 接口程序包部署-软件包的卸载 java 删除web-inf/lib目录下的农行接口软件包提供的jar 删除web-inf/classes目录下的配置文件property 删除web-inf目录下的demo文件 asp 在接口软件包安装目录lib 下执行以下的命令移除trustpayclient.d

17、ll 在系统中的公共类注册 framework_homeregasm.exe /unregister trustpayclient.dll 删除接口软件包安装目录 删除配置文件xxx.ini a 删除web站点bin目录下的接口包dll文件 删除web.config文件里面相关的配置项 删除站点中的模拟交易页面（aspx） php jakarta-tomcat-5.0.28-b2c目录下所有文件 部署在php server 的所有的demo文件（html及php demo文件） 软件开发中心 应用开发三部 接口程序包常见错误及解决方法 1、无法连接（适用所有接口包） 一般表现： 页面提示信息“

18、1202无法连线网上支付平台”； 页面提示信息“无法连接443端口”； 原因分析： 商户服务器网络环境不通； 商户服务器网络环境权限控制引起； 问题解决思路： 在商户服务器上用浏览器访问，查看网络是否通畅，如果没有问题，可能是防火 墙或者其他网络设置阻止了通讯，需要商户根据实际情况去查找具体原因； 软件开发中心 应用开发三部 接口程序包常见错误及解决方法-续 2、提示出现无法预期的错误 一般表现： 提示出现无法预期的错误 问题原因： asp 本接口软件包采用microsoft .net framework 1.1 标准，确认安装了microsoft .net framework 1.1或更高的

19、版本 a 本接口软件包采用microsoft .net framework 2.0标准，确认安装了microsoft .net framework 2.0或更高的版本 java 本接口软件包采用jdk 1.3 标准。请确定服务器已经安装了下列软件：sun jsse v1.0 或更高的版本，具体需要的jar包为（ jcert.jar、 jnet.jar、 jsse.jar） 解决办法： 根据接口包的要求，准备基础的运行环境。 3、wse2.0安装不上 请上microsoft官方网站查找问题解决办法； 软件开发中心 应用开发三部 接口程序包常见错误及解决方法-续 4、无法读取证书文档 一般表现：

20、页面提示信息：trustpayclient 错误 80131500 无法读取证书文档； 原因分析： 配置文件中提到3个证书文档（网上支付平台证书、农行根证书文件和商户证书储存目录档名 ），能够引起这种错误的情况很多，主要是以下几种： 证书文档路径不正确； 权限不够； 证书文档密码不正确； 其他原因； 问题解决思路： 检查配置文件中各个证书文件的路径 检查密码是否正确，在windows环境下双击证书文件，会提示是否导入到浏览器，然后输入配 置的密码验证是否能到下一步； 检查这三个证书文件是否给asp.net用户读的权限； 检查其他情况，主要是商户服务器的操作系统和网络环境权限设置等； 软件开发中

21、心 应用开发三部 接口程序包常见错误及解决方法-续 5、返回报文签名验证失败 一般表现： 页面提示信息：签名验证失败“2302”； 原因分析： 商户号和证书文件不匹配； 其他原因； 问题解决思路： 检查商户号和证书文件是否匹配； 问题解决思路： 确认配置里面的商户号与商户服务器证书是否一致。可以双击在windows环境下双 击服务器证书文件，导入浏览器之后，查看证书信息的主题， cn = b2c.b2cmerchant.2110000000000000s.200902011111111.0006，倒数第二项就是商 户终端号。 软件开发中心 应用开发三部 接口程序包常见错误及解决方法-续 6、商

22、户不存在 一般表现： 商户发起交易请求，返回错误商户不存在 原因分析： 商户号配置不对 开通相关交易的商户终端号 非pos商户号 非电子商务支付平台商户号 商户接入的环境同商户所开立的环境不一致 测试环境开立的商户只能连接测试环境 生产环境开立的商户只能连接生产环境 非测试状态的商户连接测试环境 问题解决思路： 配置正确的商户号 连接正确的域名 软件开发中心 应用开发三部 接口程序包常见错误及解决方法-续 7、验证网上支付平台返回报文签名失败 一般表现： 交易返回错误信息：验证网上支付平台返回报文签名失败 原因分析： 验证签名的证书配置不对 返回报文被篡改 商户的应用服务器的默认语言为非简体中

23、文 返回报文不完整，没有签名域 问题解决思路： 配置正确的验签证书，生产环境使用trustpay.cer，培训环境使用trustpaytest.cer 调整应用服务器的默认语言为简体中文 查看接口包产生的日志，是否因为某种原因造成响应报文没有签名就返回，具体错误原因查看 没有签名的返回报文里面信息。 软件开发中心 应用开发三部 接口程序包常见错误及解决方法-续 8、商户服务器证书无效 一般表现： 交易提交产生错误信息：商户服务器证书无效 原因分析： 导出的商户服务器证书格式不对，导出证书的时候连同私钥一同导出，只导出公钥是无效的。 导出后的证书后缀是 .pfx。 问题解决思路： 重新导出pkcs12格式的证书 9、无法写入交易日志文档 一般表现： 交易提交产生错误信息：无法写入日志文档 原因分析： 商户配置文件中没有指明日志文档路径 日志文件夹没有手工建立好 问题解决思路： 配置日志文档路径信息 手工建立好日志文件夹 软件开发中心 应用开发三部 接口程序包常见错误及解决方法-续 10、类型初始值设定引发异常 一般表现： 页面提示信息：80131534“com.hitrust.trustpay.client.merchantconfig”的类型初始值设定项 引发异常； 原因分析： wse没有安装； wse版本问题； 其他原因； 问题解决思路： 检查