支付宝接口（转载）
yca 2010-08-11
之前讲过与paypal在线支付的接口通信，paypal接口主要用于国际电子商务，而国内的电子商务，目前而言一般会考虑阿里巴巴的支付宝，下面将详细讲述如何在自己的系统中集成支付宝接口。
关于支付宝的一些信息可以直接访问支付宝网站https://www.alipay.com/。
国内电子商务系统实现的基本流程如下：
客户在系统内下订单->系统根据订单生成支付宝接口url->客户通过url使用支付宝（网上银行）付款->支付宝将客户的付款完成信息发送给电子商务系统->系统收到支付宝信息后确定客户订单已经付款->进行发货等后续流程。
其实这个流程与以前讲paypal接口的基本类似，都是为了实现订单的自动付款确认。
paypal与支付宝在使用时候有一点区别：paypal接口是直接通过一个form提交给paypal网站；而支付宝是通过一个url跳转到支付宝网站的。
在开始下面的内容之前,你要先有一个支付宝账户,如果要集成支付宝接口,你还必须申请开通服务(关于如何开通,可以直接到支付宝网站上申请).在服务开通后,支付宝会给你2个字符串编号:1个partnerId(合作伙伴ID),还有1个securityCode(安全码).当你拿到这2个码的时候就可以开始下面的内容了.
（1）如何调用支付宝接口？（将客户的订单信息按照既定的规则生成一个url跳转到支付宝网站）
通过下面方法[makeOrderAlipayUrl(HttpServletRequesthttpRequest,Orderorder)]的调用得到支付宝的url,然后进行跳转(response.sendRedirect(url);).
Java代码
/**
*根据订单生成支付宝接口URL.
*@paramhttpRequest
*@paramorder订单实例
*@return
*@throwsException
*/
publicstaticStringmakeOrderAlipayUrl(HttpServletRequesthttpRequest,Orderorder)throwsException{
HashMaphm=newHashMap();
hm.put("_input_charset",httpRequest.getCharacterEncoding());//采用相同的编码方式
hm.put("body","您在www.xxx.com上的订单");//填写在跳到支付宝页面上显示的付款内容信息
hm.put("discount","-5");//填写折扣信息-5表示抵扣5元
hm.put("logistics_fee","10");//物流费用
hm.put("logistics_payment","BUYER_PAY");//物流费用支付人BUYER_PAY=买家支付物流费用
hm.put("logistics_type","EXPRESS");//物流方式
hm.put("notify_url","http://www.xxx.com/notifyurl.jsp");//客户付款后,支付宝调用的页面
hm.put("out_trade_no",order.getId());//外部交易号,最好具有唯一性,在获取支付宝发来的付款信息时使用.
hm.put("partner",partnerId);//partnerId(合作伙伴ID)
hm.put("agent",partnerId);//partnerId(合作伙伴ID)
hm.put("payment_type","1");//支付类型1=商品购买,2=服务购买,...
hm.put("price","105.30");//订单金额信息
hm.put("quantity","1");//订单商品数量,一般都是写1,它是按照整个订单包来计算
hm.put("return_url","http://www.xxx.com/ReturnUrl.jsp");//客户付款成功后,显示给客户的页面
hm.put("seller_email","[email protected]");//你的支付宝账户email
hm.put("service","create_direct_pay_by_user");//create_direct_pay_by_user=直接付款,trade_create_by_buyer担保付款
hm.put("subject","www.xxx.com的订单");//填写在跳到支付宝页面上显示的付款标题信息
StringpayGateway="https://www.alipay.com/cooperate/gateway.do?";//跳转到支付宝的url头
returnmakeUrl(hm,securityCode,httpRequest.getCharacterEncoding(),payGateway);//securityCode(安全码)
}
/**
*根据传入的参数生成alipay的支付URL
*@paramhm参数值
*@paramsecurityCode安全码
*@paramcharset编码
*@parampayGateway支付宝gateway
*@return
*/
publicstaticStringmakeUrl(HashMaphm,StringsecurityCode,Stringcharset,StringpayGateway)throwsException{
Listkeys=newArrayList(hm.keySet());
Collections.sort(keys);//支付宝要求参数必须按字母排序
StringBuffercontent=newStringBuffer();
for(inti=0;i<keys.size();i++){
content.append((String)keys.get(i));
content.append("=");
content.append((String)hm.get((String)keys.get(i)));
if(i!=keys.size()-1){
content.append("&");
}
}
content.append(securityCode);
Stringsign=md5(content.toString(),charset);
content.delete(0,content.length());
content.append(payGateway);
for(inti=0;i<keys.size();i++){
content.append(keys.get(i));
content.append("=");
content.append(URLEncoder.encode((String)hm.get(keys.get(i)),charset));
content.append("&");
}
content.append("sign=");
content.append(sign);
content.append("&sign_type=MD5");
keys.clear();
keys=null;
returncontent.toString();
}
/**
*生成md5编码字符串.
*@paramstr源字符串
*@paramcharset编码方式
*@return
*
*/
publicstaticStringmd5(Stringstr,Stringcharset){
if(str==null)
returnnull;
charhexDigits[]={'0','1','2','3','4','5','6','7','8','9',
'a','b','c','d','e','f'};
MessageDigestmd5MessageDigest=null;
byte[]md5Bytes=null;
charmd5Chars[]=null;
byte[]strBytes=null;
try{
strBytes=str.getBytes(charset);
md5MessageDigest=MessageDigest.getInstance("MD5");
md5MessageDigest.update(strBytes);
md5Bytes=md5MessageDigest.digest();
intj=md5Bytes.length;
md5Chars=newchar[j*2];
intk=0;
for(inti=0;i<j;i++){
bytemd5Byte=md5Bytes[i];
md5Chars[k++]=hexDigits[md5Byte>>>4&0xf];
md5Chars[k++]=hexDigits[md5Byte&0xf];
}
returnnewString(md5Chars);
}catch(NoSuchAlgorithmExceptione){
//Log.output(e.toString(),Log.STD_ERR);
returnnull;
}catch(UnsupportedEncodingExceptione){
//Log.output(e.toString(),Log.STD_ERR);
returnnull;
}finally{
md5MessageDigest=null;
strBytes=null;
md5Bytes=null;
}
}
/**
*根据订单生成支付宝接口URL.
*@paramhttpRequest
*@paramorder订单实例
*@return
*@throwsException
*/
publicstaticStringmakeOrderAlipayUrl(HttpServletRequesthttpRequest,Orderorder)throwsException{
HashMaphm=newHashMap();
hm.put("_input_charset",httpRequest.getCharacterEncoding());//采用相同的编码方式
hm.put("body","您在www.xxx.com上的订单");//填写在跳到支付宝页面上显示的付款内容信息
hm.put("discount","-5");//填写折扣信息-5表示抵扣5元
hm.put("logistics_fee","10");//物流费用
hm.put("logistics_payment","BUYER_PAY");//物流费用支付人BUYER_PAY=买家支付物流费用
hm.put("logistics_type","EXPRESS");//物流方式
hm.put("notify_url","http://www.xxx.com/notifyurl.jsp");//客户付款后,支付宝调用的页面
hm.put("out_trade_no",order.getId());//外部交易号,最好具有唯一性,在获取支付宝发来的付款信息时使用.
hm.put("partner",partnerId);//partnerId(合作伙伴ID)
hm.put("agent",partnerId);//partnerId(合作伙伴ID)
hm.put("payment_type","1");//支付类型1=商品购买,2=服务购买,...
hm.put("price","105.30");//订单金额信息
hm.put("quantity","1");//订单商品数量,一般都是写1,它是按照整个订单包来计算
hm.put("return_url","http://www.xxx.com/ReturnUrl.jsp");//客户付款成功后,显示给客户的页面
hm.put("seller_email","[email protected]");//你的支付宝账户email
hm.put("service","create_direct_pay_by_user");//create_direct_pay_by_user=直接付款,trade_create_by_buyer担保付款
hm.put("subject","www.xxx.com的订单");//填写在跳到支付宝页面上显示的付款标题信息
StringpayGateway="https://www.alipay.com/cooperate/gateway.do?";//跳转到支付宝的url头
returnmakeUrl(hm,securityCode,httpRequest.getCharacterEncoding(),payGateway);//securityCode(安全码)
}
/**
*根据传入的参数生成alipay的支付URL
*@paramhm参数值
*@paramsecurityCode安全码
*@paramcharset编码
*@parampayGateway支付宝gateway
*@return
*/
publicstaticStringmakeUrl(HashMaphm,StringsecurityCode,Stringcharset,StringpayGateway)throwsException{
Listkeys=newArrayList(hm.keySet());
Collections.sort(keys);//支付宝要求参数必须按字母排序
StringBuffercontent=newStringBuffer();
for(inti=0;i<keys.size();i++){
content.append((String)keys.get(i));
content.append("=");
content.append((String)hm.get((String)keys.get(i)));
if(i!=keys.size()-1){
content.append("&");
}
}
content.append(securityCode);
Stringsign=md5(content.toString(),charset);
content.delete(0,content.length());
content.append(payGateway);
for(inti=0;i<keys.size();i++){
content.append(keys.get(i));
content.append("=");
content.append(URLEncoder.encode((String)hm.get(keys.get(i)),charset));
content.append("&");
}
content.append("sign=");
content.append(sign);
content.append("&sign_type=MD5");
keys.clear();
keys=null;
returncontent.toString();
}
/**
*生成md5编码字符串.
*@paramstr源字符串
*@paramcharset编码方式
*@return
*
*/
publicstaticStringmd5(Stringstr,Stringcharset){
if(str==null)
returnnull;
charhexDigits[]={'0','1','2','3','4','5','6','7','8','9',
'a','b','c','d','e','f'};
MessageDigestmd5MessageDigest=null;
byte[]md5Bytes=null;
charmd5Chars[]=null;
byte[]strBytes=null;
try{
strBytes=str.getBytes(charset);
md5MessageDigest=MessageDigest.getInstance("MD5");
md5MessageDigest.update(strBytes);
md5Bytes=md5MessageDigest.digest();
intj=md5Bytes.length;
md5Chars=newchar[j*2];
intk=0;
for(inti=0;i<j;i++){
bytemd5Byte=md5Bytes[i];
md5Chars[k++]=hexDigits[md5Byte>>>4&0xf];
md5Chars[k++]=hexDigits[md5Byte&0xf];
}
returnnewString(md5Chars);
}catch(NoSuchAlgorithmExceptione){
//Log.output(e.toString(),Log.STD_ERR);
returnnull;
}catch(UnsupportedEncodingExceptione){
//Log.output(e.toString(),Log.STD_ERR);
returnnull;
}finally{
md5MessageDigest=null;
strBytes=null;
md5Bytes=null;
}
}
当客户通过接口url付款后,支付宝会自动的去调用前面提供的[notify_url]参数中的url.
（2）支付宝将付款信息返回给系统
当客户付款后，支付宝就会自动调用上面表单提供的[notify_url]，下面是一个[notifyurl.jsp]的一个例子：
Html代码
<%@pagecontentType="text/html;charset=UTF-8"%><%@pageimport="com.soft4j.AlipayMgr"%><%
Stringret=AlipayMgr.insert(request);
if(ret==null){
out.print("success");//成功接收支付宝发来的付款信息
}else{
out.print("fail");//出错
}
%>
<%@pagecontentType="text/html;charset=UTF-8"%><%@pageimport="com.soft4j.AlipayMgr"%><%
Stringret=AlipayMgr.insert(request);
if(ret==null){
out.print("success");//成功接收支付宝发来的付款信息
}else{
out.print("fail");//出错
}
%>
如果确认收到支付宝发来的客户付款信息，则返回"success"，这样子支付宝就知道系统已经收到信息了；否则返回"fail"，这样支付宝会过一段时间后再次发来。其实，只有当支付宝收到"success"的返回信息后才会停止发送付款信息，否则会自动的每隔一段时间就调用上面
的[notify_url]通信接口。
（3）系统处理支付宝发来的付款信息
Java代码
/*
*Createdon2005-6-12
*Authorstephen
*EmailzhoujianqiangATgmailDOTcom
*CopyRight(C)2005-2008,Allrightsreserved.
*/
packagecom.soft4j;
importjava.sql.Connection;
importjava.sql.SQLException;
importjava.util.Enumeration;
importjava.util.Vector;
importjavax.servlet.http.HttpServletRequest;
/**
*支付宝付款通知接口.
*
*@authorstephen
*@version1.0.0
*/
publicfinalclassNotifyUrlMgr{
publicstaticStringinsert(HttpServletRequesthttpRequest){
//定义变量和进行必要的初始化工作
EnumerationparameterNames=null;
StringparameterName=null;
StringparameterValue=null;
intcount=0;
Vector[]params=null;
VectorvParameterName=newVector();
VectorvParameterValue=newVector();
try{
StringorderId=httpRequest.getParameter("out_trade_no");//订单号
if(orderId==null||"".equals(orderId))orderid="-1";
parameterNames=httpRequest.getParameterNames();
booleanisPrint=false;
while(parameterNames.hasMoreElements()){//循环收取支付宝发来的所有参数信息
parameterName=(String)parameterNames.nextElement();
parameterValue=httpRequest.getParameter(parameterName);
if(parameterValue==null)parameterValue="";
vParameterName.add(parameterName);
vParameterValue.add(parameterValue);
count++;
}
//这里添加对收到信息的处理:一般是将这些信息存入数据库,然后对客户的订单进行处理.
returnnull;
}catch(Exceptione){
returne.toString();
}finally{
//
}
}
}
/*
*Createdon2005-6-12
*Authorstephen
*EmailzhoujianqiangATgmailDOTcom
*CopyRight(C)2005-2008,Allrightsreserved.
*/
packagecom.soft4j;
importjava.sql.Connection;
importjava.sql.SQLException;
importjava.util.Enumeration;
importjava.util.Vector;
importjavax.servlet.http.HttpServletRequest;
/**
*支付宝付款通知接口.
*
*@authorstephen
*@version1.0.0
*/
publicfinalclassNotifyUrlMgr{
publicstaticStringinsert(HttpServletRequesthttpRequest){
//定义变量和进行必要的初始化工作
EnumerationparameterNames=null;
StringparameterName=null;
StringparameterValue=null;
intcount=0;
Vector[]params=null;
VectorvParameterName=newVector();
VectorvParameterValue=newVector();
try{
StringorderId=httpRequest.getParameter("out_trade_no");//订单号
if(orderId==null||"".equals(orderId))orderid="-1";
parameterNames=httpRequest.getParameterNames();
booleanisPrint=false;
while(parameterNames.hasMoreElements()){//循环收取支付宝发来的所有参数信息
parameterName=(String)parameterNames.nextElement();
parameterValue=httpRequest.getParameter(parameterName);
if(parameterValue==null)parameterValue="";
vParameterName.add(parameterName);
vParameterValue.add(parameterValue);
count++;
}
//这里添加对收到信息的处理:一般是将这些信息存入数据库,然后对客户的订单进行处理.
returnnull;
}catch(Exceptione){
returne.toString();
}finally{
//
}
}
}
这样系统可以在客户使用支付宝付款后,自动的根据支付宝发来的付款信息确认客户的付款情况,并进行相应的后续操作.
如果你的电子商务系统不是java环境的，也可以参考上面的内容。
