写这篇文章的初衷是因为最近项目中涉及到较多支付模块，于是打算从这篇文章开始，陆续整理一下支付宝和微信的支付模块。每篇文末会给出最新整理的支付demo，会随着文章进度不断更新，一方面是自己的总结过程，另一方面希望能帮助到更多像我这种小白的程序汪。其实支付宝的官方文档和demo也很详细，本文只是做简要总结。

一、Wap支付产品介绍

　　这篇文章我们先来介绍一下支付宝Wap支付（也叫作手机网站支付），手机网站支付功能适用于商家在移动端网页应用中集成支付宝支付功能。 商家在网页中调用支付宝提供的网页支付接口调起支付宝客户端内的支付模块，商家网页会跳转到支付宝中完成支付，支付完后跳回到商家网页内，最后展示支付结果。

　　注意：手机网站支付产品不建议在APP端使用；如果需要在APP端中使用支付，请接入APP支付产品，接入文档详见 APP支付开发文档。（之后我会介绍APP支付）

1、应用场景

（1）用户已安装支付宝支付流程

　　步骤1：用户在浏览器中访问商家网页应用，选择商品下单、确认购买，进入支付环节，选择支付宝付款，用户点击去支付，如下图1；

　　步骤2：进入到支付宝支付路由页面，支付宝处理支付请求，并尝试唤起支付宝客户端，如下图2（此页无法自定义删除）；

　　步骤3：进入到支付宝页面，调起支付宝支付，出现确认支付界面，如下图3；

　　步骤4：用户确认收款方和金额，点击立即支付后出现输入密码界面，如下图4；

　　步骤5：输入正确密码后，支付宝端显示支付结果，如下图5；

　　步骤6：自动回跳到浏览器中，商家根据付款结果个性化展示订单处理结果，如下图6。

注意：

　　在iOS系统中，唤起支付宝App支付完成后，不会自动回到浏览器或商户App。用户可手工切回到浏览器或商户App。

（2）用户未安装支付宝支付流程

　　步骤1：若用户未安装支付宝客户端，用户可先点击支付宝支付路由页面里的 点这里下载支付宝APP 蓝色链接，下载支付宝，如图 7；

　　步骤2：成功下载并安装支付宝客户端后，点击支付宝支付路由页面里的 使用支付宝APP付款 按钮进行付款，如图 8；

　　步骤3：点击 使用支付宝APP付款 按钮后，重新开始如上所述的“用户已安装支付宝支付流程”步骤。

 注意事项：

　　（1）支付的时候可以配置退出地址和同步支付成功地址，后面我会提到

　　（2）现在新商户的wap支付已经取消了浏览器网页登录支付宝账号付款的功能，上面截图给出的就是新申请的商户支付截图，如果是老商户或者沙箱环境下，支付主页面会多一个“继续浏览器付款”的选项，至于为什么是“继续”，当然是因为wap支付是浏览器H5产品调用的，哈哈哈

　　（3）不要在微信浏览器中调取支付宝WAP支付，虽然微信浏览器也是浏览器，但是我们都知道这两家是死对头的，所以别问我为什么不能

　　（4）如果你没有正是环境的产品，可以设置沙箱环境，本人就是使用的沙箱环境

2、准入条件

申请前必须拥有经过实名认证的支付宝账户；

企业或个体工商户可申请；

需提供真实有效的营业执照，且支付宝账户名称需与营业执照主体一致；

网站能正常访问且页面显示完整，网站需要明确经营内容且有完整的商品信息；

网站必须通过ICP备案。如为个体工商户，网站备案主体需要与支付宝账户主体名称一致；

如为个体工商户，则团购不开放，且古玩、珠宝等奢侈品、投资类行业无法申请本产品。

3、计费模式

费率按单笔计算；

一般行业费率：0.6%；自2018年5月9日起，特殊行业新签约费率从1.2%调整为1%，特殊行业范围包括：休闲游戏；网络游戏点卡、渠道代理；游戏系统商；网游周边服务、交易平台；网游运营商（含网页游戏）。

4、使用说明

　　手机网站支付产品包含的接口和描述如下：

接口中文名

交易关闭接口

交易状态查询接口

交易退款接口

退款查询

账单查询接口

　　注意：其实除了alipay.trade.wap.pay 手机网站支付接口，其他接口对于其他产品都是通用的

二、准备工作

　　先上官方文档入口,支付宝文档入口模仿微信最最近做了更新，变得更简洁明了。

　　【官方手机网站支付快速接入文档】

1、创建应用并获取APPID

　　这个比较简单可以参考《开放平台应用创建指南》

