银联支付接口常见错误总结
常见接入问题及解答
1) 开发过程中,报157错误。
答:看下GATEID是不是写了0001,如果是的话,把0001删掉。
2) 网上支付后,点提交时,页面提示:标准数据域不能为空怎么办?
答:商户自行检查各条程序是否按照《NetPayClient 用户手册》里的内容来编写。当出现该条提示时,表示编程人员没有按照手册里的程序来编写,出现诸如拼写错误、漏输重要数据等低级错误。提醒商户自行检查以下重要参数:MerId, OrdId, TransAmt, CuryId, TransDate, TransType,及和这几个重要参数有关的所有程序。
典型案例:
某公司编程人员在编写时输入:
……
<input type=hidden name=”cruyId” value=”156”>
……
而正确的应该为:
<input type=hidden name=”curyId” value=”156”>。由于一个单词的错误,造成数据读取时无法读取原有的重要信息,即找不到curyId所包含的重要参数造成页面提示标准数据域不能为空。
3) 商户在测试过程中报“错误500”如何解决?
答:该错误为系统错误,属于程序编写错误,测试提交地址和正式提交地址搞混导致。
典型案例:
程序编写时输入:
……
<form action=https://payment.chinapay.com/pay/transget method=post>
……
由于是测试商户,因此在action之后的内容应该为http://payment-test.chinapay.com/,即正确编写输入应该为:
<form action=http://payment-test.chinapay.com/pay/transget method=post>。
4) 商户出现-109错误怎么办?
答:-109错误表示加密不成功,可能由多种问题导致。当前遇到的主要原因是商户在开发过程中使用的签名方式不正确,导致无法签名成功。在这里,需要提醒商户注意接口版本号的问题,20070129的版本号和20040916的版本号在开发上是不同的,采用错误的签名格式,会导致无法正确签名,请商户认真阅读操作文档第21页~25页的相关说明。
07版本需要通过对一串字符串签名来实现。具体区别如下:
|
接口类型 |
20040916 |
20070129 |
发送交易 |
NetPayClient for Java |
signOrder |
sign |
NetPayClient for Win32 |
sign |
signData |
|
NetPayClient for C |
signOrder |
signData |
|
接收交易 |
NetPayClient for Java |
verifyTransResponse |
verifyTransResponse |
NetPayClient for Win32 |
check |
check |
|
NetPayClient for C |
verifyTransResponse |
verifyTransResponse |
遇到该错误时,可以用2.1中提到的方法,为用户检查发送代码的情况。
5) 商户遇到非法长度怎么办?
答:非法长度是由于商户在配置过程中各个参数长度未按实际要求配置导致。例如:订单号非16位,交易日期非8位,交易金额非12位,Checkvalue未生成等等,均会导致非法长度。
发送参数具体说明如下:
参数说明:
String MerId 商户号,长度为15个字节的数字串,由ChinaPay或清算银行分配。
String OrdId 订单号,长度为16个字节的数字串,由商户系统生成,失败的订单号允许重复支付。
String TransAmt 交易金额,长度为12个字节的数字串,例如:数字串”000000001234″表示12.34元。
String CuryId 货币代码, 长度为3个字节的数字串,目前只支持人民币,取值为”156″ 。
String TransDate 交易日期,长度为8个字节的数字串,表示格式为:YYYYMMDD。
String TransType 交易类型,长度为4个字节的数字串,取值范围为:”0001″和”0002″, 其中”0001″表示消费交易,”0002″表示退货交易。
返回值:
String CheckValue[256] 即NetPayClient根据上述输入参数生成的商户数字签名,长度为256字节的字符串。
6) ERRORCODE=110是怎么回事?
答:商户页面应答或后台应答地址过长导致。后台交易接收URL,长度不要超过80个字节,如超过80个字节,即会报该错误。建议商户自行修改后台应答及页面应答地址,控制在80字节内即可。
7) ASP开发过程中AXTIVEX控件不能创建对象或动态链接库没有注册怎么办?
答:1)让商户检查XP系统的SCRIPT是否已经更新到最新版本。2)是否正确加载了CHINAPAY.DLL和CPNPC.DLL文件。同时,NETPAY.DLL必须放在SYSTEM32文件夹下。
8) 开发时报非法页面是怎么回事?
答:提交页面使用的应该是弹出窗口,如果商户使用的页面是框架接口,那在提交时页面将无法正常跳转,即会报非法页面。建议商户修改网页结构,不要尝试在页面的框架内进行窗口跳转,而使用弹出窗口方式。
9) 发送交易时,其他可能遇到的报错信息。
签名方法 |
|
-100 |
环境变量”NPCDIR”未设置 |
-101 |
户密钥文件不存在或无法打开 |
-102 |
密钥文件格式错误 |
-103 |
秘钥商户号和用于签名的商户号不一致 |
-130 |
用于签名的字符串长度为空 |
10) 测试时,支付成功,返回商户页面时验证签名错误?
答:首先,商户各条程序是否按照《NetPayClient 用户手册》里的内容来编写。同时要注意,在接收应答时,20070129的版本号签名方式与20040916版本号的签名方式是不一致的,需特别注意!
典型案例:
某公司在测试时输入:
……
Chkvalue = request.getparameter(“chkvalue”)
……
因为发送的参数名是ChkValue,回来取得也是ChkValue,实际上应该是checkvalue,所以传的空值,才验证通不过的。即:
Chkvalue = request.getparameter(“checkvalue”)
这属于没有按照手册里程序编写所产生的验证签名错误。
11) 商户出现公钥初始化失败怎么办?
答:首先商户是否是使用JAVA来进行接口开发的。如果是,请商户查看程序中是否在应该填写公钥代码处填写了商户号。
典型案例:
某商户的编程人员在编写程序时输入:
……
Flag=key.buildKey(“808080002100999”,0”c:\winnt\\PgPubk.key”);
……
而正确的应该为:
……
Flag=key.buildKey(“999999999999999”,0”c:\winnt\\PgPubk.key”);
……
12) 商户出现-118错误怎么办?
答:一般不会出现该问题。主要原因是由于商户验签时使用的密钥不正确或者传入验签的参数有问题导致,比如测试商户使用生产商户的密钥或验签时,传入的参数不正确,无法正确验签导致。
典型案例:
某商户在测试系统的上线中,使用了生产商户的公钥,导致出现-118错误,替换测试商户公钥后,问题解决。
13) 后台应答收不到怎么办?
答:请检查接受应答代码是否对于应答的接收条件评判有误;在发送交易时,接收应答地址是否正确。
14) 后台应答接收后,如何告知ChinaPay?
答:WEBSEVER自动反馈,通常情况,成功接收将会自动返回200的代码。所以商户无需返回任何参数。仅当OrderStatus为1001时,该交易才为成功交易,其他交易均为失败交易,商户需要自行对此进行判定,加入自己的数据库中。
15) loadlib(CHINAPAY.DLL)失败怎么办?
Netpay.dll必须放在system32文件夹里。