2018年04月6日网站服务器迁移完成……

银联在线支付接口说明

技术流 苏 demo 2067℃ 0评论

netpayclient.jar 为用于java和jsp开发的jar包,适用于各个操作系统。jdk版本为1.4。

客户端签名和验签方法说明
public String signOrder(String MerId, String OrdId, String TransAmt, String CuryId, String TransDate, String TransType)
参数说明:
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″表示消费交易
返回值:
String CheckValue[256] – 即NetPayClient根据上述输入参数生成的商户数字签名,长度为256字节的字符串。

○ 使用说明
商户在向消费者发送订单确认页面之前,调用本函数或方法产生订单签名(CheckValue),然后生成订单确认页面,供消费者再次确认订单的内容,并允许消费者选择支付或取消订单。订单确认页面中表单(FORM)的具体例子如下(注意各字段的大小写):

<form action=”https://payment.chinapay.com/pay/TransGet” METHOD=POST>
<input type=hidden name=”MerId” value=”123451234512345″>
<input type=hidden name=”OrdId” value=”0000000000000001″>
<input type=hidden name=”TransAmt” value=”000000001234″>
<input type=hidden name=”CuryId” value=”156″>
<input type=hidden name=”TransDate” value=”20000315″>
<input type=hidden name=”TransType” value=”0001″>
<input type=hidden name=”Version” value=”20040916″>(接口版本号)
<input type=hidden name=”BgRetUrl” value=”http://www.XXX.com/pay/payback1.php”>(后台交易接收URL,长度不要超过80个字节)
<input type=hidden name=”PageRetUrl” value=”http://www.XXX.com/pay/payback2.php”>(页面交易接收URL,长度不要超过80个字节)
<input type=hidden name=”GateId” value=”0001″>(支付网关号,可选)
<input type=hidden name=”Priv1″ value=”Memo”>(商户私有域,可选,长度不要超过60个字节)
<input type=hidden name=”ChkValue” value=”X…X”>(256字节长的ASCII码)
</form>
注:其中GateId和Priv1为可选项,分别表示 “支付网关号”和“保留字段”。 如填写GateId(支付网关号),则消费者将直接进入支付页面,否则进入网关选择页面。具体网关见表1。Priv1为商户私有域,商户通过此字段向Chinapay发送的信息,Chinapay依原样填充返回给商户。当使用版本号“20040916”时,BgRetUrl和PageRetUrl必须填写。
JAVA版安装及调用
7.4.1 安装
将netpayclinet.jar安装到服务器的classpath下。将MerPrk1.key、MerPrk2.key和PgPubk.key复制到服务器上可以访问的路经下,例如/app/usr/chinapay/keys。
7.4.2 使用方法
初始化key文件。方法如下:
chinapay.PrivateKey key1=new chinapay.PrivateKey();
chinapay.SecureLink t;
boolean flag;
flag=key1.buildKey(MerId,0,”app/usr/chinapay/keys/MerPrk1.key”); //注意要用哪一个商户号签名就要用对应的key文件。
if (flag==false)
{
System.out.println(“build key error!”);
return;
}
t1=new chinapay.SecureLink (key1);
String CheckValue1=t1.signOrder(MerId,OrdId,TransAmt,CuryId,TransDate,TransType); //获得对应商户的签名数据。

//使用另外一个商户key文件
chinapay.PrivateKey key2=new chinapay.PrivateKey();
chinapay.SecureLink t;
boolean flag;
flag=key2.buildKey(MerId,0,”app/usr/chinapay/keys/MerPrk2.key”);
if (flag==false)
{
System.out.println(“build key error!”);
return;
}
t2=new chinapay.SecureLink (key2); //获得对应另外商户的签名数据。

7.4.3 函数说明
○ 订单签名函数
String CheckValue=t1.signOrder(MerId,OrdId,TransAmt,CuryId,TransDate,TransType);

○ 验证交易应答函数
boolean flag=t1.verifyTransResponse( MerId,OrdId, TransAmt, CuryId, TransDate,TransType, OrderStatus, CheckValue);(使用该函数时应使用PgPubk.key进行初始化key文件)