　　这个部分我就不详细说了，一般我们作为开发人员不需要自己去处理这些应用申请的事情，会有专门的人员申请号相关产品，给到申请完成的支付宝账号密码登录，然后我们自己配置开发环境就ok了。因为申请应用会涉及到营业执照、备案域名等等信息要求，比较耽误时间，而且琐碎，所以这个我们就不用自己操心了，做好开发就行了。

2、配置应用环境

　　开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台管理中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详细步骤请参考《配置应用环境》。

　　不得不说支付宝简直是太贴心了，为了方便开发者生成一对RSA密钥支付宝提供一键生成工具，具体如何生成与配置密钥详见签名专区。

WINDOWSMAC_OSX

　　下载该工具后，解压打开文件夹，运行“RSA签名验签工具.bat”（WINDOWS）或“RSA签名验签工具.command”（MAC_OSX）。

　　以下演示截图

　　步骤1：下载工具保存在本地并傻瓜式安装，注意安装目录不要有空格和中文，保持优秀的开发习惯

　　步骤2：cmd命令运行或者点击桌面的快捷方式

 　　步骤3：设置密钥，将生成的“公钥字符串”粘贴保存设置，支付宝会生成对应的“支付宝公钥”，保存好你的公私钥信息，后面配置文件会用到。

注意事项：

　　生成的私钥需妥善保管，避免遗失，不要泄露。应用私钥需填写到代码中供签名时使用。应用公钥需提供给支付宝账号管理者上传到支付宝开放平台。

3、配置沙箱环境

　　注意：沙箱环境的密钥最好与正式上线的应用进行区分避免一些不必要的麻烦。WAP支付支持沙箱环境而app支付不支持沙箱环境

　　【官方介绍质料-箱环境使用说明】

 　　上传对应的公钥，沙箱账号待会在测试的时候回使用

 4、服务端实现（集成并且配置SDK）

　　【官方资源下载地址】

（1）引入　

关于sdk引入集成分别有以下两种方法

方法一：直接下载sdk包并修改pom.xml文件，引入sdk，步骤如下：

　　步骤1：下载sdk包到本地

　　步骤2：maven项目中使用本地jar包，首先我在项目根目录中创建一个lib文件夹，将jar包拷贝到lib文件夹下

 　　步骤3：然后我们在maven的pom.xml中配置

　　注意：这里的groupId和artifactId以及version都是可以随便填写的 ，scope必须填写为system，而systemPath我们现在我们jar包的地址就可以了

　　步骤4：我们必须在maven打包的过程中加入我们这个jar包。因为项目运行的时候需要这个Jar，并且我们得拷贝在WEB-INF/lib目录下。若不修改配置的话，打包不进去该sdk

方法二：直接maven的pom.xml引入中央仓库配置，过程如下截图

　　步骤1：点击“maven项目依赖”

 　　步骤2：选择你想引入的包文件，本人选择的是“3.3.87.ALL”

 　　步骤3：复制maven配置到你的pom.xml中

 （2）集成

　　在使用SDK调用具体API前，需要先配置通用接入参数

　　然后，使用上述接入参数初始化AlipayClient，这里只是描述过程，后面会告诉你具体怎么配置

　　接下来，就可以用alipayClient来调用具体的API了。

　　注意：

　　（1）alipayClient只需要初始化一次，后续调用不同的API都可以使用同一个alipayClient对象。

　　（2）手机网站支付不支持第三方授权，不能代商家发起请求。

5、调用接口

　　手机网站支付产品包含两类API：页面跳转类：需要从前端页面以Form表单的形式发起请求，浏览器会自动跳转至支付宝的相关页面（一般是收银台或签约页面），用户在该页面完成相关业务操作后再回跳到商户指定页面。例如本产品中的手机网站支付接口alipay.trade.wap.pay。

　　系统调用类：直接从服务端发起HTTP请求，支付宝会同步返回请求结果。例如本产品中的交易查询等配套API。

6、调用流程图

三、服务端具体封装和操作过程

　　对于页面跳转类API，SDK不会也无法像系统调用类API一样自动请求支付宝并获得结果，而是在接受request请求对象后，为开发者生成前台页面请求需要的完整form表单的html（包含自动提交脚本），商户直接将这个表单的String输出到http response中即可。

　　哈哈，前面讲了那么多的准备工作，相信你对支付宝的wap支付流程已经有了一个初步的了解，现在我们来看一下具体的封装过程

1、将支付宝通用参数独立配置在一个属性文件中方便管理

 　　支付宝alipay.properties文件配置信息如下：

2、读取配置文件信息

 　　AliPayProperties.java文件的具体内容如下，与alipay.properties的属性信息一致，读取的就是配置文件的信息，封装成实体类，方便直接使用，后续若修改切换支付宝信息，只需要修改alipay.properties文件信息即可，例如切换沙箱环境为正式环境

3、加载接入参数并初始化AlipayClient

