广州银联网络支付有限公司支付网关商户接口标准银联在线支付)

1、广州银联网络支付有限公司广州银联网络支付有限公司广州银联网络支付有限公司广州银联网络支付有限公司支付网关商户接口标准（银支付网关商户接口标准（银支付网关商户接口标准（银支付网关商户接口标准（银联在线支付）联在线支付）联在线支付）联在线支付）文档属性文档名称：广州银联网络支付有限公司支付网关商户接口标准（银联在线支付项目名称：版本号：3.4文档编号：pg-20040426001撰写者：技术管理部日期：2012-1-8复核者：日期：负责者：日期：审批者：日期：版本历史：版本号修改内容撰写者发布日期版权声明：此文档的版权归广州银联网络支付有限公司所有，作为本系统的最终用户，可以拥有该份文档的使用权，

2、但未征得广州银联网络支付有限公司的书面批准，不得向第三方借阅、出让、出版该文档。 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司2目录目录-1.文档介绍文档介绍.41.1.读者对象.41.2.参考文献.41.3.术语与缩写解释.42.商户接口概述商户接口概述.52.1.接口结构图.52.2.支付接口.62.2.1.支付数据流程图.62.2.2.支付数据流程解释.72.3.数字信封.82.3.1.数字信封格式.82.3.2.数字信封格式示例.82.3.3.订单数据.92.3.4.订单数据示例.92.3.5.支付结果数据.92.3.6.支付结果数据示

3、例.102.3.7.后台发送支付结果数据.102.3.8.对账结果数据.102.3.9.对账结果数据示例.112.3.10.对账结果数据的签名及数据格式.112.3.11.支付结果响应码.123.商户端部署指南商户端部署指南.153.1.系统环境.154.com 版商户接口函数版商户接口函数.164.1.接口函数.164.1.1.encryptmsg().164.1.2.decryptmsg().174.1.3.signmsg().174.1.4.verifymsg().184.1.5.getresult().184.1.6.lastresult属性.194.1.7.lasterrmsg属性.

4、204.1.8.currver属性.205.net 版商户接口函数版商户接口函数.215.1.接口函数.21 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司35.1.1.encryptmsg().215.1.2.decryptmsg().225.1.3.signmsg().235.1.4.verifymsg().245.1.5.getresult().245.1.6.getcurrver().256.java 版商户接口函数版商户接口函数 .266.1.接口函数.266.1.1.encryptmsg().266.1.2.decryptmsg().

5、276.1.3.signmsg().276.1.4.verifymsg().286.1.5.getresult().286.1.6.lastresult属性.296.1.7.lasterrmsg属性.306.1.8.currver属性.306.1.9.settestserver (boolean istestserver)方法.306.1.10.setconvertencode(boolean isconvertencode)方法.316.2.关于 java加密扩展的出口限制（njce 版）.316.2.1.替换程序包.316.2.2.生成gpk文件.316.2.3.调用商户接口.327.ph

6、p 版商户接口函数版商户接口函数.337.1.接口函数.347.1.1.encryptmsg().347.1.2.decryptmsg().357.1.3.signmsg().367.1.4.verifymsg().377.1.5.getresult().387.1.6.lastresult属性.397.1.7.lasterrmsg属性.397.1.8.currver属性.397.2.密钥文件转换说明.408.错误代码错误代码.419.渠道参数表渠道参数表.42 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司41.1.1.文档介绍文档介绍文档介绍

7、文档介绍1.1. 读者对象读者对象商户系统设计人员、编程人员及测试人员1.2. 参考文献参考文献银行卡联网联合技术规范rsa security lab: rsa cryptography faq中国人民解放军总参谋部 56 所 sjy42 证书服务器密码机使用说明1.3. 术语与缩写解释术语与缩写解释缩写、术语解 释安全服务器主要的功能是通过硬件方式实现各种密码算法，安全保存密钥及发放证书，安全服务器采取了多种安全措施，能够安全的保存一些重要的密钥，特别适合于对密钥安全性要求特别高的应用。verisign 证书银联向美国 verysign 公司申请的，用来向顾客认证银联支付网关唯一性的证书。该

