自己个人拥有一个可以支付功能的网站?当然可以了!保姆级演示!

21,327 阅读6分钟

前提条件

这是必要条件!!! 这是必要条件!!! 这是必要条件!!! 开通当面付,个人、企业账号均可!!!


演示

获取订单点击,然后扫码支付 在这里插入图片描述

支付成功后就会响应支付成功 在这里插入图片描述

应用申请开通和配置

接下来介绍应用的创建和配置,一定要仔细哦!!!

应用创建

首先进入支付宝开放平台,进入控制台,创建一个应用,大概1个工作日内就会审核 在这里插入图片描述

把这几个必填项填写,然后确认创建,注意名字要清晰,应用图标要有一定的可识别性,不然不给过,应用类型选网页应用

在这里插入图片描述

应用配置

创建好后,进入产品详情页面,点击产品绑定,然后去绑定 在这里插入图片描述

选择支付 -> 当面付[勾选] -> 绑定,另外你还可以找到花呗支付,这样用户扫码时就支持花呗支付了 在这里插入图片描述

要确认是开通状态哦,如果没有开通需要开通哦,看上面的 前提条件 在这里插入图片描述

然后需要配置密钥,点击下图中侧边栏中的 开发设置,需要配置的是 接口加签方式(证书/密钥)

  • 接口加签方式(证书/密钥):配置支付宝开放平台会引导你下载安装密钥生成工具,生成一个应用公钥和应用私钥,私钥一定要保管好,不要泄露,保存到本地,到时候配置在服务器上,然后把应用公钥配置在开放平台上,就算配置完成了,支付宝就会给到你一个支付宝公钥,接下来你一共有三个密钥,支付宝公钥、应用公钥、应用私钥,这三个一定要分清,接下来文章介绍的所需要用到的密钥只有这三个,清一定要分清!!!

在这里插入图片描述


代码开发

接下来你可以结合着官方的开发文档看我的文章,官方文档:opendocs.alipay.com/open/02ekfg…

  • 本文后端以Java的开发方式,仅供参考!
  • Web前端使用原生Html+CSS+JavaScript简单实现,仅供参考!
  • 安卓调用可以参考我这篇文章:myhub.blog.csdn.net/article/det…

后端实例

SDK集成

首先获取相应的SDK,SDK下载页面(官方):opendocs.alipay.com/open/54/103…

我这里以Maven的方式集成,另外我集成了zxing,用于生成支付二维码使用

 <!--alipay SDK-->
<dependency>
	<groupId>com.alipay.sdk</groupId>
	<artifactId>alipay-sdk-java</artifactId>
	<version>4.35.9.ALL</version>
</dependency>

<!-- zxing -->
<dependency>
	<groupId>com.google.zxing</groupId>
	<artifactId>core</artifactId>
	<version>3.5.1</version>
</dependency>

Controller实例

  • 生成付款二维码,我标明了详细的注释,可以直接看!
  • 由于涉及到公钥、私钥等信息,这些部分我都用了 **************来表示,
  • 记得替换哦!!!
  • 记得替换哦!!!
  • 记得替换哦!!!
  • 替换成你自己的!!!

以下为简单的Demo演示,一定要结合官方文档,阅读接入注意事项:opendocs.alipay.com/open/194/10…

package com.demo.pay;

import com.alibaba.fastjson.JSONObject;
import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.internal.util.AlipaySignature;
import com.alipay.api.request.AlipayTradePrecreateRequest;
import com.alipay.api.request.AlipayTradeQueryRequest;
import com.alipay.api.response.AlipayTradePrecreateResponse;
import com.alipay.api.response.AlipayTradeQueryResponse;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;

import javax.imageio.ImageIO;
import javax.servlet.http.HttpServletRequest;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;
import java.util.HashMap;
import java.util.Map;

/**
 * @author ThirdGoddess
 * @version 1.0.0
 * @time 2022/12/22 14:37
 * @desc AliPay当面付Demo
 */
@RestController
@RequestMapping("pay")
public class AliPayController {

    //模拟一个用户的支付状态
    private boolean userPayState = false;

    //==================================================================================================================
    //这里都是固定的

    //支付宝网关地址
    private static final String SERVER_URL = "https://openapi.alipay.com/gateway.do";

    //charset
    private static final String CHARSET = "GBK";

    //format
    private static final String FORMAT = "json";

    //sign type
    private static final String SIGN_TYPE = "RSA2";

    //==================================================================================================================
    //下面这三个是需要配置的

    //APPID,即创建应用的那个ID,在应用详情中的左上角可以看到
    private static final String APPID = "**************";

