保姆级教程：SpringBoot 对接支付宝完成扫码支付，完整流程梳理！

1、支付方式选择 2、交互流程 3、1. 对接准备 2.加密解密 + 签名验签 3.沙箱环境 4、内网穿透 5、二维码 6、下单 7、异步通知回调 8、查询支付结果 9、退款 10、通用版SDK

需求：系统A对接支付宝，实现支持用户扫码支付

1、支付方式选择

对接的API文档：

• https://open.alipay.com/api

  可选的支付方式有：

  • 扫码付：出示付款码或者用户扫码付款

  • APP支付：在APP中唤起支付宝

  • 手机网站支付：在移动端网页中唤起支付宝 App 或支付宝网页

  • 电脑网站支付：在PC端唤起支付宝App或者网页登录支付宝账户

  • 刷脸付：需硬件支持

  • 商家扣款：类似每月会员扣款

  • 预授权支付：冻结对应额度，交易完成后给商家

  • JSAPI支付：小程序

    这里选择扫码付的方式，点击下单后，返回支付二维码，用户扫码支付。

    2、交互流程

    画个下单流程的时序图：

    图片

    大致流程：

    • 用户下单，系统A组装信息后（订单信息、回调地址、签名），调用支付宝预下单接口，返回二维码链接

    • 系统A将二维码链接转二维码图片

    • 用户扫码，唤醒本地支付宝，完成支付

    • 支付宝返回支付成功信息给用户

    • 支付宝异步通知系统A支付成功的消息（回调地址），如果用户支付成功，支付宝就调用回调地址的API，回调接口中自然是系统A收到用户支付成功消息后的动作

    • 上一步如果通知失败，比如网络异常或支付宝调用异步通知接口时系统A正好挂了 ⇒ 可主动调支付宝提供的查询支付结果接口，或者加定时任务轮询来查询交易状态，如3s-5s

    • 还可以考虑在第一步请求支付宝接口时加上二维码的有效时间，过期就重新发起

      查询支付结果流程：

      图片

      退款流程同上查询支付结果。PS：注意下单、退款过程中，相关订单的业务数据落库到系统A。

      3、对接准备

      1）加密解密 + 签名验签

      支付信息不能在网络上明文传输，以防被篡改。系统A到支付宝的方向，采用：

      • 支付宝公钥加密 + 系统A的私钥签名（系统A做的事）

      • 支付宝私钥解密 + 系统A的公钥验签（收到信息后，支付宝做的事）

        同理，支付宝返回支付结果时，就是在支付宝中用系统A的公钥加密+支付宝的私钥签名，传输到系统A后，则是先用支付宝的公钥验签，再用系统A的私钥解密支付结果

        图片

        2）沙箱环境

        调试过程中，可采用支付宝提供的沙箱环境，点击右上角控制台，登录后选择沙箱：

        图片

        这里有一套可调试的APPID、系统A的公钥、密钥、支付宝的公钥、支付宝的网关地址，以及商家账户和用户账户（用于后续登录沙箱版本支付宝APP完成支付）

        图片

        图片

        点击【沙箱工具】侧边栏，下载沙箱版支付宝APP，等于上面的买家账户。

        3）内网穿透

        前面提到，用户支付成功后，支付宝需要回调系统A接口来通知系统A，但我的开发环境在内网，支付宝访问不到，考虑做内网穿透，让支付宝通知到一个中转地址，再由中转地址到我的内网。穿透工具选择cpolar，下载地址 https://dashboard.cpolar.com/get-started，下载后，解压并安装msi包

        图片

        双击exe文件，执行认证：

        cpolar authtoken xxxx

        图片

        创建隧道，建立链接：

        cpolar http 9527//返回结果Forwarding http://maggie.cpolar.io  -> localhost:9527Forwarding https://maggie.cpolar.io  -> localhost:9527

        转发成功。此时，给支付宝访问forward的地址即可，比如系统A的异步通知接口：

        localhost:9527/notify

        那就是：

        http://maggie.cpolar.io/notify

        4、二维码

        二维码是消息的载体。平时玩可直接在草料二维码UI页面，这里需要给系统A的订单服务用代码生成二维码。二维码中的信息自然是支付宝预下单返回的url。

        Java生成二维码可集成zxing库，但这样得自己两层for填充方格子，这里选择hutool工具类库（对zxing的二次封装），引入依赖：

            cn.hutool    hutool-all    5.7.22    com.google.zxing    core    3.4.1

        调用方式：

        //生成直到url对应的二维码，宽高均300像素，可到路径，也可到Http响应QrCodeUtil.generate("https://url/path", 300, 300, "png", httpServletResponse.getOutPutStream());

        也可引入QrConfig对象，设置其他属性：

        QrConfig config = new QrConfig(300, 300);//纠错级别config.setErrorCorrection(ErrorCorrectionLevel.H);//二维码颜色config.setBackColor(Color.BLUE);QrCodeUtil.generate("https://www.baidu.com", config, new File("D:\code.png"));

        5、下单

        支付宝提供的SDK 中已经对加签验签逻辑做了封装，使用 SDK 时传入支付宝公钥等内容可直接通过 SDK 自动进行加验签。SDK文档地址：https://opendocs.alipay.com/open/54/103419?pathHash=d6bc7c2b 。支付宝提供了两种SDK：

        • 通用版SDK

        • 简易版SDK

          官网有通用版的API代码示例，这里走简易版的。引入简易版SDK的依赖：

              com.alipay.sdk    alipay-easysdk    2.2.0

          在application.yml配置文件中统一写密钥、通知地址等（生产环境不要将私钥信息配置在源码中，例如配置为常量或储存在配置文件中，这样源码一丢，这些保密信息都泄漏了，放安全区域或服务器，运行时读取即可）

          alipay:  easy:    protocol: https    gatewayHost: openapi-sandbox.dl.alipaydev.com    signType: RSA2    appId: 9021000133624745    merchantPrivateKey: MIIEvQIBADANBgkqhkiG9w0B    alipayPublicKey: MIIBIjANBgkqhkiG9w0BAQEFAAOC    notifyUrl: http://maggie.cpolar.io/notifyserver:  port: 9527

          @ConfigurationProperties注解统一读到：

          @Configuration@Data@ConfigurationProperties(prefix = "alipay.easy")public class AliPayConfigInfo {    /**     * 请求协议     */    private String protocol;    /**     * 请求网关     */    private String gatewayHost;    /**     * 签名类型     */    private String signType;    /**     * 应用ID（来自支付宝申请）     */    private String appId;    /**     * 应用秘钥     */    private String merchantPrivateKey;    /**     * 支付宝公钥     */    private String alipayPublicKey;    /**     * 支付结果异步通知的地址     */    private String notifyUrl;    /**     * 设施AES秘钥     */    private String encryptKey;}

          将配置处理成Config类型的Bean，方便后面传入Config对象：

          @Configurationpublic class AliPayConfig {    @Bean    public Config config(AliPayConfigInfo configInfo){        Config config = new Config();        config.protocol = configInfo.getProtocol();        config.gatewayHost = configInfo.getGatewayHost();        config.signType = configInfo.getSignType();        config.appId = configInfo.getAppId();        config.merchantPrivateKey = configInfo.getMerchantPrivateKey();        config.alipayPublicKey = configInfo.getAlipayPublicKey();        config.notifyUrl = configInfo.getNotifyUrl();        config.encryptKey = "";        return config;    }}

          写下单接口，响应一个二维码给前端，这里业务数据、订单编号直接写***，只做示意：

          @RestController@Slf4jpublic class PayController {    @Resource    private Config config;    /**     * 收银台点击结账     * 发起下单请求     */    @GetMapping("/pay")    public void pay(HttpServletRequest request, HttpServletResponse response) throws Exception {        Factory.setOptions(config);        //调用支付宝的接口        AlipayTradePrecreateResponse payResponse = Factory.Payment.FaceToFace().preCreate("订单主题：Mac笔记本", "LS123qwe123", "19999");        //参照官方文档响应示例，解析返回结果        String httpBodyStr = payResponse.getHttpBody();        JSONObject jsonObject = JSONObject.parseObject(httpBodyStr);        String qrUrl = jsonObject.getJSONObject("alipay_trade_precreate_response").get("qr_code").toString();        QrCodeUtil.generate(qrUrl, 300, 300, "png", response.getOutputStream());    }}

          6、异步通知回调

          异步回调参考文档：https://opendocs.alipay.com/open/194/103296?pathHash=e43f422e&ref=api，实现先全放Controller层了：

          @RestController@Slf4jpublic class PayController {    @Resource    private Config config;     /**     * 给支付宝的回调接口     */    @PostMapping("/notify")    public void notify(HttpServletRequest request, HttpServletResponse response) throws Exception {        Map params = new HashMap();        //获取支付宝POST过来反馈信息，将异步通知中收到的待验证所有参数都存放到map中        Map parameterMap = request.getParameterMap();        for (String name : parameterMap.keySet()) {            String[] values = parameterMap.get(name);            String valueStr = "";            for (int i = 0; i