8、证书能够使用内置于 internet explore 浏览器中的verysign 公司的根证书进行认证，顾客无需安装银联服务器证书。商户证书银联通过安全服务器给商户颁发的数字签名证书。银联通过安全服务器认证商户的商户证书，该证书的有效期为一年。支付接口银联颁发给商户的服务器端控件，用于通过安全的方式传送订单数据到银联及接收银联实时返回的支付结果。对账接口银联颁发给商户的服务器端控件，用于批量接收符合商户查询条件的支付结果。订单管理系统银联提供给商户的基于 b/s 结构的订单管理界面。 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司52.2.2.商

9、户接口商户接口商户接口商户接口概述概述概述概述2.1. 接口结构接口结构图图接口结构商户接口api支付接口对帐接口openvendor.pkiopenvendor.getpayresultasp示例程序vb示例程序商户数字签名证书订单管理系统文档 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司62.2. 支付接口支付接口2.2.1.支付数据流程支付数据流程图图商户系统银联在线银联支付网关4.传送订单数据1.生成订单支付数据流程7.生成支付单8.传送支付单数据9.执行支付10.返回支付结果13.返回支付结果16.显示支付结果给用户2.使用银联公钥加

10、密3.使用商户私钥签名5.使用银联私钥解密6.验证对方签名11.使用商户公钥加密12.使用银联私钥签名14.使用商户私钥解密15.验证对方签名 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司72.2.2.支付数据流程解释支付数据流程解释1、用户在商户系统生成订单；2、商户系统使用银联证书的公钥对订单数据进行加密；3、商户系统使用商户证书的私钥对订单数据进行数字签名，数字签名中包括商户证书的公钥及商户系统当前时间，加密后的订单数据+订单数据数字签名构成一份订单数字信封；4、商户系统通过表单方式将订单数字信封下载到用户浏览器，并通过用户浏览器自动提交

11、到银联在线；5、银联在线接收到订单数字信封后，使用银联证书的私钥对加密后的订单数据进行解密；6、银联在线使用商户证书验证订单数据数字签名的合法性（用于签名的证书是否有效及证书序列号是否一致） ；7、银联在线生成支付单；8、银联在线传送支付单数据至支付网关，并引导用户进入支付网关；9、用户在支付网关输入银行卡信息（银行卡号、卡密码、信用卡有效期、证件号码）执行支付；10、支付完毕后，向用户显示支付结果，并弹出一个新窗口将支付结果返回给银联在线；11、银联在线接收到支付结果后，使用商户证书的公钥对支付结果数据进行加密；12、银联在线使用银联证书的私钥对订单数据进行数字签名，数字签名中包括银联证书的

12、公钥及银联在线当前时间，加密后的订单数据+订单数据数字签名构成一份支付结果数字信封；13、银联在线通过表单方式将支付结果数字信封下载到用户浏览器，并通过用户浏览器自动提交到商户系统；14、商户系统接收到支付结果数字信封后，使用商户证书的私钥对加密后的支付结果数据进行解密；15、商户系统使用银联证书验证订单数据数字签名的合法性（用于签名的证书是否有效及证书序列号是否一致） ；16、商户系统将支付结果输出到用户浏览器，并根据支付结果为用户提供产品或服务。 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司82.3. 数字信封数字信封2.3.1.数字信封格

13、式数字信封格式订单数字信封包括 encodemsg、signmsg 二部分，均由订单数据或支付结果数据产生而成。1、如为订单数据，使用银联证书公钥对订单数据加密产生 encodemsg 域，使用商户证书私钥对订单数据签名产生 signmsg 域；2、如为支付结果数据，使用商户证书私钥对 encodemsg 域解密产生支付结果数据，再使用银联证书公钥对 signmsg 域进行合法性验证；二个域将通过隐藏表单下载到用户浏览器，并由用户浏览器自动提交到数字信封接收方。域名称长度类型说明encodemsg无限制base64 字符串加密后订单数据signmsg无限制base64 字符串订单数据数字签名2

