支付宝开发之手机网站支付(H5支付)

时间:2024-03-04 15:44:54

其实官方的文档中:https://docs.open.alipay.com/203 介绍的已经很详细了,我就实地的看文档操作了一遍,具体步骤如下:


一、创建应用


流程如下:




首先要有支付宝开放平台: https://open.alipay.com/platform/home.htm  账号,然后登录网站,创建一个应用






输入应用名称,然后点击创建,详细请查看支付宝官方的介绍:https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.1yF5nC&treeId=193&articleId=105894&docType=1


二、填写应用基础信息


然后输入应用的一些信息




提交审核。。



三、配置沙箱


这里我用支付宝提供的沙盒来测试,蚂蚁沙箱环境(Beta)是协助开发者进行接口功能开发及主要功能联调的模拟环境,在沙箱完成接口开发及主要功能调试后,请务必在蚂蚁正式环境进行完整的功能验收测试。


点击开发者中心中的沙箱进入沙箱环境页面,系统已经自动为你创建一个应用,在基础信息中可以看到应用信息。




同时还创建了账户





 1. 生成并上传RSA2(SHA256)的应用公钥,可以查考这:https://doc.open.alipay.com/docs/doc.htm?treeId=291&articleId=105971&docType=1 ,下载支付宝官方提供的工具





配置RSA2(SHA256)的应用公钥后,不需要配置RSA(SHA1)密钥,RSA和RSA2签名算法区别可以参考此处


 2. 编写代码时,请将


  a.请求网关修改为:https://openapi.alipaydev.com/gateway.do
  b.appid切换为沙箱的appid
  c.签名方式使用RSA2
  d.应用私钥使用第1步生成的RSA2(SHA256)的私钥(请根据开发语言进行选择原始或pkcs8格式)
  e.支付宝公钥切换为第1步配置后应用公钥后,点击查看支付宝公钥看到的公钥


在JAVA中的使用方式如下:

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipaydev.com/gateway.do","2016072200101XXXX","请复制第1步中生成的密钥中的商户应用私钥","json","utf-8","沙箱环境RSA2支付宝公钥","RSA2");


四、导入项目


然后下载支付宝提供的DEMO




下载下来之后,解压导入到Eclipse中去,结构如下




修改其中的配置文件AlipayConfig

  1. package com.alipay.config;
  2. public class AlipayConfig {
  3. // 商户appid
  4. public static String APPID = "";
  5. // 私钥 pkcs8格式的
  6. public static String RSA_PRIVATE_KEY = "";
  7. // 服务器异步通知页面路径 需http://或者https://格式的完整路径,不能加?id=123这类自定义参数,必须外网可以正常访问
  8. public static String notify_url = "http://商户网关地址/alipay.trade.wap.pay-JAVA-UTF-8/notify_url.jsp";
  9. // 页面跳转同步通知页面路径 需http://或者https://格式的完整路径,不能加?id=123这类自定义参数,必须外网可以正常访问 商户可以自定义同步跳转地址
  10. public static String return_url = "http://商户网关地址/alipay.trade.wap.pay-JAVA-UTF-8/return_url.jsp";
  11. // 请求网关地址
  12. public static String URL = "https://openapi.alipay.com/gateway.do";
  13. // 编码
  14. public static String CHARSET = "UTF-8";
  15. // 返回格式
  16. public static String FORMAT = "json";
  17. // 支付宝公钥
  18. public static String ALIPAY_PUBLIC_KEY = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAjrEVFMOSiNJXaRNKicQuQdsREraftDA9Tua3WNZwcpeXeh8Wrt+V9JilLqSa7N7sVqwpvv8zWChgXhX/A96hEg97Oxe6GKUmzaZRNh0cZZ88vpkn5tlgL4mH/dhSr3Ip00kvM4rHq9PwuT4k7z1DpZAf1eghK8Q5BgxL88d0X07m9X96Ijd0yMkXArzD7jg+noqfbztEKoH3kPMRJC2w4ByVdweWUT2PwrlATpZZtYLmtDvUKG/sOkNAIKEMg3Rut1oKWpjyYanzDgS7Cg3awr1KPTl9rHCazk15aNYowmYtVabKwbGVToCAGK+qQ1gT3ELhkGnf3+h53fukNqRH+wIDAQAB";
  19. // 日志记录目录
  20. public static String log_path = "/log";
  21. // RSA2
  22. public static String SIGNTYPE = "RSA2";
  23. }