　　AliPayUtil.java的实例化代码信息如下：

注意：

　　（1）alipayClient只需要初始化一次，后续调用不同的API都可以使用同一个alipayClient对象。

　　（2）我为了后面在业务层中直接调取该静态API里面封装好的方法（后面会给出对应方法），将其定义为了一个工具类，而该工具类需要注入读取 AliPayProperties 里面的属性，所以需要在该类上打上 @Component 注解

　　（3）我为了后面将其他支付API全部定义为静态方法直接调用，这里初始化的时候将 alipayClient 定义为了静态变量，所以需要将 AliPayProperties 也定义为静态变量，但是由于 @Autowired 注解不能作用于静态变量，所以借助静态变量 staticAliPayProperties 作为过渡，并在初始化的方法里面，让 staticAliPayProperties = aliPayProperties;

4、利用sdk封装wap支付代码

　　通用模块，就在demo里面的 AliPayUtil.java 里面

5、模拟支付请求

　　步骤1：控制层 AliPayController.java 写请求方法 alipayTradeWapPay

　　步骤2：调取的接口和实现类

注意：

　　（1）这里我随机生成了商户订单号 out_trade_no，交易金额 total_amount 写死了，正常业务处理中，我们是根据你的业务实际情况处理

　　（2）里面涉及到的其他的工具类，最后的demo里面会提供。当然，你也可以自己随机商城，保持不重复的原则即可

　　（3）实际操作中，在调取之前，我们需要处理具体的业务逻辑，因为本文只总结支付宝相关的，就不补充了。例如：订单金额计算处理；商户订单和支付宝订单的关联和存储，商户订单和支付宝订单可能是多对一的关系；支付宝订单需要保存，因为在回调的时候你需要根据支付宝订单的 out_trade_no 识别支付宝通知的订单结果；你可以把它存储在redis或者持久化到数据库中。

　　步骤3：模拟支付请求

　　这里，我是写了一个html页面，通过前端请求到后台调取控制层方法模拟实际支付请求的

　　对于页面跳转类API，SDK不会也无法像系统调用类API一样自动请求支付宝并获得结果，而是在接受request请求对象后，为开发者生成前台页面请求需要的完整form表单的html（包含自动提交脚本），对于返回的该form表单，通常有两种方式处理，一种是后端，一种是前端

　　前端：获取后端返回的form数据对象，取到表单对象并直接自动提交到支付宝，也就是上面和demo中的这种处理方式

　　后端：商户直接将这个表单的String输出到http response中即可，处理方式可以如下（以下两种方式是我在项目过程中的处理，并不在此次demo中，仅供参考），处理差异和细节已经重点标出来了

　　方法一：

　　方法二：

 　　注意的是：这种处理方式的请求一般不是上面的json请求模式，而是直接get页面请求跳转的模式

6、运行查看测试结果

　　右键运行demo中的 PayDemoApplication.java 文件，浏览器输入 localhost:8080查看，当然你也可以修改application.properties配置文件中的端口号

　　点击“H5手机网站支付”按钮，其他按钮功能开发后面有时间会发博文介绍，不过demo里面已经有了，你也可以自己先测试，请求后控制台日志显示

 　　详细form内容如下：

　　我们可以很清楚的看到，支付宝返回的是一个form表单的内容，我们在前端接收后按照上面前端的处理方法处理后，发现点击“H5手机网站支付”按钮之后，直接跳到了支付宝下面页面，按照以下步骤操作就行

注意事项：

　　（1）由于我用的是沙箱环境，所以输入的是沙箱买家账号和密码测试的，出来的页面有“继续浏览器付款”和“使用支付宝APP付款”两个选项，如果选择支付宝APP付款需要在手机上安装沙箱钱包才行。现在新商户接入的正式环境调取页面是没有这个选项的，必须安装支付宝钱包的，具体区别在产品介绍模块有提到。页面如下：

 　　（2）在测试的时候我们发现如果返回不支付（退出、取消支付等）和支付完成之后，支付宝跳到了相关的页面，这个原因我们在后面同步异步回调模块会介绍到。

 四、同异步结果处理

　　你以为在成功调取支付宝页面支付了，我们的操作就结束了么，远远没有，因为我们发现我们只是调取了支付宝的支付页面，关于支付响应和结果，也就是是否支付了，支付是否成功了，我们并不知道。聪明的支付宝早就为我们考虑到了，所以他为我们提供了三个参数来处理，我们回过头来看看配置文件和调取方法，分别如下：

1、同步回调通知

　　步骤1：设计支付宝同步通知的controller入口，接收支付宝的通知

　　注意：该controller的入口路径必须与你的配置文件里面的return_url保持一致，并且支持get接收

　　步骤2：设计接口和实现类验签，做你想做的

　　其中涉及到的工具类如下：