14、.3.2.数字信封格式示例数字信封格式示例 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司92.3.3.订单数据订单数据订单数据是指构造成订单数字信封的原始数据，由各个数据元订单数据是指构造成订单数字信封的原始数据，由各个数据元组成，每个数据元由（数据元名称组成，每个数据元由（数据元名称= =数据元值）组成，各个数据数据元值）组成，各个数据元之间使用字符串元之间使用字符串& &进行分隔。进行分隔。数据元名称长度类型说明merid3字符串商户 idordernomax(20)字符串商户订单号（要求唯一）orderamountmax(12)字符串订单

15、金额，格式：元.角分currcodemax(3)字符串货币代码，值为：cnycallbackurlmax(400)字符串支付结果接收 urlresultmode1字符串支付结果返回方式0=成功和失败支付结果均返回1=仅返回成功支付结果bankcode,8字符串填”00010000”reserved01max(100)字符串保留域 1reserved02max(100)字符串保留域 22.3.4.订单数据示例订单数据示例2.3.5.支付结果数据支付结果数据支付结果数据是指构造成支付结果数字信封的原始数据，由各支付结果数据是指构造成支付结果数字信封的原始数据，由各个数据元组成，每个数据元由（数据元

16、名称个数据元组成，每个数据元由（数据元名称= =数据元值）组成，数据元值）组成，merid=001&orderno=20031106100001&orderamount=59.32& currcode=cny&callbackurl=http:/ resultmode=0& reserved01=&reserved02= 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司10各个数据元之间使用字符串各个数据元之间使用字符串& &进行分隔。进行分隔。数据变量名长度类型说明ordernomax(20)字符串商户订单号payno6字符串支付单号payamo

17、untmax(12)字符串支付金额，格式：元.角分currcodemax(3)字符串货币代码systemssnmax(15)字符串系统参考号respcode2字符串响应码settdate4字符串清算日期，格式：月月日日reserved01max(100)字符串保留域 1reserved02max(100)字符串保留域 22.3.6.支付结果数据示例支付结果数据示例2.3.7.后台发送支付结果数据后台发送支付结果数据1.商户可以增加一个后台支付结果接收页面，用来接收处理广州银联网络支付有限公司通过服务器发送的支付结果。2.商户在自己服务器增加的后台支付结果接收页面，接收到的数据跟 2.3.5 支

18、付结果数据相同。区别在于处理完数据后不需要再显示支付结果给客户，而是直接输出ok给银联网络服务器端。银联网络接收到ok后将不再发送，否则将一直发送到原来设置的发送次数上限。3.商户如果需要该功能，需要通过书面方式提交后台支付结果接收页面的 url 和后台发送次数上限给银联网络业务人员进行设置。2.3.8.对账结果数据对账结果数据对账结果数据是指构造成对账结果的数据，每条记录用对账结果数据是指构造成对账结果的数据，每条记录用 chr(10)chr(10)分分orderno=20031106100001&payno=103450&payamount=59.32& currcode=cny&syst

19、emssn=120034120034&respcode=00&settdate=1106&reserved01=&reserved02= 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司11隔，每列用隔，每列用nn 分隔分隔订单的格式：订单日期订单的格式：订单日期nn 支付金额支付金额nn 商户订单号商户订单号nn 支付单号支付单号nn 系统参考号系统参考号nn 响应码响应码nn数据变量名长度类型说明shoppingdate8字符串交易日期（yyyymmdd）payamountmax(12)字符串支付金额，格式：元.角分ordernomax(20)

20、字符串商户订单号payno24字符串交易日期-商户终端号-支付单号systemssnmax(15)字符串系统参考号respcode2字符串响应码2.3.9.对账结果数据示例对账结果数据示例2.3.10. 对账结果数据的签名及数据格式对账结果数据的签名及数据格式有商户提到我司提供的对账结果数据中无签名，比较担心拿到的对账结果数据的可信度。对此，我司提供一个新的对账结果数据查询 url（路径与以前的 url 相同，只是由getpayresult.asp 改为 getpayresultsign.asp） ，商户只需用新的 url 替换即可。返回数据时第一行（256 字节）为签名数据，行分隔符之后即为

