支付宝接口

支付宝接口  

之前讲过与paypal在线支付的接口通信，paypal接口主要用于国际电子商务，而国内的电子商务，目前而言一般会考虑阿里巴巴的支付宝，下面将详细讲述如何在自己的系统中集成支付宝接口。 

关于支付宝的一些信息可以直接访问支付宝网站https://www.alipay.com/。 

国内电子商务系统实现的基本流程如下： 
客户在系统内下订单 -> 系统根据订单生成支付宝接口url -> 客户通过url使用支付宝（网上银行）付款 -> 支付宝将客户的付款完成信息发送给电子商务系统 -> 系统收到支付宝信息后确定客户订单已经付款 -> 进行发货等后续流程。 

其实这个流程与以前讲paypal接口的基本类似，都是为了实现订单的自动付款确认。 

paypal与支付宝在使用时候有一点区别：paypal接口是直接通过一个form提交给paypal网站；而支付宝是通过一个url跳转到支付宝网站的。 

在开始下面的内容之前,你要先有一个支付宝账户,如果要集成支付宝接口,你还必须申请开通服务(关于如何开通,可以直接到支付宝网站上申请).在服务开通后,支付宝会给你2个字符串编号:1个partnerId(合作伙伴ID),还有1个securityCode(安全码).当你拿到这2个码的时候就可以开始下面的内容了. 

（1）如何调用支付宝接口？（将客户的订单信息按照既定的规则生成一个url跳转到支付宝网站） 

通过下面方法[makeOrderAlipayUrl(HttpServletRequest httpRequest,Order order)]的调用得到支付宝的url,然后进行跳转(response.sendRedirect(url);). 

Java代码 
/**  
     * 根据订单生成支付宝接口URL.  
     * @param httpRequest  
     * @param order 订单实例  
     * @return  
     * @throws Exception  
     */  
    public static String makeOrderAlipayUrl(HttpServletRequesthttpRequest,Order order) throws Exception {   
        HashMap hm = new HashMap();   
        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","[e-mail]");//你的支付宝账户email   
        hm.put("service","create_direct_pay_by_user");//create_direct_pay_by_user=直接付款,trade_create_by_buyer 担保付款    
        hm.put("subject","www.xxx.com的订单");//填写在跳到支付宝页面上显示的付款标题信息   
        String payGateway = "https://www.alipay.com/cooperate/gateway.do?";//跳转到支付宝的url头   
        return makeUrl(hm,securityCode,httpRequest.getCharacterEncoding(),payGateway);//securityCode(安全码)    
    }   
       
       
    /**  
     * 根据传入的参数生成alipay的支付URL  
     * @param hm 参数值  
     * @param securityCode 安全码  
     * @param charset 编码  
     * @param payGateway 支付宝gateway  
     * @return  
     */  
    public static String makeUrl(HashMap hm,String securityCode,String charset,String payGateway) throws Exception{   
        List keys = new ArrayList(hm.keySet());   
        Collections.sort(keys);//支付宝要求参数必须按字母排序   
        StringBuffer content = new StringBuffer();   
        for (int i = 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);   
        String sign = md5(content.toString(),charset);   
        content.delete(0,content.length());   
        content.append(payGateway);   
        for (int i = 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;   
        return content.toString();   
    }   
       
    /**  
     * 生成md5编码字符串.  
     * @param str 源字符串  
     * @param charset 编码方式  
     * @return  
     *  
     */  
    public static String md5(String str,String charset) {   
        if (str == null)   
            return null;   
        char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',   
                'a', 'b', 'c', 'd', 'e', 'f' };   
           
        MessageDigest md5MessageDigest = null;   
        byte[] md5Bytes = null;   
        char md5Chars[] = null;   
        byte[] strBytes = null;   
        try {   
            strBytes = str.getBytes(charset);   
            md5MessageDigest = MessageDigest.getInstance("MD5");   
            md5MessageDigest.update(strBytes);   
            md5Bytes = md5MessageDigest.digest();   
            int j = md5Bytes.length;   
            md5Chars = new char[j * 2];   
            int k = 0;   
            for (int i = 0; i < j; i++) {   
                byte md5Byte = md5Bytes[i];   
                md5Chars[k++] = hexDigits[md5Byte >>> 4 & 0xf];   
                md5Chars[k++] = hexDigits[md5Byte & 0xf];   
            }   
            return new String(md5Chars);   
        } catch (NoSuchAlgorithmException e) {   
            //Log.output(e.toString(), Log.STD_ERR);   
            return null;   
        } catch (UnsupportedEncodingException e) {   
            //Log.output(e.toString(), Log.STD_ERR);   
            return null;   
        } finally {   
            md5MessageDigest = null;   
            strBytes = null;   
            md5Bytes = null;   
        }   
    }  