注:ChinaPay post过来的参数为:merid,orderno,amount,currencycode,transdate,transtype,status,checkvalue; 其含义跟上面一一对应。
注:各函数中的参数说明,请查阅函数说明。
典型代码示例
7.6.1 商户发送订单至Chinapay的jsp代码示例
String MerId, OrdId, TransAmt, CuryId, TransDate, TransType,ChkValue;
/* …… 给以上变量分别赋值 */

chinapay.PrivateKey key=new chinapay.PrivateKey();
chinapay.SecureLink t;
boolean flag;
flag=key.buildKey(“200401160000001″,0,”D:\\MerPrk.key”);
if (flag==false)
{
System.out.println(“build key error!”);
return;
}
t=new chinapay.SecureLink (key);
ChkValue= t.signOrder(MerId, OrdId, TransAmt, CuryId, TransDate, TransType) ;

<form action=”https://payment.chinapay.com/pay/TransGet” METHOD=POST>
<input type=hidden name=”MerId” value=MerId >
<input type=hidden name=”OrdId” value=OrdId >
<input type=hidden name=”TransAmt” value=”000000001234″>
<input type=hidden name=”CuryId” value=”156″>
<input type=hidden name=”TransDate” value=”20040315″>
<input type=hidden name=”TransType” value=TransType >
<input type=hidden name=”Version” value=”20040916″>
<input type=hidden name=”BgRetUrl” value=”http://www.XX.com/pay/payback1.php”>
<input type=hidden name=”PageRetUrl” value=”http://www.XX.com/pay/payback2.php”>
<input type=hidden name=”GateId” value=”0001″>
<input type=hidden name=”Priv1″ value=”Memo”>
<input type=hidden name=”ChkValue” value=ChkValue>
</form>

7.6.2 商户接收Chinapay应答JSP代码示例
商户接收Chinapay应答模块,文件名getChinapayRet.jsp,代码段如下:

<!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN”>
<%@ page contentType=”text/html;charset=GB2312″ %>
<%@ page import=”java.io.*,java.lang.*,java.util.*,chinapay.*” %>

<html>
<head>
<meta http-equiv=”Content-Type” content=”text/html; charset=gb2312″>
<link TYPE=”text/css” HREF=”mystyle.css” REL=”stylesheet” TITLE=”mystyle”>
</head>

<%
String TransDate = null ;
String MerId = null ;
String OrdId = null ;
String TransType = null ;
String TransAmt = null ;
String CuryId = null ;
String ChkValue = null ;
String OrderStatus= null ;
String GateId = null ;

try
{
TransDate = request.getParameter(“transdate”) ;
MerId = request.getParameter(“merid”) ;
OrdId = request.getParameter(“orderno”);
TransType = request.getParameter(“transtype”) ;
TransAmt = request.getParameter(“amount”) ;
CuryId = request.getParameter(“currencycode”) ;
OrderStatus = request.getParameter(“status”) ;
ChkValue = request.getParameter(“checkvalue”) ;

chinapay.PrivateKey key=new chinapay.PrivateKey();
chinapay.SecureLink t;
boolean flag;
boolean flag1;
String msg=””;

flag=key.buildKey(“999999999999999″,0,”c:\\winnt\\PgPubk.key”);
if (flag==false)
{
msg=”build key error!”;
return;
}

t=new chinapay.SecureLink (key);
flag1=t.verifyTransResponse( MerId,OrdId, TransAmt, CuryId, TransDate, TransType, OrderStatus, ChkValue);

if (flag1==false)
{
System.out.println(“交易验证失败!”);
msg=”交易验证失败!”;
}
else
{
/* …… 数据库更新等相关处理过程 */
}
}
catch(Exception e)
{
out.println(e.getMessage());
return;
}
%>

打赏

转载请注明:苏demo的别样人生 » 银联在线支付接口说明

   如果本篇文章对您有帮助,欢迎向博主进行赞助,赞助时请写上您的用户名。
支付宝直接捐助帐号oracle_lee@qq.com 感谢支持!
喜欢 (0)or分享 (0)
发表我的评论
取消评论
表情