21、对账结果明文数据（不包含第一行之后的行分隔符） 。验签时，通过调用本接口中提供的 verifymsg()对对账结果数据进行签名验证。其中certfile 为我司提供的证书文件路径。20040426n12.34n20040426100001n20040326-99800001-100001n100001100001n00n 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司12返回的数据格式与以前的定义相同，但是为了提供一定的灵活度，可以对行、列分隔符进行定制。定义如下：参数名类型说明filespliter字符串作为每列数据的分隔符，不设置则为原来的“

22、n”rowspliter字符串作为每行数据的分隔符，不设置则为原来的chr（10）例如，在接口配置文件中将 getresulturl 设为：http:/ 支付结果响应码支付结果响应码codeaction含 义显示内容00approve承兑或交易成功交易成功01decline查发卡方交易失败，请联系发卡行02decline查发卡方的特殊条件交易失败，请联系发卡行03decline无效商户交易失败，请联系发卡行04pick-up没收卡交易失败，请联系发卡行05decline不予承兑交易失败，请联系发卡行06decline出错交易失败，请联系发卡行07pick-up特殊条件下没收卡交易失败，请联系发

23、卡行09decline请求正在处理中交易失败，请重试12decline无效交易交易失败，请联系发卡行13decline无效金额金额有误，请重试14decline无效卡号（无此账号）无效卡号，请换卡重试15decline无此发卡方此卡不能受理17decline拒绝但不没收卡交易失败，请联系发卡行19decline重新送入交易交易失败，请重试20decline无效响应交易失败，请联系发卡行21decline不能采取行动交易失败，请联系发卡行22decline -故障怀疑操作有误，请重试23decline不可接受的交易费交易失败，请联系发卡行25decline找不到原始交易交易失败，请联系发卡行30

24、decline格式错误交易失败，请联系发卡行31decline交换中心不支持的银行此卡不能受理33decline过期的卡卡片过期，请联系发卡行 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司13codeaction含 义显示内容34pick-up有作弊嫌疑交易失败，请联系发卡行35pick-up受卡方与代理方联系（没收卡）交易失败，请联系发卡行36pick-up受限制的卡此卡有误，请换卡重试37pick-up受卡方电话通知代理方安全部门交易失败，请联系发卡行38decline超过允许的 pin 试输入密码错误次数超限39decline无贷记账户交

25、易失败，请联系发卡行40decline请求的功能尚不支持交易失败，请联系发卡行41pick-up挂失卡交易失败，请联系发卡行42decline无此账户交易失败，请联系发卡行43pick-up被窃卡交易失败，请联系发卡行44decline无此投资账户交易失败，请联系发卡行51decline资金不足余额不足，请查询52decline无此支票账户交易失败，请联系发卡行53decline无此储蓄卡账户交易失败，请联系发卡行54decline过期的卡卡片过期，请联系发卡行55decline不正确的 pin密码错，请重试56decline无此卡记录交易失败，请联系发卡行57decline不允许持卡人进行的

26、交易该卡不支持此项服务，请联系发卡行58decline不允许终端进行的交易交易失败，请联系发卡行59decline有作弊嫌疑交易失败，请联系发卡行60decline受卡方与代理方联系（不没收卡）交易失败，请联系发卡行61decline超出金额限制金额超限62decline受限制的卡交易失败，请联系发卡行63decline侵犯安全交易失败，请联系发卡行64decline原始金额错误交易失败，请联系发卡行65decline超交易次数交易失败，请联系发卡行66decline受卡方通知受理方安全部门交易失败，请联系发卡行67pick-up强行受理（要求在自动会员机上没收此卡）交易失败，请联系发卡行68

27、decline接收的响应超时交易超时，请稍后重试75decline允许的输入 pin 次数超限密码错误次数超限76decline无效账户交易失败，请联系发卡行77decline此卡需密码交易失败，请联系发卡行78decline无效终端交易失败，请联系发卡行90decline正在日终处理（系统终交易失败，请稍后重试 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司14codeaction含 义显示内容止一天的活动，开始第二天的活动，交易在几分钟后可再次发送）91decline发卡方不能操作交易失败，请稍后重试92decline金融机构或中间网络设施找