/** 
     * 根据订单生成支付宝接口URL. 
     * @param httpRequest 
     * @param order 订单实例 
     * @return 
     * @throws Exception 
     */ 
    public static String makeOrderAlipayUrl(HttpServletRequest httpRequest,Order order) throws Exception { 
        HashMap hm = new HashMap(); 
        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","[e-mail]");//你的支付宝账户email 
        hm.put("service","create_direct_pay_by_user");//create_direct_pay_by_user=直接付款,trade_create_by_buyer 担保付款 
        hm.put("subject","www.xxx.com的订单");//填写在跳到支付宝页面上显示的付款标题信息 
        String payGateway = "https://www.alipay.com/cooperate/gateway.do?";//跳转到支付宝的url头 
        return makeUrl(hm,securityCode,httpRequest.getCharacterEncoding(),payGateway);//securityCode(安全码) 
    } 
    
    
    /** 
     * 根据传入的参数生成alipay的支付URL 
     * @param hm 参数值 
     * @param securityCode 安全码 
     * @param charset 编码 
     * @param payGateway 支付宝gateway 
     * @return 
     */ 
    public static String makeUrl(HashMap hm,String securityCode,String charset,String payGateway) throws Exception{ 
        List keys = new ArrayList(hm.keySet()); 
        Collections.sort(keys);//支付宝要求参数必须按字母排序 
        StringBuffer content = new StringBuffer(); 
        for (int i = 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); 
        String sign = md5(content.toString(),charset); 
        content.delete(0,content.length()); 
        content.append(payGateway); 
        for (int i = 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; 
        return content.toString(); 
    } 
    
    /** 
     * 生成md5编码字符串. 
     * @param str 源字符串 
     * @param charset 编码方式 
     * @return 
     * 
     */ 
    public static String md5(String str,String charset) { 
        if (str == null) 
            return null; 
        char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 
                'a', 'b', 'c', 'd', 'e', 'f' }; 
        
        MessageDigest md5MessageDigest = null; 
        byte[] md5Bytes = null; 
        char md5Chars[] = null; 
        byte[] strBytes = null; 
        try { 
            strBytes = str.getBytes(charset); 
            md5MessageDigest = MessageDigest.getInstance("MD5"); 
            md5MessageDigest.update(strBytes); 
            md5Bytes = md5MessageDigest.digest(); 
            int j = md5Bytes.length; 
            md5Chars = new char[j * 2]; 
            int k = 0; 
            for (int i = 0; i < j; i++) { 
                byte md5Byte = md5Bytes[i]; 
                md5Chars[k++] = hexDigits[md5Byte >>> 4 & 0xf]; 
                md5Chars[k++] = hexDigits[md5Byte & 0xf]; 
            } 
            return new String(md5Chars); 
        } catch (NoSuchAlgorithmException e) { 
            //Log.output(e.toString(), Log.STD_ERR); 
            return null; 
        } catch (UnsupportedEncodingException e) { 
            //Log.output(e.toString(), Log.STD_ERR); 
            return null; 
        } finally { 
            md5MessageDigest = null; 
            strBytes = null; 
            md5Bytes = null; 
        } 
    } 


当客户通过接口url付款后,支付宝会自动的去调用前面提供的[notify_url]参数中的url. 

（2）支付宝将付款信息返回给系统 
当客户付款后，支付宝就会自动调用上面表单提供的[notify_url]，下面是一个[notifyurl.jsp]的一个例子： 
Html代码 
<%@ page contentType="text/html;charset=UTF-8"%><%@ page import="com.soft4j.AlipayMgr"%><%   
    String ret = AlipayMgr.insert(request);   
    if(ret==null){   
        out.print("success");//成功接收支付宝发来的付款信息   
    }else{   
        out.print("fail");//出错   
    }   
%>  

<%@ page contentType="text/html;charset=UTF-8"%><%@ page import="com.soft4j.AlipayMgr"%><% 
String ret = AlipayMgr.insert(request); 
if(ret==null){ 
out.print("success");//成功接收支付宝发来的付款信息 
}else{ 
out.print("fail");//出错 
} 
%> 