把其中的一些信息替换成沙箱的信息,其中同步异步通知要外网能访问的,我用的是Ngrok做的代理。




下订单的是在pay.jsp页面中。。。用的是JSP

  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2. pageEncoding="UTF-8"%>
  3. <%@page import="com.alipay.config.AlipayConfig" %>
  4. <%@page import="com.alipay.api.AlipayClient"%>
  5. <%@page import="com.alipay.api.DefaultAlipayClient"%>
  6. <%@page import="com.alipay.api.AlipayApiException"%>
  7. <%@page import="com.alipay.api.response.AlipayTradeWapPayResponse"%>
  8. <%@page import="com.alipay.api.request.AlipayTradeWapPayRequest"%>
  9. <%@page import="com.alipay.api.domain.AlipayTradeWapPayModel" %>
  10. <%@page import="com.alipay.api.domain.AlipayTradeCreateModel"%>
  11. <%
  12. /* *
  13. * 功能:支付宝手机网站支付接口(alipay.trade.wap.pay)接口调试入口页面
  14. * 版本:2.0
  15. * 修改日期:2016-11-01
  16. * 说明:
  17. * 以下代码只是为了方便商户测试而提供的样例代码,商户可以根据自己网站的需要,按照技术文档编写,并非一定要使用该代码。
  18. 请确保项目文件有可写权限,不然打印不了日志。
  19. */
  20. %>
  21. <%
  22. if(request.getParameter("WIDout_trade_no")!=null){
  23. // 商户订单号,商户网站订单系统中唯一订单号,必填
  24. String out_trade_no = new String(request.getParameter("WIDout_trade_no").getBytes("ISO-8859-1"),"UTF-8");
  25. // 订单名称,必填
  26. String subject = new String(request.getParameter("WIDsubject").getBytes("ISO-8859-1"),"UTF-8");
  27. System.out.println(subject);
  28. // 付款金额,必填
  29. String total_amount=new String(request.getParameter("WIDtotal_amount").getBytes("ISO-8859-1"),"UTF-8");
  30. // 商品描述,可空
  31. String body = new String(request.getParameter("WIDbody").getBytes("ISO-8859-1"),"UTF-8");
  32. // 超时时间 可空
  33. String timeout_express="2m";
  34. // 销售产品码 必填
  35. String product_code="QUICK_WAP_PAY";
  36. /**********************/
  37. // SDK 公共请求类,包含公共请求参数,以及封装了签名与验签,开发者无需关注签名与验签
  38. //调用RSA签名方式
  39. AlipayClient client = new DefaultAlipayClient(AlipayConfig.URL, AlipayConfig.APPID, AlipayConfig.RSA_PRIVATE_KEY, AlipayConfig.FORMAT, AlipayConfig.CHARSET, AlipayConfig.ALIPAY_PUBLIC_KEY,AlipayConfig.SIGNTYPE);
  40. AlipayTradeWapPayRequest alipay_request=new AlipayTradeWapPayRequest();
  41. // 封装请求支付信息
  42. AlipayTradeWapPayModel model=new AlipayTradeWapPayModel();
  43. model.setOutTradeNo(out_trade_no);
  44. model.setSubject(subject);
  45. model.setTotalAmount(total_amount);
  46. model.setBody(body);
  47. model.setTimeoutExpress(timeout_express);
  48. model.setProductCode(product_code);
  49. alipay_request.setBizModel(model);
  50. // 设置异步通知地址
  51. alipay_request.setNotifyUrl(AlipayConfig.notify_url);
  52. // 设置同步地址
  53. alipay_request.setReturnUrl(AlipayConfig.return_url);
  54. // form表单生产
  55. String form = "";
  56. try {
  57. // 调用SDK生成表单
  58. form = client.pageExecute(alipay_request).getBody();
  59. response.setContentType("text/html;charset=" + AlipayConfig.CHARSET);
  60. response.getWriter().write(form);//直接将完整的表单html输出到页面
  61. response.getWriter().flush();
  62. response.getWriter().close();
  63. } catch (AlipayApiException e) {
  64. // TODO Auto-generated catch block
  65. e.printStackTrace();
  66. }
  67. }
  68. %>
  69. <!DOCTYPE html>
  70. <html>
  71. <head>
  72. <title>支付宝手机网站支付接口</title>
  73. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  74. <style>
  75. .......
  76. </style>
  77. </head>
  78. <body text=#000000 bgColor="#ffffff" leftMargin=0 topMargin=4>
  79. <header class="am-header">
  80. <h1>支付宝手机网站支付接口快速通道(接口名:alipay.trade.wap.pay)</h1>
  81. </header>
  82. <div id="main">
  83. <form name=alipayment action=\'\' method=post target="_blank">
  84. <div id="body" style="clear:left">
  85. <dl class="content">
  86. <dt>商户订单号:</dt>
  87. <dd>
  88. <input id="WIDout_trade_no" name="WIDout_trade_no" />
  89. </dd>
  90. <hr class="one_line">
  91. <dt>订单名称:</dt>
  92. <dd>
  93. <input id="WIDsubject" name="WIDsubject" />
  94. </dd>
  95. <hr class="one_line">
  96. <dt>付款金额:</dt>
  97. <dd>
  98. <input id="WIDtotal_amount" name="WIDtotal_amount" />
  99. </dd>
  100. <hr class="one_line"/>
  101. <dt>商品描述:</dt>
  102. <dd>
  103. <input id="WIDbody" name="WIDbody" />
  104. </dd>
  105. <hr class="one_line">
  106. <dt></dt>
  107. <dd id="btn-dd">
  108. <span class="new-btn-login-sp">
  109. <button class="new-btn-login" type="submit" style="text-align:center;">确 认</button>
  110. </span>
  111. <span class="note-help">如果您点击“确认”按钮,即表示您同意该次的执行操作。</span>
  112. </dd>
  113. </dl>
  114. </div>
  115. </form>
  116. <div id="foot">
  117. <ul class="foot-ul">
  118. <li>
  119. 支付宝版权所有 2015-2018 ALIPAY.COM
  120. </li>
  121. </ul>
  122. </div>
  123. </div>
  124. </body>
  125. <script language="javascript">
  126. function GetDateNow() {
  127. var vNow = new Date();
  128. var sNow = "";
  129. sNow += String(vNow.getFullYear());
  130. sNow += String(vNow.getMonth() + 1);
  131. sNow += String(vNow.getDate());
  132. sNow += String(vNow.getHours());
  133. sNow += String(vNow.getMinutes());
  134. sNow += String(vNow.getSeconds());
  135. sNow += String(vNow.getMilliseconds());
  136. document.getElementById("WIDout_trade_no").value = sNow;
  137. document.getElementById("WIDsubject").value = "手机网站支付测试商品";
  138. document.getElementById("WIDtotal_amount").value = "0.01";
  139. document.getElementById("WIDbody").value = "购买测试商品0.01元";
  140. }
  141. GetDateNow();
  142. </script>
  143. </html>