28、不到或无法达到交易失败，请稍后重试93decline交易违法、不能完成交易失败，请联系发卡行94decline重复交易交易失败，请稍后重试95decline核对差错交易失败，请稍后重试96decline交换中心系统异常、失效交易失败，请稍后重试97decline无此终端交易失败，请稍后重试98decline交换中心收不到发卡方应答交易超时，请稍后重试99declinepin 格式错交易失败，请稍后重试a0declinemac 鉴别失败交易失败，请稍后重试a2approve交换中心转发了原交易请求，但未收到发卡方应答时，交换中心直接向受理方应答为有缺陷的成功交易交易结果请查询发卡行bfdecli

29、ne 深银联支付号/授权码与银行卡号不匹配交易失败，请联系发卡行xxdecline超时已冲正交易失败，请稍后重试 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司153.3.3.商户端部署指南商户端部署指南商户端部署指南商户端部署指南3.1. 系统环境系统环境接口版本接口版本操作系统操作系统/ /系系统平台统平台开发开发语言语言备注备注comcom 版本版本windowswindows nt4.0nt4.0windowswindows 20002000aspaspvbvbmicrosoftmicrosoft .net.net 版本版本.net.ne

30、t frameworkframework 2.0/3.0/3.52.0/3.0/3.5c#.nec#.net tvb.nevb.net tjavajava 版本版本jrejre .1jrejre .2jrejre 1.5.01.5.0javajavaphpphp（注：如果使用（注：如果使用 jre1.3.1jre1.3.1 版本，版本，需要把需要把 jce-1_2_2.zipjce-1_2_2.zip 解压后解压后得到的得到的 jce1.2.2jce1.2.2 目录下目录下 liblib 文文件夹中的四个件夹中的四个 jarjar 文件拷贝到文件拷贝到jre1.

31、3.1jre1.3.1 安装目录的安装目录的 liblib 文件文件夹中的夹中的 extext 文件夹下面，并在文件夹下面，并在extext 同级目录的同级目录的 securitysecurity 文件文件夹中修改夹中修改 java.securityjava.security 文件，文件， 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司16在其中添加在其中添加vider.3=vider.3=vider.sunjce.vider.s

32、unjce）javajava 版本版本（njcenjce）jrejre .2jrejre 1.5.01.5.0javajava解决了解决了 javajava 加密扩展的出口限加密扩展的出口限制，而且商户无法修改安全策制，而且商户无法修改安全策略文件的情况。且修改了略文件的情况。且修改了 bcbc 包包的命名空间，防止与商户系统的命名空间，防止与商户系统中的其它版本的中的其它版本的 bcbc 包产生冲突。包产生冲突。对于采用对于采用 javajava 环境的商户，建环境的商户，建议采用议采用 njcenjce 版。版。phpphp 版本版本php4.4.8php4.4.8 及及其

33、以上版本其以上版本phpphp私钥文件只支持私钥文件只支持 pempem 格式，需格式，需采用工具将采用工具将 pfxpfx 转换为转换为 pempem 格格式式 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司174.4.4. 银联在线支付商户端银联在线支付商户端银联在线支付商户端 logologologo 使用说明使用说明使用说明银联在线支付银联在线支付 logologo：使用方式请参考附件使用方式请参考附件“银联在线支付银联在线支付”品牌标识布放规范品牌标识布放规范 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银

34、联网络支付有限公司185.5.5.comcomcom 版商户接口函数版商户接口函数版商户接口函数版商户接口函数对象名称对象名称方法方法/ /属性属性功能功能encrencry yptptm ms sg g( () )方法方法数字信封加密数字信封加密decrdecry yptptm msg(sg() )方法方法数字信封解密数字信封解密signmsgsignmsg( () )方方法法数字信封签名数字信封签名verifymsg()verifymsg()方方法法数字信封验证签名数字信封验证签名getresult()getresult()方法方法获取订单数据获取订单数据lastresulastresul