如果确认收到支付宝发来的客户付款信息，则返回"success"，这样子支付宝就知道系统已经收到信息了；否则返回"fail"，这样支付宝会过一段时间后再次发来。其实，只有当支付宝收到"success"的返回信息后才会停止发送付款信息，否则会自动的每隔一段时间就调用上面 
的[notify_url]通信接口。 

（3）系统处理支付宝发来的付款信息 

Java代码 
/*  
* Created on 2005-6-12  
* Author stephen  
* Email zhoujianqiang AT gmail DOT com  
* CopyRight(C)2005-2008 , All rights reserved.  
*/  
package com.soft4j;   
  
import java.sql.Connection;   
import java.sql.SQLException;   
import java.util.Enumeration;   
import java.util.Vector;   
import javax.servlet.http.HttpServletRequest;   
  
/**  
* 支付宝付款通知接口.  
*   
* @author stephen  
* @version 1.0.0  
*/  
public final class NotifyUrlMgr {   
       
       
    public static String insert(HttpServletRequest httpRequest) {   
           
        //定义变量和进行必要的初始化工作   
        Enumeration parameterNames = null;   
        String parameterName = null;   
        String parameterValue = null;   
        int count = 0;   
        Vector[] params = null;   
        Vector vParameterName = new Vector();   
        Vector vParameterValue = new Vector();   
           
        try {   
            String orderId = httpRequest.getParameter("out_trade_no");//订单号   
            if(orderId==null||"".equals(orderId)) orderId="-1";   
            parameterNames = httpRequest.getParameterNames();   
            boolean isPrint = false;   
            while (parameterNames.hasMoreElements()) {//循环收取支付宝发来的所有参数信息   
                parameterName = (String) parameterNames.nextElement();   
                parameterValue = httpRequest.getParameter(parameterName);   
                if(parameterValue==null) parameterValue="";   
                vParameterName.add(parameterName);   
                vParameterValue.add(parameterValue);   
                count++;   
            }   
               
            //这里添加对收到信息的处理:一般是将这些信息存入数据库,然后对客户的订单进行处理.   
               
            return null;   
        } catch (Exception e) {   
            return e.toString();   
        } finally {   
            //   
        }   
    }   
  
}  

/* 
* Created on 2005-6-12 
* Author stephen 
* Email zhoujianqiang AT gmail DOT com 
* CopyRight(C)2005-2008 , All rights reserved. 
*/ 
package com.soft4j; 

import java.sql.Connection; 
import java.sql.SQLException; 
import java.util.Enumeration; 
import java.util.Vector; 
import javax.servlet.http.HttpServletRequest; 

/** 
* 支付宝付款通知接口. 
* 
* @author stephen 
* @version 1.0.0 
*/ 
public final class NotifyUrlMgr { 


    public static String insert(HttpServletRequest httpRequest) { 
        
        //定义变量和进行必要的初始化工作 
        Enumeration parameterNames = null; 
        String parameterName = null; 
        String parameterValue = null; 
        int count = 0; 
        Vector[] params = null; 
        Vector vParameterName = new Vector(); 
        Vector vParameterValue = new Vector(); 
        
        try { 
            String orderId = httpRequest.getParameter("out_trade_no");//订单号 
            if(orderId==null||"".equals(orderId)) orderId="-1"; 
            parameterNames = httpRequest.getParameterNames(); 
            boolean isPrint = false; 
            while (parameterNames.hasMoreElements()) {//循环收取支付宝发来的所有参数信息 
                parameterName = (String) parameterNames.nextElement(); 
                parameterValue = httpRequest.getParameter(parameterName); 
                if(parameterValue==null) parameterValue=""; 
                vParameterName.add(parameterName); 
                vParameterValue.add(parameterValue); 
                count++; 
            } 
            
            //这里添加对收到信息的处理:一般是将这些信息存入数据库,然后对客户的订单进行处理. 
            
            return null; 
        } catch (Exception e) { 
            return e.toString(); 
        } finally { 
            // 
        } 
    } 

} 



这样系统可以在客户使用支付宝付款后,自动的根据支付宝发来的付款信息确认客户的付款情况,并进行相应的后续操作. 

如果你的电子商务系统不是java环境的，也可以参考上面的内容。