    //应用私钥,注意是应用私钥!!!应用私钥!!!应用私钥!!!
    private static final String APP_PRIVATE_KEY = "**************";

    //支付宝公钥,注意是支付宝公钥!!!支付宝公钥!!!支付宝公钥!!!
    private static final String ALIPAY_PUBLIC_KEY = "**************";

    /**
     * 获取二维码
     * 获取的是用户要扫码支付的二维码
     * 创建订单,带入自己的业务逻辑
     */
    @RequestMapping(value = "/getQr", produces = MediaType.IMAGE_JPEG_VALUE)
    @ResponseBody
    public byte[] getQr() {

        userPayState = false;

        AlipayClient alipayClient = new DefaultAlipayClient(SERVER_URL, APPID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);
        AlipayTradePrecreateRequest request = new AlipayTradePrecreateRequest();

        //配置这是一个url,下图我已经配置好了,这个意思是当用户成功后,支付宝那边会调用这个地址url,他会给你传过去一些订单信息,
        //你处理完你的业务逻辑给支付宝响应success就行,就代表这个订单完成交易了!
        //* 建议前期开发的时候加上内网穿透调试,不然支付宝是没有办法调到你开发的接口的
        request.setNotifyUrl("http://**************.com/pay/payNotification");

        JSONObject bizContent = new JSONObject();

        //自己生成一个订单号,我这里直接用时间戳演示,正常情况下创建完订单需要存储到自己的业务数据库,做记录和支付完成后校验
        String orderNumber = "pay" + System.currentTimeMillis();

        bizContent.put("out_trade_no", orderNumber);//订单号
        bizContent.put("total_amount", 0.01);//订单金额
        bizContent.put("subject", "demo");//支付主题,自己稍微定义一下
        request.setBizContent(bizContent.toString());

        try {
            AlipayTradePrecreateResponse response = alipayClient.execute(request);
            if (response.isSuccess()) {
                System.out.println("调用成功");
            } else {
                System.out.println("调用失败");
            }

            //获取生成的二维码,这里是一个String字符串,即二维码的内容;
            //然后用二维码生成SDK生成一下二维码,弄成图片返回给前端就行,我这里使用Zxing生成
            //其实也可以直接把这个字符串信息返回,让前端去生成,一样的道理,只需要关心这个二维码的内容就行
            String qrCode = response.getQrCode();

            //生成支付二维码图片
            BufferedImage image = QrCodeUtil.createImage(qrCode);

            ByteArrayOutputStream out = new ByteArrayOutputStream();
            ImageIO.write(image, "jpeg", out);
            byte[] b = out.toByteArray();
            out.write(b);
            out.close();

            //最终返回图片
            return b;
        } catch (Exception e) {
            e.printStackTrace();
            System.out.println("调用失败");
        }
        return null;
    }

    /**
     * 支付完成后支付宝会请求这个回调
     */
    @PostMapping("payNotification")
    public String payNotification(HttpServletRequest request) {
        Map<String, String> params = new HashMap<>();
        Map<String, String[]> requestParams = request.getParameterMap();
        for (String name : requestParams.keySet()) {
            String[] values = requestParams.get(name);
            String valueStr = "";
            for (int i = 0; i < values.length; i++) {
                valueStr = (i == values.length - 1) ? valueStr + values[i] : valueStr + values[i] + ",";
            }
            params.put(name, valueStr);
        }

        for (Map.Entry<String, String> entry : params.entrySet()) {
            System.out.println("Key = " + entry.getKey() + ", Value = " + entry.getValue());
        }

        //==============================================================================================================
        try {
            //执行验签,确保结果是支付宝回调的,而不是被恶意调用,一定要做这一步
            boolean signVerified = AlipaySignature.rsaCheckV1(params, ALIPAY_PUBLIC_KEY, CHARSET, SIGN_TYPE);
            if (signVerified) {
                //验签成功,继续执行业务逻辑
                System.out.println("验签成功");

                //再次主动查询订单,不要只依赖支付宝回调的结果
                String orderStatus = searchOrderStatus(params.get("out_trade_no"), params.get("trade_no"));
                switch (orderStatus) {
                    case "TRADE_SUCCESS"://交易支付成功;
                    case "TRADE_FINISHED": //交易结束,不可退款;
                        //TODO 在这里继续执行用户支付成功后的业务逻辑
                        userPayState = true;
                        break;
                }
                return "success";
            } else {
                //验签失败(很可能接口被非法调用)
                System.out.println("验签失败");
                return "fail";
            }
        } catch (AlipayApiException e) {
            e.printStackTrace();
            return "fail";
        }
    }