35、 lt t属性属性上次调用后的返回结果上次调用后的返回结果lasterrmslasterrmsg g属性属性上次调用后的出错信息上次调用后的出错信息openvendorvopenvendorv34.nettran34.nettrancurrvecurrver r 属性属性控件版本控件版本 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司195.1. 接口函数接口函数5.1.1.encryptmsg()功能：功能：对数字信封进行加密参数：参数：variantvariant tobeencrypted:tobeencrypted:待加密的数字信封，输入

36、值待加密的数字信封，输入值variantvariant certfile: : 公钥证书的路径地址，输入值公钥证书的路径地址，输入值返回值：返回值：longlong 型型0 0 为调用成功，密文见为调用成功，密文见 lastresultlastresult 属性属性-1-1 为调用失败，失败原因见为调用失败，失败原因见 lasterrmsglasterrmsg 属性属性5.1.2.decryptmsg()功能：功能：对数字信封进行解密参数：参数：variantvariant tobedecrypted:tobedecrypted:待解密的数字信封，输入值待解密的数字信封，输入值function

37、 encryptmsg( byval tobeencrypted as variant, byval certfile as variant, ) as longfunction decryptmsg( byval tobedecrypted as variant, byval keyfile as variant, byval password as variant) as long 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司20variantvariant keyfilekeyfile：存放私钥的：存放私钥的 pfxpfx 文件的路径地址

38、，输入文件的路径地址，输入值值variantvariant passwordpassword：保存私钥的密码，输入值：保存私钥的密码，输入值返回值：返回值：longlong 型型0 0 为调用成功，解密后的明文见为调用成功，解密后的明文见 lastresultlastresult 属性属性-1-1 为调用失败，失败原因见为调用失败，失败原因见 lasterrmsglasterrmsg 属性属性5.1.3.signmsg()功能：功能：使用数字信封发送者的私钥对未加密的数字信封进行数字签名参数：参数：variantvariant tobesigned:tobesigned:待进行数字签名的、未加

39、密的数字信待进行数字签名的、未加密的数字信封，输入值封，输入值variantvariant keyfilekeyfile：存放私钥的：存放私钥的 pfxpfx 文件的路径地址，输入文件的路径地址，输入值值variantvariant passwordpassword：保存私钥的密码，输入值：保存私钥的密码，输入值返回值：返回值：longlong 型型function signmsg( byval tobesigned as variant, byval keyfile as variant, byval password as variant) as long 广州银联网络支付有限公司支付网关

40、商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司210 0 为调用成功，签名内容见为调用成功，签名内容见 lastresultlastresult 属性属性-1-1 为调用失败，失败原因见为调用失败，失败原因见 lasterrmsglasterrmsg 属性属性5.1.4.verifymsg()功能：功能：验证数字信封签名是否合法参数：参数：variantvariant tobeverified: :待验证签名的数字签名，输入值待验证签名的数字签名，输入值variantvariant plaintext: :未加密的数字信封，输入值未加密的数字信封，输入值variantvaria

41、nt certfile: : 公钥证书的路径地址，输入值公钥证书的路径地址，输入值返回值：返回值：longlong 型型0 0 为调用成功为调用成功-1-1 为调用失败，失败原因见为调用失败，失败原因见 lasterrmsglasterrmsg 参数参数5.1.5.getresult()function verifymsg( byval tobeverified as variant, byval plaintext as variant, byval certfile as variant) as longfunction getresult( byval merid as variant,

42、 byval userid as variant, byval pwd as variant, byval paysuc as variant, byval shoppingtime as variant, byval begintime as variant, byval endtime as variant, byval orderno as variant, ) as long 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司22功能：从好易联支付网关下载符合条件的交易结果数据功能：从好易联支付网关下载符合条件的交易结果数据参数：参数：var

