支付宝接口对接指南（四、回调通知对接：websoket方式）【保姆级】

最新推荐文章于 2025-03-20 14:54:28 发布

置顶翟凤玺

最新推荐文章于 2025-03-20 14:54:28 发布

阅读量2.5k

点赞数 2

分类专栏：支付宝开放接口对接 java 文章标签： java spring boot 支付宝

本文链接：https://blog.youkuaiyun.com/u010318957/article/details/113179884

版权

java 同时被 2 个专栏收录

17 篇文章

订阅专栏

支付宝开放接口对接

4 篇文章

订阅专栏

本文详细介绍如何使用WebSocket方式完成支付宝回调通知对接，包括基础搭建、核心代码实现及常见问题解决。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

导读

经过前三篇的解读，对支付宝开放接口对接已经有了大体的了解，下面针对支付宝回调通知对接进行详细阐述，完成整体的支付宝接口对接闭环。开门见山。老规矩先上gitee代码。

gitee代码地址

https://gitee.com/zhaifengxi/zhai-docking-alipay-open

案例：新蓝海活动报名结果通知

支付宝开放接口文档解读

一、新蓝海活动报名结果通知文档地址

https://opendocs.alipay.com/apis/01ebii

二、蚂蚁金服消息文档

地址：https://opendocs.alipay.com/open/10381/rkohsn
消息的两种模式：1. From 蚂蚁消息服务 2.To 蚂蚁消息服务
From 蚂蚁消息服务：支付宝通知对接平台的消息服务，新蓝海活动报名结果通知选用此模式来接收回调通知。
To蚂蚁消息服务：对接平台发送消息给支付宝平台。未使用，所以不展开说明。

From 蚂蚁消息服务

两种对接方式：1.http(s)协议 2.websocket长连接
官方原话：与 http(s) 相比，该方式接入性能更优，通道安全，减少成本，接入快速等优势，推荐使用 websocket 长连接 SDK 来接收 From 蚂蚁消息。所以选择使用此方式。
消息通知间隔频率：2m、10m、10m、1h、2h、6h、15h

核心代码

一、支付宝基础服务层

@Slf4j
@Service
public class BaseAlipayApiNotifySerImpl implements BaseAlipayApiNotifySer {
    @Autowired
    AlipayApiProperties alipayApiProp;
    @Autowired
    BizLogSer bizLogSer;

    @SneakyThrows
    @Override
    public String alipayMessage() {
        AlipayMsgClient alipayMsgClient = AlipayMsgClient.getInstance(alipayApiProp.getAppid());
        alipayMsgClient.setConnector(AlipayConstant.COMMON_MESSAGE_SERVER_URL);
        alipayMsgClient.setSecurityConfig(AlipayConstant.COMMON_SIGN_TYPE, alipayApiProp.getPrivateKey(), alipayApiProp.getPublicKey());
        alipayMsgClient.setMessageHandler(new MsgHandler() {
            /**
             * 客户端接收到消息后回调此方法
             * @param msgApi 接收到的消息的消息api名
             * @param msgId 接收到的消息的消息id
             * @param bizContent 接收到的消息的内容，json格式
             */
            @Override
            public void onMessage(String msgApi, String msgId, String bizContent) {
                /** 操作：记录业务日志 */
                BaseAlipayApiMessage message = new BaseAlipayApiMessage();
                message.setMsgApi(msgApi);
                message.setMsgId(msgId);
                message.setBizContent(bizContent);
                bizLogSer.save(new BizLogSave(new BizLogDataTemp(message, null), AlipayConstant.MESSAGE_LOG));

            }
        });
        /** 开启websoket长连接 */
        alipayMsgClient.connect();
        return JSONUtil.toStr(alipayMsgClient);
    }
}

BaseAlipayApiNotifySerImpl.java 详情：https://gitee.com/zhaifengxi/zhai-docking-alipay-open/blob/master/src/main/java/zhai/docking/alipay/service/base/alipay/api/notify/BaseAlipayApiNotifySerImpl.java

二、服务启动后开启websoket长连接

@Component
public class StartupRunner implements CommandLineRunner {
    @Autowired
    BaseAlipayApiNotifySer baseAlipayApiNotifySer;

    @Override
    public void run(String... args) throws Exception {
        /**
         * 保证每次服务启动时，调用蚂蚁金服connect方法
         */
        String result = baseAlipayApiNotifySer.alipayMessage();
    }
}