    /**
     * 封装一个订单查询
     *
     * @param outTradeNo 商户订单号
     * @param tradeNo    支付宝交易号。支付宝交易凭证号
     * @return 订单状态:String
     * @throws AlipayApiException AlipayApiException
     * @desc "WAIT_BUYER_PAY":交易创建,等待买家付款;"TRADE_CLOSED":未付款交易超时关闭,或支付完成后全额退款; "TRADE_SUCCESS":交易支付成功;"TRADE_FINISHED":交易结束,不可退款;
     */
    private String searchOrderStatus(String outTradeNo, String tradeNo) throws AlipayApiException {
        AlipayClient alipayClient = new DefaultAlipayClient(SERVER_URL, APPID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE); //获得初始化的AlipayClient
        AlipayTradeQueryRequest aliRequest = new AlipayTradeQueryRequest();//创建API对应的request类
        JSONObject bizContent = new JSONObject();
        bizContent.put("out_trade_no", outTradeNo);
        bizContent.put("trade_no", tradeNo);
        aliRequest.setBizContent(bizContent.toString()); //设置业务参数
        AlipayTradeQueryResponse response = alipayClient.execute(aliRequest);//通过alipayClient调用API,获得对应的response类
        JSONObject responseObject = JSONObject.parseObject(response.getBody());
        JSONObject alipayTradeQueryResponse = responseObject.getJSONObject("alipay_trade_query_response");
        return alipayTradeQueryResponse.getString("trade_status");
    }

    /**
     * 前端轮询查询这个接口,来查询订单的支付状态
     *
     * @return OrderStateEntity
     */
    @CrossOrigin
    @GetMapping("searchOrder")
    public OrderStateEntity searchOrder() {
        //userPayState是一个模拟值
        if (userPayState) {
            //用户支付成功了
            return new OrderStateEntity(200, "支付成功了");
        } else {
            //用户还没有支付
            return new OrderStateEntity(201, "你还没有支付哦");
        }
    }

    /**
     * 响应给前端的实体
     */
    static class OrderStateEntity {
        private int code;
        private String msg;

        public OrderStateEntity(int code, String msg) {
            this.code = code;
            this.msg = msg;
        }

        public int getCode() {
            return code;
        }

        public void setCode(int code) {
            this.code = code;
        }

        public String getMsg() {
            return msg;
        }

        public void setMsg(String msg) {
            this.msg = msg;
        }
    }

}


用户支付后的回调

当使用setNotifyUrl后,用户成功支付后,会回调其设置的url,如 ==setNotifyUrl("xxx.com/pay/payNoti… ,那么支付宝会等待用户支付成功后会以POST去请求 ==xxx.com/pay/payNoti… 这个地址来达成回调,需要响应success或者fail,只有这两种值哦!

响应值描述异步是否重试发送
fail消息获取失败重试
success消息获取成功不重试

前端代码实例

<!DOCTYPE html>
<html lang="en">
<head>
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <meta charset="UTF-8">
    <title>支付宝当面付Demo演示</title>
    <style>
        * {
            margin: 0 auto;
        }
        .root {
            width: 260px;
        }
        .img_box {
            width: 260px;
            height: 260px;
            background-color: #adadad;
        }
        button {
            width: 260px;
            margin-top: 12px;
        }
    </style>
</head>
<body>
<div class="root">
    <div class="img_box"><img width="260" height="260" id="qr" src="" alt=""></div>
    <button onclick="getOrderQr()">获取订单</button>
    <div class="response" id="response"></div>

    <script>

        /**
         * 获取一个二维码
         */
        function getOrderQr() {
            let qrImg = document.getElementById('qr');
            qrImg.src = "http://**************.com/pay/getQr?time=" + new Date().getTime()

            //开始轮询查询订单
            orderResponse()
        }

        let number = 1;
        const responseView = document.getElementById('response')

        /**
         * 循环查询订单响应
         */
        function orderResponse() {

            //每2秒查询一次支付状态
            setTimeout(function () {
                //请求接口查询支付状态
                const xhr = new XMLHttpRequest();
                xhr.open('GET', "http://**************.com/pay/searchOrder", true);
                xhr.send(null);
                xhr.onreadystatechange = function () {
                    if (xhr.status === 200 && xhr.readyState === 4) {
                        const json = JSON.parse(xhr.responseText);
                        if (200 === json.code) {
                            //支付成功
                            responseView.innerText = xhr.responseText
                        } else {
                            //没有支付,继续下一次查询
                            responseView.innerText = '第' + number + '次查询,结果:' + xhr.responseText
                            number++
                            orderResponse()
                        }
                    }
                }
            }, 2000)
        }
    </script>
</div>
</body>
</html>

源码

Github:github.com/ThirdGoddes…