43、iant merid:merid: 好易联商户好易联商户 ididvariant userid:userid: 好易联对账用户好易联对账用户 ididvariant pwd:pwd: 好易联对账用户密码好易联对账用户密码variant paysuc:paysuc: 交易结果类型交易结果类型(0-(0-失败订单，失败订单，1-1-成功订单，成功订单，2-2-全部订单全部订单) )variant shoppingtime:shoppingtime: 交易日期交易日期( (查询查询 shoppingtimeshoppingtime 到现在的到现在的交易结果数据，此域不为空时，交易结果数据，此域不为空

44、时，begintimebegintime 及及 endtimeendtime 失效，失效，格式为：格式为：yyyy-mm-ddyyyy-mm-dd hh:mm:ss)hh:mm:ss)variant begintime:begintime: 开始时间开始时间( (查询查询 begintimebegintime 到到 endtimeendtime 的交的交易结果数据，格式为：易结果数据，格式为：yyyy-mm-ddyyyy-mm-dd hh:mm:ss)hh:mm:ss)variant endtime:endtime: 结束时间结束时间( (查询查询 begintimebegintime 到到

45、endtimeendtime 的交易的交易结果数据，格式为：结果数据，格式为：yyyy-mm-ddyyyy-mm-dd hh:mm:ss)hh:mm:ss)variant orderno:orderno:商户订单号（可以为空）商户订单号（可以为空） 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司23对账接口对账接口 urlurl 在安装路径下的在安装路径下的 openvendor.iniopenvendor.ini 文件中配置，上文件中配置，上生产时需要修改生产时需要修改返回值：返回值：longlong 型型0 0 为调用成功，订单数据见为调用成

46、功，订单数据见 lastresultlastresult 属性属性-1-1 为调用失败，失败原因见为调用失败，失败原因见 lasterrmsglasterrmsg 属性属性5.1.6.lastresult 属性属性功能：返回上一次调用功能：返回上一次调用 encryptmsg()encryptmsg()、decryptmsg()decryptmsg()、signmsg()signmsg()、getresult()getresult()方法的输出值方法的输出值类型：类型：string 型5.1.7.lasterrmsg 属性属性功能：返回上一次函数调用失败后的出错信息功能：返回上一次函数调用失败

47、后的出错信息类型：类型： 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司24stringstring 型型lasterrmsglasterrmsg 属性的返回值类似于：属性的返回值类似于：5.1.8.currver 属性属性功能：返回当前接口的版本功能：返回当前接口的版本类型：类型：stringstring 型型currvercurrver 属性的返回值类似于：属性的返回值类似于：error number:-10005error description:er_find_cert_failed(找不到证书)广州好易联支付网络有限公司支付网关商户接口

48、 版本号:3.4 最后编译日期:2004-09-09 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司256.6.6.net.net.net 版商户接口函数版商户接口函数版商户接口函数版商户接口函数6.1. 接口函数接口函数6.1.1.encryptmsg()public static bool encryptmsg(string tobeencrypted, string certkey, out string result, out string errmsg)功能：对字符串进行加密功能：对字符串进行加密对象名称对象名称方法方法/ /属性属性功

49、能功能encryptmsg(encryptmsg() )方法方法数字信封加密数字信封加密decryptmsg(decryptmsg() )方法方法数字信封解密数字信封解密signmsg()signmsg()方方法法数字信封签名数字信封签名verifymsg()verifymsg()方法方法数字信封验证签名数字信封验证签名com.gnete.gnetcom.gnete.gnetecryptecryptgetcurrver(getcurrver() )方法方法控件版本控件版本 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司26参数：参数：string

50、string tobeencryptedtobeencrypted对该字符串进行加密对该字符串进行加密stringstring certkeycertkey加密证书公钥加密证书公钥 keykeyoutout stringstring resultresult加密后的密文加密后的密文outout stringstring errmsgerrmsg错误信息错误信息返回值：返回值：boolbool 型型truetrue 为加密成功，密文见为加密成功，密文见 resultresultfalsefalse 为加密失败，失败原因见为加密失败，失败原因见errmsgerrmsg 广州银联网络支付有限公司支付

51、网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司276.1.2.decryptmsg()功能：对加密后的密文进行解密功能：对加密后的密文进行解密参数：参数：stringstring tobedecryptedtobedecrypted对该字符串进行加密对该字符串进行加密stringstring keyfilekeyfile解密私钥证书路径解密私钥证书路径stringstring passwordpassword私钥证书密码私钥证书密码outout stringstring resultresult解密后的明文解密后的明文outout stringstring errmsger

