1.alipay 双功能支付简介
2.alipay 提交支付订单
3.alipay 整合双功能支付及发货信息同步
4.alipay 页面跳转同步通知处理
5.alipay 服务器异步通知处理
====================== 华丽丽的分割线 ======================
1.alipay 双功能支付简介
1.0 废话
网上copy的东西那么多,查个东西在百度上google一下都搜不到个完整,我恨!代码还是看自己整理的比较好。
1.1 使用流程
在网站中生成订单信息,并记录到数据库中,将订单信息及其他必要信息按照alipayto指定的形式,发给支付宝,也就是生成完了调AlipayService.BuildForm() 方法,改方法会返回一串字符串,里面记录着表单信息,无需更改返回的字符串,并使之打印到页面上(该字符串有js写的自动提交表单)。
此时进入支付宝付款页面,当支付成功时,支付宝会根据我们设置的returnURL来访问我们指定的页面(action),我们可以根据他回馈的状态及订单号,钱等信息进行对数据库相应处理(得判断状态是否一致)。
但是,上述的情况只是在用户每关闭我们网站的时候才会出现,事实上,有可能用户在没付款结束时就关闭了网站。支付宝为解决这个问题,使用了notifyURL,即每次用户的交易状态发生更改,都会主动向notifyURL中设置的页面(action)发出通知,以便我们能设置商业逻辑。
为此,需要编写或更改的,有如下:aAlipayConfig(设置alipay账户,及跳转通知页面等基本信息),alipayto(生成表单并提交),returnURL(页面跳转同步通知处理文件),notifyURL(服务器异步通知处理文件)。
由于可能存在重复通知,所以必须忠实的判断订单的状态,以免重复操作。
1.2 支付宝双功能支付所需要的类
所需要的类如下:
AlipayConfig.java
这个类里面需要我去修改一些信息,如:身份ID,key等
AlipayService.java
请求处理类,可整合进发货信息同步(当然,也可以独立出来,不过我感觉没那个必要)
AlipayNotify.java
该类无需更改。
Md5Encrpt.java
支付宝传输参数加密用,无需更改
AlipayFunction.java
公用函数,alipay 请求、通知时调用,无需更改
SetCharacterEncodingFilter.java
字符串格式,无需更改(搞笑的是,里面的注释是英文的,与上面的类注释不同,不协调~~)
UtilDate.java
自定义订单类,用于生成订单号,该类可要可不要(能确保自己生成的订单号唯一就行)
(建议以上放在同一包中)
AlipayAction.java
用于编写alipayTo(),notifyURL(),returnURL() 等处理alipay相关方法
另外,还需要如下jsp页面:
alipayto.jsp
用于跳转到打印AlipayService.BuildForm()返回的字符串,跳转到 alipay 的支付页面(当然,也可以改造成直接从Action中提交)
return_url.jsp
用于展示用户订单支付成功的页面。
====================== 华丽丽的分割线 ======================
2.alipay 提交支付订单
2.1 设置AlipayConfig信息
如前所述,签约支付的卖家帐号,服务器通知的页面,字符编码格式等,都在这里设置,如下:
复制代码
1 /* *
2 *功能:设置帐户有关信息及返回路径(基础配置页面)
3 *版本:3.1
4 *日期:2010-11-25
5 *说明:
6 *以下代码只是为了方便商户测试而提供的样例代码,商户可以根据自己网站的需要,按照技术文档编写,并非一定要使用该代码。
7 *该代码仅供学习和研究支付宝接口使用,只是提供一个参考。
8
9 *提示:如何获取安全校验码和合作身份者ID
10 *1.访问支付宝首页(www.alipay.com),然后用您的签约支付宝账号登陆.
11 *2.点击导航栏中的“商家服务”,即可查看
12
13 *安全校验码查看时,输入支付密码后,页面呈灰色的现象,怎么办?
14 *解决方法:
15 *1、检查浏览器配置,不让浏览器做弹框屏蔽设置
16 *2、更换浏览器或电脑,重新登录查询。
17 * */
18 package com.blank.alipay;
19
20 import java.util.*;
21
22 public class AlipayConfig {
23 // 如何获取安全校验码和合作身份者ID
24 // 1.访问支付宝商户服务中心(b.alipay.com),然后用您的签约支付宝账号登陆.
25 // 2.访问“技术服务”→“下载技术集成文档”(https://b.alipay.com/support/helperApply.htm?action=selfIntegration)
26 // 3.在“自助集成帮助”中,点击“合作者身份(Partner ID)查询”、“安全校验码(Key)查询”
27
28 //↓↓↓↓↓↓↓↓↓↓请在这里配置您的基本信息↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
29 // 合作身份者ID,以2088开头由16位纯数字组成的字符串
30 public static String partner = “”;
31
32 // 交易安全检验码,由数字和字母组成的32位字符串
33 public static String key = “”;
34
35 // 签约支付宝账号或卖家收款支付宝帐户
36 public static String seller_email = “”;
37
38 // notify_url 交易过程中服务器通知的页面 要用 http://格式的完整路径,不允许加?id=123这类自定义参数
39 public static String notify_url = “”;
40
41 // 付完款后跳转的页面 要用 http://格式的完整路径,不允许加?id=123这类自定义参数
42 public static String return_url = “”;
43
44 // 网站商品的展示地址,不允许加?id=123这类自定义参数
45 public static String show_url = “”;
46
47 //收款方名称,如:公司名称、网站名称、收款人姓名等
48 public static String mainname = “”;
49 //↑↑↑↑↑↑↑↑↑↑请在这里配置您的基本信息↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑
50
51
52 // 字符编码格式 目前支持 gbk 或 utf-8
53 // 这里注意要小写,我的alipay双功能支付文件中居然是大写(拿到手就这样),结果出现异常,如果你莫名奇妙的异常,请检查这里。很无语…
54 public static String input_charset = “utf-8”;
55
56 // 签名方式 不需修改
57 public static String sign_type = “MD5”;
58
59 //访问模式,根据自己的服务器是否支持ssl访问,若支持请选择https;若不支持请选择http
60 public static String transport = “http”;
61 }
复制代码
附注:我拿到alipay双功能支付的时候,里面AlipayConfig.java文件中,input_charset=”UTF-8”。这让人很无语,只支持小写,可默认的却又大写。导致出现奇怪的异常…
2.2 提交支付订单的Action (AlipayAction.java)
复制代码
1 /**
2 * 要充值的金额
3 */
4 private String alimoney;
5
6 /**
7 * 要支付的订单编号
8 */
9 private String tradeNumber;
10
11 /**
12 * 生成的HTML-URL,需到JSP打印出来
13 */
14 private String sHtmlText;
15
16 // Getter/Setter 方法略,若还需要其他信息同理。
17
18 public String payTo() {
19 boolean flag = true;
20 // 商业逻辑判断,判断各种信息是否正确,如:金钱,用户信息等
21 // …略
22
23 if(flag) {
24 // 如若无误,写入数据库,并记录状态,生成订单,获取订单ID等信息。
25 // …略
26
27 // 调用入口页方法
28 alipayTo();
29
30 // 跳转到打印sHtmlText页面
31 return SUCCESS;
32 }else {
33 // 信息部正确,跳转到提示错误页面
34 return INPUT;
35 }
36 }
37
38
39 /**
40 * 功能:设置商品有关信息(入口页) 详细:该页面是接口入口页面,生成支付时的URL
41 */
42 private void alipayTo() {
43 String input_charset = AlipayConfig.input_charset;
44 String sign_type = AlipayConfig.sign_type;
45 String seller_email = AlipayConfig.seller_email;
46 String partner = AlipayConfig.partner;
47 String key = AlipayConfig.key;
48
49 String show_url = AlipayConfig.show_url;
50 String notify_url = AlipayConfig.notify_url;
51 String return_url = AlipayConfig.return_url;
52
53 ///
54
55 // 以下参数是需要通过下单时的订单数据传入进来获得
56 // 必填参数
57
58 ///
59 // 这里是需要修改的,暂且注释掉
60 // UtilDate date = new UtilDate();//调取支付宝工具类生成订单号
61 // String out_trade_no = date.getOrderNum();//请与贵网站订单系统中的唯一订单号匹配
62 String out_trade_no = tradeNumber;
63
64 // 订单名称,显示在支付宝收银台里的“商品名称”里,显示在支付宝的交易管理的“商品名称”的列表里。
65 // String subject = new String(request.getParameter(“aliorder”).getBytes(“ISO-8859-1”),”utf-8”);
66 String subject = “XX网站充值” + alimoney + “元货币”;
67
68 // 订单描述、订单详细、订单备注,显示在支付宝收银台里的“商品描述”里
69 // String body = new String(request.getParameter(“alibody”).getBytes(“ISO-8859-1”),”utf-8”);
70 String body = “default”;
71
72 // 订单总金额,显示在支付宝收银台里的“应付总额”里
73 // String price = new String(request.getParameter(“alimoney”).getBytes(“ISO-8859-1”),”utf-8”);
74 String price = alimoney;
75
76 String logistics_fee = “0.00”; // 物流费用,即运费。
77 String logistics_type = “EXPRESS”; // 物流类型,三个值可选:EXPRESS(快递)、POST(平邮)、EMS(EMS)
78 String logistics_payment = “SELLER_PAY”; // 物流支付方式,两个值可选:SELLER_PAY(卖家承担运费)、BUYER_PAY(买家承担运费)
79
80 String quantity = “1”; // 商品数量,建议默认为1,不改变值,把一次交易看成是一次下订单而非购买一件商品。
81
82 // 扩展参数——买家收货信息(推荐作为必填)
83 // 该功能作用在于买家已经在商户网站的下单流程中填过一次收货信息,而不需要买家在支付宝的付款流程中再次填写收货信息。
84 // 若要使用该功能,请至少保证receive_name、receive_address有值
85 String receive_name = “收货人姓名”; // 收货人姓名,如:张三
86 String receive_address = “收货人地址”; // 收货人地址,如:XX省XXX市XXX区XXX路XXX小区XXX栋XXX单元XXX号
87 String receive_zip = “123456”; // 收货人邮编,如:123456
88 String receive_phone = “0571-81234567”; // 收货人电话号码,如:0571-81234567
89 String receive_mobile = “13312341234”; // 收货人手机号码,如:13312341234
90
91 //扩展参数——第二组物流方式
92 //物流方式是三个为一组成组出现。若要使用,三个参数都需要填上数据;若不使用,三个参数都需要为空
93 //有了第一组物流方式,才能有第二组物流方式,且不能与第一个物流方式中的物流类型相同,
94 //即logistics_type=”EXPRESS”,那么logistics_type_1就必须在剩下的两个值(POST、EMS)中选择
95 String logistics_fee_1 = “”; // 物流费用,即运费。
96 String logistics_type_1 = “”; // 物流类型,三个值可选:EXPRESS(快递)、POST(平邮)、EMS(EMS)
97 String logistics_payment_1 = “”; // 物流支付方式,两个值可选:SELLER_PAY(卖家承担运费)、BUYER_PAY(买家承担运费)
98
99 //扩展参数——第三组物流方式
100 //物流方式是三个为一组成组出现。若要使用,三个参数都需要填上数据;若不使用,三个参数都需要为空
101 //有了第一组物流方式和第二组物流方式,才能有第三组物流方式,且不能与第一组物流方式和第二组物流方式中的物流类型相同,
102 //即logistics_type=”EXPRESS”、logistics_type_1=”EMS”,那么logistics_type_2就只能选择”POST”
103 String logistics_fee_2 = “”; // 物流费用,即运费。
104 String logistics_type_2 = “”; // 物流类型,三个值可选:EXPRESS(快递)、POST(平邮)、EMS(EMS)
105 String logistics_payment_2 = “”; // 物流支付方式,两个值可选:SELLER_PAY(卖家承担运费)、BUYER_PAY(买家承担运费)
106
107 //扩展功能参数——其他
108 String buyer_email = “”; // 默认买家支付宝账号
109 String discount = “”; // 折扣,是具体的金额,而不是百分比。若要使用打折,请使用负数,并保证小数点最多两位数
110
111 /
112
113 构造函数,生成请求URL
114 sHtmlText = AlipayService.BuildForm(partner,seller_email,return_url,notify_url,show_url,out_trade_no,
115 subject,body,price,logistics_fee,logistics_type,logistics_payment,quantity,receive_name,receive_address,
116 receive_zip,receive_phone,receive_mobile,logistics_fee_1,logistics_type_1,logistics_payment_1,
117 logistics_fee_2,logistics_type_2,logistics_payment_2,buyer_email,discount,input_charset,key,sign_type);
118 }
复制代码
2.3 跳转到alipay支付页面(alipayto.jsp)
复制代码
<%@ page language=”java” contentType=”text/html; charset=UTF-8”
pageEncoding=”UTF-8”%>
<%@ taglib uri=”/struts-tags” prefix=”s”%>
“http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
数据传输中…
复制代码
2.4 设置struts配置文件 (struts.xml)
<!-- 上部分,略 -->
<action name="payTo" class="AlipayAction" method="payTo">
<result name="success">alipayto.jsp</result>
<result name="input">exception.jsp</result>
</action>
====================== 华丽丽的分割线 ======================
3.alipay 整合双功能支付及发货信息同步
3.1 交易通知
在担保交易中,有如下的通知状态:WAIT_BUYER_PAY(等待买家付款)→WAIT_SELLER_SEND_GOODS(买家已付款,等待卖家发货)→WAIT_BUYER_CONFIRM_GOODS(卖家已发货,等待买家收货)→TRADE_FINISHED(买家已收货,交易完成)
(在使用alipay做本次项目时,没涉及到退货环节,故不写上)
由于alipay有这个WAIT_BUYER_CONFIRM_GOODS(卖家已发货,等待买家收货)状态存在,故在买家已付款的时候,我们需通知alipay,告知我们已发货,故需要在双功能支付的基础上整合进发货信息同步(其实也就2个方法),放在AlipayService.java中。
3.2 整合发货信息同步
复制代码
1 import java.io.BufferedReader;
2 import java.io.InputStreamReader;
3 import java.io.OutputStream;
4 import java.io.UnsupportedEncodingException;
5 import java.net.HttpURLConnection;
6 import java.net.URL;
7 import java.net.URLEncoder;
8 import java.util.ArrayList;
9 import java.util.Collections;
10 import java.util.HashMap;
11 import java.util.List;
12 import java.util.Map;
13
14
15 /**
16 *类名:alipay_service
17 *功能:支付宝外部服务接口控制
18 *详细:该页面是请求参数核心处理文件,不需要修改
19 *版本:3.1
20 *修改日期:2010-11-24
21 *说明:
22 以下代码只是为了方便商户测试而提供的样例代码,商户可以根据自己网站的需要,按照技术文档编写,并非一定要使用该代码。
23 该代码仅供学习和研究支付宝接口使用,只是提供一个参考。
24 */
25
26 public class AlipayService {
27 /**
28 * 功能:构造表单提交HTML
29 * @param partner 合作身份者ID
30 * @param seller_email 签约支付宝账号或卖家支付宝帐户
31 * @param return_url 付完款后跳转的页面 要用 以http开头格式的完整路径,不允许加?id=123这类自定义参数
32 * @param notify_url 交易过程中服务器通知的页面 要用 以http开格式的完整路径,不允许加?id=123这类自定义参数
33 * @param show_url 网站商品的展示地址,不允许加?id=123这类自定义参数
34 * @param out_trade_no 请与贵网站订单系统中的唯一订单号匹配
35 * @param subject 订单名称,显示在支付宝收银台里的“商品名称”里,显示在支付宝的交易管理的“商品名称”的列表里。
36 * @param body 订单描述、订单详细、订单备注,显示在支付宝收银台里的“商品描述”里
37 * @param price 订单总金额,显示在支付宝收银台里的“商品单价”里
38 * @param logistics_fee 物流费用,即运费。
39 * @param logistics_type 物流类型,三个值可选:EXPRESS(快递)、POST(平邮)、EMS(EMS)
40 * @param logistics_payment 物流支付方式,两个值可选:SELLER_PAY(卖家承担运费)、BUYER_PAY(买家承担运费)
41 * @param quantity 商品数量,建议默认为1,不改变值,把一次交易看成是一次下订单而非购买一件商品。
42 * @param receive_name 收货人姓名,如:张三
43 * @param receive_address 收货人地址,如:XX省XXX市XXX区XXX路XXX小区XXX栋XXX单元XXX号
44 * @param receive_zip 收货人邮编,如:123456
45 * @param receive_phone 收货人电话号码,如:0571-81234567
46 * @param receive_mobile 收货人手机号码,如:13312341234
47 * @param logistics_fee_1 第二组物流费用,即运费。
48 * @param logistics_type_1 第二组物流类型,三个值可选:EXPRESS(快递)、POST(平邮)、EMS(EMS)
49 * @param logistics_payment_1 第二组物流支付方式,两个值可选:SELLER_PAY(卖家承担运费)、BUYER_PAY(买家承担运费)
50 * @param logistics_fee_2 第三组物流费用,即运费。
51 * @param logistics_type_2 第三组物流类型,三个值可选:EXPRESS(快递)、POST(平邮)、EMS(EMS)
52 * @param logistics_payment_2 第三组物流支付方式,两个值可选:SELLER_PAY(卖家承担运费)、BUYER_PAY(买家承担运费)
53 * @param buyer_email 默认买家支付宝账号
54 * @param discount 折扣,是具体的金额,而不是百分比。若要使用打折,请使用负数,并保证小数点最多两位数
55 * @param input_charset 字符编码格式 目前支持 GBK 或 utf-8
56 * @param key 安全校验码
57 * @param sign_type 签名方式 不需修改
58 * @return 表单提交HTML文本
59 */
60 public static String BuildForm(String partner,
61 String seller_email,
62 String return_url,
63 String notify_url,
64 String show_url,
65 String out_trade_no,
66 String subject,
67 String body,
68 String price,
69 String logistics_fee,
70 String logistics_type,
71 String logistics_payment,
72 String quantity,
73 String receive_name,
74 String receive_address,
75 String receive_zip,
76 String receive_phone,
77 String receive_mobile,
78 String logistics_fee_1,
79 String logistics_type_1,
80 String logistics_payment_1,
81 String logistics_fee_2,
82 String logistics_type_2,
83 String logistics_payment_2,
84 String buyer_email,
85 String discount,
86 String input_charset,
87 String key,
88 String sign_type){
89 Map sPara = new HashMap();
90 sPara.put(“service”,”trade_create_by_buyer”);
91 sPara.put(“payment_type”,”1”);
92 sPara.put(“partner”, partner);
93 sPara.put(“seller_email”, seller_email);
94 sPara.put(“return_url”, return_url);
95 sPara.put(“notify_url”, notify_url);
96 sPara.put(“_input_charset”, input_charset);
97 sPara.put(“show_url”, show_url);
98 sPara.put(“out_trade_no”, out_trade_no);
99 sPara.put(“subject”, subject);
100 sPara.put(“body”, body);
101 sPara.put(“price”, price);
102 sPara.put(“logistics_fee”, logistics_fee);
103 sPara.put(“logistics_type”, logistics_type);
104 sPara.put(“logistics_payment”, logistics_payment);
105 sPara.put(“quantity”, quantity);
106 sPara.put(“receive_name”, receive_name);
107 sPara.put(“receive_address”, receive_address);
108 sPara.put(“receive_zip”, receive_zip);
109 sPara.put(“receive_phone”, receive_phone);
110 sPara.put(“receive_mobile”, receive_mobile);
111 sPara.put(“logistics_fee_1”, logistics_fee_1);
112 sPara.put(“logistics_type_1”, logistics_type_1);
113 sPara.put(“logistics_payment_1”, logistics_payment_1);
114 sPara.put(“logistics_fee_2”, logistics_fee_2);
115 sPara.put(“logistics_type_2”, logistics_type_2);
116 sPara.put(“logistics_payment_2”, logistics_payment_2);
117 sPara.put(“buyer_email”, buyer_email);
118 sPara.put(“discount”, discount);
119
120 Map sParaNew = AlipayFunction.ParaFilter(sPara); //除去数组中的空值和签名参数
121 String mysign = AlipayFunction.BuildMysign(sParaNew, key);//生成签名结果
122
123 StringBuffer sbHtml = new StringBuffer();
124 List keys = new ArrayList(sParaNew.keySet());
125 String gateway = “https://www.alipay.com/cooperate/gateway.do?”;
126
127 //GET方式传递
128 sbHtml.append(“