同步通知页面return_url.jsp

  1. <%@page import="com.alipay.api.internal.util.AlipaySignature"%>
  2. <%
  3. /* *
  4. 功能:支付宝页面跳转同步通知页面
  5. 版本:3.2
  6. 日期:2011-03-17
  7. 说明:
  8. 以下代码只是为了方便商户测试而提供的样例代码,商户可以根据自己网站的需要,按照技术文档编写,并非一定要使用该代码。
  9. 该代码仅供学习和研究支付宝接口使用,只是提供一个参考。
  10. //***********页面功能说明***********
  11. 该页面可在本机电脑测试
  12. 可放入HTML等美化页面的代码、商户业务逻辑程序代码
  13. TRADE_FINISHED(表示交易已经成功结束,并不能再对该交易做后续操作);
  14. TRADE_SUCCESS(表示交易已经成功结束,可以对该交易做后续操作,如:分润、退款等);
  15. //********************************
  16. * */
  17. %>
  18. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
  19. <%@ page import="java.util.*"%>
  20. <%@ page import="java.util.Map"%>
  21. <%@ page import="com.alipay.config.*"%>
  22. <%@ page import="com.alipay.api.*"%>
  23. <html>
  24. <head>
  25. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  26. <title>支付宝页面跳转同步通知页面</title>
  27. </head>
  28. <body>
  29. <%
  30. //获取支付宝GET过来反馈信息
  31. Map<String,String> params = new HashMap<String,String>();
  32. Map requestParams = request.getParameterMap();
  33. for (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) {
  34. String name = (String) iter.next();
  35. String[] values = (String[]) requestParams.get(name);
  36. String valueStr = "";
  37. for (int i = 0; i < values.length; i++) {
  38. valueStr = (i == values.length - 1) ? valueStr + values[i]
  39. : valueStr + values[i] + ",";
  40. }
  41. //乱码解决,这段代码在出现乱码时使用。如果mysignsign不相等也可以使用这段代码转化
  42. valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
  43. params.put(name, valueStr);
  44. }
  45. //获取支付宝的通知返回参数,可参考技术文档中页面跳转同步通知参数列表(以下仅供参考)//
  46. //商户订单号
  47. String out_trade_no = new String(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");
  48. //支付宝交易号
  49. String trade_no = new String(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");
  50. //获取支付宝的通知返回参数,可参考技术文档中页面跳转同步通知参数列表(以上仅供参考)//
  51. //计算得出通知验证结果
  52. //boolean AlipaySignature.rsaCheckV1(Map<String, String> params, String publicKey, String charset, String sign_type)
  53. boolean verify_result = AlipaySignature.rsaCheckV1(params, AlipayConfig.ALIPAY_PUBLIC_KEY, AlipayConfig.CHARSET, "RSA2");
  54. if(verify_result){//验证成功
  55. //////////////////////////////////////////////////////////////////////////////////////////
  56. //请在这里加上商户的业务逻辑程序代码
  57. //该页面可做页面美工编辑
  58. out.clear();
  59. out.println("验证成功<br />");
  60. //——请根据您的业务逻辑来编写程序(以上代码仅作参考)——
  61. //////////////////////////////////////////////////////////////////////////////////////////
  62. }else{
  63. //该页面可做页面美工编辑
  64. out.clear();
  65. out.println("验证失败");
  66. }
  67. %>
  68. </body>
  69. </html>

异步通知notify_url.jsp

  1. <%@page import="com.alipay.api.internal.util.AlipaySignature"%>
  2. <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
  3. <%@ page import="java.util.*"%>
  4. <%@ page import="java.util.Map"%>
  5. <%@ page import="com.alipay.config.*"%>
  6. <%@ page import="com.alipay.api.*"%>
  7. <%
  8. //获取支付宝POST过来反馈信息
  9. Map<String,String> params = new HashMap<String,String>();
  10. Map requestParams = request.getParameterMap();
  11. for (Iterator iter = requestParams.keySet().iterator(); iter.hasNext();) {
  12. String name = (String) iter.next();
  13. String[] values = (String[]) requestParams.get(name);
  14. String valueStr = "";
  15. for (int i = 0; i < values.length; i++) {
  16. valueStr = (i == values.length - 1) ? valueStr + values[i]
  17. : valueStr + values[i] + ",";
  18. }
  19. //乱码解决,这段代码在出现乱码时使用。如果mysignsign不相等也可以使用这段代码转化
  20. //valueStr = new String(valueStr.getBytes("ISO-8859-1"), "gbk");
  21. params.put(name, valueStr);
  22. }
  23. //获取支付宝的通知返回参数,可参考技术文档中页面跳转同步通知参数列表(以下仅供参考)//
  24. //商户订单号
  25. String out_trade_no = new String(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");
  26. //支付宝交易号
  27. String trade_no = new String(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");
  28. //交易状态
  29. String trade_status = new String(request.getParameter("trade_status").getBytes("ISO-8859-1"),"UTF-8");
  30. //获取支付宝的通知返回参数,可参考技术文档中页面跳转同步通知参数列表(以上仅供参考)//
  31. //计算得出通知验证结果
  32. //boolean AlipaySignature.rsaCheckV1(Map<String, String> params, String publicKey, String charset, String sign_type)
  33. boolean verify_result = AlipaySignature.rsaCheckV1(params, AlipayConfig.ALIPAY_PUBLIC_KEY, AlipayConfig.CHARSET, "RSA2");
  34. if(verify_result){//验证成功
  35. //////////////////////////////////////////////////////////////////////////////////////////
  36. //请在这里加上商户的业务逻辑程序代码
  37. //——请根据您的业务逻辑来编写程序(以下代码仅作参考)——
  38. if(trade_status.equals("TRADE_FINISHED")){
  39. //判断该笔订单是否在商户网站中已经做过处理
  40. //如果没有做过处理,根据订单号(out_trade_no)在商户网站的订单系统中查到该笔订单的详细,并执行商户的业务程序
  41. //请务必判断请求时的total_fee、seller_id与通知时获取的total_fee、seller_id为一致的
  42. //如果有做过处理,不执行商户的业务程序
  43. //注意:
  44. //如果签约的是可退款协议,退款日期超过可退款期限后(如三个月可退款),支付宝系统发送该交易状态通知
  45. //如果没有签约可退款协议,那么付款完成后,支付宝系统发送该交易状态通知。
  46. } else if (trade_status.equals("TRADE_SUCCESS")){
  47. //判断该笔订单是否在商户网站中已经做过处理
  48. //如果没有做过处理,根据订单号(out_trade_no)在商户网站的订单系统中查到该笔订单的详细,并执行商户的业务程序
  49. //请务必判断请求时的total_fee、seller_id与通知时获取的total_fee、seller_id为一致的
  50. //如果有做过处理,不执行商户的业务程序
  51. //注意:
  52. //如果签约的是可退款协议,那么付款完成后,支付宝系统发送该交易状态通知。
  53. }
  54. //——请根据您的业务逻辑来编写程序(以上代码仅作参考)——
  55. out.clear();
  56. out.println("success"); //请不要修改或删除
  57. //////////////////////////////////////////////////////////////////////////////////////////
  58. }else{//验证失败
  59. out.println("fail");
  60. }
  61. %>

五、支付测试


然后启动Tomcat,访问http://localhost:8080/alipay.trade.wap.pay-java-utf-8/index.html




点击第一个,进行下单




默认的就行了,然后点击确定














六、总结

如果不想,像上面那样那么繁琐,导入项目,配置这,配置哪的,直接想看下结果,可以直接运行以下几行代码就行了:

  1. /**
  2. * 网关地址(正式环境)
  3. */
  4. public static final String URL = "https://openapi.alipay.com/gateway.do";
  5. /**
  6. * 商户appid
  7. */
  8. pulbic static final String APP_ID = "";
  9. /**
  10. * 应用私钥 pkcs8格式的
  11. */
  12. pulbic static final String PRIVATE_KEY = "";
  13. /**
  14. * 支付宝公钥
  15. */
  16. pulbic static final String ALIPAY_PUBLIC_KEY = "";
  17. AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, PRIVATE_KEY, "json", "utf-8", , "RSA2");
  18. // 创建API对应的request
  19. AlipayTradeWapPayRequest alipayRequest = new AlipayTradeWapPayRequest();
  20. alipayRequest.setReturnUrl("https://xxx.xxx.xxx/open-pay/open-pay/aggregate/pay/QRPay");
  21. // 在公共参数中设置回跳和通知地址
  22. alipayRequest.setNotifyUrl("https://xxx.xxx.xxx/open-pay/alipay/notify_url");
  23. String out_trade_no = "20180502123456789";
  24. alipayRequest.setBizContent("{" +
  25. " \"out_trade_no\":\"" + out_trade_no + "\"," +
  26. " \"total_amount\":\"0.01\"," +
  27. " \"subject\":\"Iphone6 16G\"," +
  28. " \"product_code\":\"QUICK_WAP_PAY\"" +
  29. " }");//填充业务参数
  30. // 调用SDK生成表单
  31. String form = alipayClient.pageExecute(alipayRequest).getBody();
  32. //直接将完整的表单html输出到页面
  33. System.out.println(form);

输出的内容如下:

  1. <form name="punchout_form" method="post" action="https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.trade.wap.pay&sign=xxxxxx&return_url=xxxxxxx¬ify_url=xxxxxxxx&version=1.0&app_id=xxxx&sign_type=RSA2×tamp=2018-05-02+18%3A10%3A07&alipay_sdk=alipay-sdk-java-dynamicVersionNo&format=json">
  2. <input type="hidden" name="biz_content" value="{ "out_trade_no":"bkcZX2aalBhadz3BT", "total_amount":"0.01", "subject":"Iphone6 16G", "product_code":"QUICK_WAP_PAY" }">
  3. <input type="submit" value="立即支付" style="display:none" >
  4. </form>
  5. <script>document.forms[0].submit();</script>
他这里把HTML页面输出到页面然后,直接document.forms[0].submit()提交表单,调出支付宝进行支付。