52、rmsg错误信息错误信息返回值：返回值：boolbool 型型truetrue 为解密成功，密文见为解密成功，密文见 resultresultfalsefalse 为解密失败，失败原因见为解密失败，失败原因见errmsgerrmsgpublic static bool decryptmsg(string tobedecrypted, string keyfile, string password, out string result, out string errmsg) 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司286.1.3.signms

53、g()public static bool signmsg(string tobesigned, string keyfile, string password, out string result,out string errmsg) 功能：对字符串进行签名功能：对字符串进行签名参数：参数：stringstring tobesignedtobesigned需要进行签名的字符串需要进行签名的字符串stringstring keyfilekeyfile私钥文件路径私钥文件路径stringstring passwordpassword 私钥文件密码私钥文件密码outout stringstring

54、 resultresult签名后的数据签名后的数据outout stringstring errmsgerrmsg错误信息错误信息返回值：返回值：boolbool 型型truetrue 为签名成功，签名数据见为签名成功，签名数据见 resultresultfalsefalse 为签名失败，失败原因见为签名失败，失败原因见errmsgerrmsg 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司296.1.4.verifymsg()public static bool verifymsg(string tobeverified, string pla

55、intext, string pubkey, out string errmsg) 功能：验证签名功能：验证签名参数：参数：stringstring tobeverifiedtobeverified 待验证签名的密文待验证签名的密文stringstring plaintextplaintext待验证签名的明文待验证签名的明文stringstring pubkeypubkey签名者公钥证书签名者公钥证书 keykeyoutout stringstring errmsgerrmsg错误信息错误信息返回值：返回值：boolbool 型型truetrue 为验签成功为验签成功falsefalse 为验

56、签失败，失败原因见为验签失败，失败原因见errmsgerrmsg 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司306.1.5.getresult()public bool getresult(string strurl, string merid, string userid, string pwd, string paysuc, string shoppingtime, string begintime, string endtime, string orderno, out string result, out string errmsg)

57、功能：从好易联支付网关下载符合条件的交易结果数据功能：从好易联支付网关下载符合条件的交易结果数据参数：参数：stringstring strurl:strurl:对帐接口地址对帐接口地址s string merid:merid:好易联商户好易联商户 idids string userid:userid:好易联对账用户好易联对账用户 idids string pwd:pwd: 好易联对账用户密码好易联对账用户密码s string paysuc:paysuc: 交易结果类型交易结果类型(0-(0-失败订单，失败订单，1-1-成功订单，成功订单，2-2-全部订单全部订单) )s string sho

58、ppingtime:shoppingtime: 交易日期交易日期( (查询查询 shoppingtimeshoppingtime 到现在到现在的交易结果数据，此域不为空时，的交易结果数据，此域不为空时，begintimebegintime 及及 endtimeendtime 失效，失效，格式为：格式为：yyyy-mm-ddyyyy-mm-dd hh:mm:ss)hh:mm:ss)s string begintime:begintime: 开始时间开始时间( (查询查询 begintimebegintime 到到 endtimeendtime 的的交易结果数据，格式为：交易结果数据，格式为：yy

59、yy-mm-ddyyyy-mm-dd hh:mm:ss)hh:mm:ss)s string endtime:endtime:结束时间结束时间( (查询查询 begintimebegintime 到到 endtimeendtime 的的交易结果数据，格式为：交易结果数据，格式为：yyyy-mm-ddyyyy-mm-dd hh:mm:ss)hh:mm:ss) 广州银联网络支付有限公司支付网关商户接口标准（银联在线支付）版权所有：广州银联网络支付有限公司31stringstring orderno:orderno:商户订单号（可以为空）商户订单号（可以为空）outout stringstring r

60、esult:result:返回结果返回结果outout stringstring errmsg:errmsg:错误信息错误信息返回值：返回值：booleanboolean 型型truetrue 为调用成功，订单数据见为调用成功，订单数据见 resultresult 属性属性falsefalse 为调用失败，失败原因见为调用失败，失败原因见 errmsgerrmsg 属性属性6.1.6.getcurrver()功能：返回当前接口的版本功能：返回当前接口的版本类型：类型：stringstring 型型getcurrver()getcurrver()属性的返回值类似于：属性的返回值类似于：广州好易联