news 2026/6/10 18:30:51

支付宝H5支付接入实战:Java一站式解决方案

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
支付宝H5支付接入实战:Java一站式解决方案

01 引言

支付产品千千万,作为领军产品的当属微信和支付宝。支付产品的接入常用的场景越来越多,同一个产品,又分很多场景的支付场景。以支付宝为例,支付的产品包括当面付、APP支付、手机网站支付等,每一种产品都对应不同的支付场景。

刚好这段时间因为业务需要接入支付宝的H5支付,整理一下分享给大家。

02 H5支付介绍

2.1 产品介绍

H5支付在支付宝产品内部叫手机网站支付,是支付宝面向移动端网页场景提供的支付解决方案。用户在使用手机浏览器访问商户网页时,可通过调用支付宝客户端或跳转到支付宝网页完成支付。相比传统的PC端支付,H5支付更适合移动端用户,提供更流畅的支付体验。

简单来讲就是再没有支付宝生态的环境下的一种支付方式,也叫支付宝外支付。

2.2 角色介绍

支付宝的开放业务存在三种角色类型:

  • **开发者角色:**需要开发者账号,一般登录支付宝 开放平台 完成应用开发相关操作。
  • **商家角色:**需要商家账号,一般登录 商家服务平台 开通支付服务并完成商家经营相关操作。
  • **服务商角色:**需要服务商账号,一般登录 服务商平台 完成协助商家开通产品等操作。

作为公司直连产品,主要就是两个角色:开发者和商家

同时不同的角色需要进入不同的平台设置。商家也就是收款方,一般就是公司需要申请收款账号。开发者也就是开发人员需要配置API属性,使用的账号可以直接使用商家的账号即可。

03 H5支付接入-开放平台

H5支付的接入官方文档介绍的相当详细,但是开发平台和商家平台来回跳可能会将人绕晕,我们将逐步拆解。

官方文档贴心的提供了检测小工具,如上图。

官方接入文档:https://opendocs.alipay.com/open/203/107084

3.1 开放平台创建应用

首先需要开发者在开放平台创建 网页/移动应用。

创建完成之后等待官方审核,一般一个工作日之内完成审核。

3.2 开放平台配置应用

我们需要关注的配置有接口加签方式、接口内容加密方式以及openid配置管理。

接口加签方式

接口加签必填选项,用于防止数据篡改,保障应用和支付宝交互的安全性

需要接入官方秘钥工具生成即可。

官方统一工具地址:https://opendocs.alipay.com/common/02kipk

最终我们生成的秘钥文件包括:应用公钥和私钥

还有一个支付宝公钥:

其中支付宝公钥和应用私钥参与代码逻辑。

接口内容加密方式

这个选填项,用于加 / 解密OpenAPI bizContent报文内容,可大幅提升接口内容传输的安全性。

openid配置管理

openid配置管理是新版默认开启的参数。低版本支付宝服务端SDK不支持获取openid,在使用openid开发接入前,请先确保使用的SDK符合版本要求:

开发语言SDK版本要求
Java4.35.37 及以上的版本
.NET4.7.144 及以上的版本
PHP4.19.30 及以上的版本
PYTHON3.6.528 及以上的版本

否则会出现不支持的提示:

到这里,开发平台基本就配置好了。

3.3 应用APPID

这里的APPID需要和商家后台绑定。

3.4 开放平台

开放平台是独立的平台。

开放平台地址:https://openhome.alipay.com/

04 H5支付接入-商家平台

商家平台地址:https://b.alipay.com/page/home

4.1 绑定APPID

登录 商家平台 >账号中心>绑定>APPID绑定,点击添加绑定

然后添加绑定关系:

这里的APPID就是开放平台的APPID

4.2 开通产品

这里的我已经开通过了,没有开通话需要开通支付产品。开通过程中,如果网站的主体和商家后台的主体不一致需要授权。授权函如下图:

到这里就完成了支付宝H5支付的所有配置,下来就到了编码环节了。

05 Java代码

Java代码是非常简单的,只需要复制官方文档的代码即可,使用适合自己的参数即可,这里不再赘述。

代码示例地址:https://opendocs.alipay.com/open/29ae8cb6_alipay.trade.wap.pay?scene=21&pathHash=1ef587fd

这里简单的说以配置的代码:

privatestaticAlipayConfiggetAlipayConfig(){StringprivateKey="<-- 请填写您的应用私钥,例如:MIIEvQIBADANB ... ... -->";StringalipayPublicKey="<-- 请填写您的支付宝公钥,例如:MIIBIjANBg... -->";AlipayConfigalipayConfig=newAlipayConfig();alipayConfig.setServerUrl("https://openapi.alipay.com/gateway.do");alipayConfig.setAppId("<-- 请填写您的AppId,例如:2019091767145019 -->");alipayConfig.setPrivateKey(privateKey);alipayConfig.setFormat("json");alipayConfig.setAlipayPublicKey(alipayPublicKey);alipayConfig.setCharset("UTF-8");alipayConfig.setSignType("RSA2");returnalipayConfig;}

这里的配置是初始化支付宝客户端需要的参数,其中privateKeyalipayPublicKey就是开放平台生成的应用私钥和应用公钥。

这里的APPID就是应用的APPID

06 小结

对接下来无论支付宝和微信,都需要一个载体去连接商户号(商家后台),然后通过关联的方式打通支付渠道。

支付宝的产品中有一个指定买家付款的功能,可以杜绝三方付款。而微信只能用到指定的行业如金融、保险等,需要额外申请。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/4 20:09:50

【知识库实战项目】基于大模型+知识图谱的知识库问答

今天给大家介绍一个git开源的宝藏项目 — 基于大模型知识图谱的知识库问答&#xff0c;这里还搭配了一个演示dome给大家&#xff0c;如需要此项目练手的&#xff0c;我已经打包好了放在文末~ 项目整体流程介绍 项目整体包含5个部分&#xff1a;数据重构、图谱构建、图谱补全、…

作者头像 李华
网站建设 2026/6/9 22:52:27

大模型推理加速:如何将响应时间从 5s 优化至 0.1s?

大家好&#xff0c;我是herosunly。985院校硕士毕业&#xff0c;现担任算法工程师一职&#xff0c;获得CSDN博客之星第一名&#xff0c;热衷于大模型算法的研究与应用。曾担任百度千帆大模型比赛、BPAA算法大赛评委&#xff0c;编写微软OpenAI考试认证指导手册。曾获得多项AI顶…

作者头像 李华
网站建设 2026/6/10 13:32:10

JAVA源码赋能:校园外卖同城跑腿新生态

JAVA源码通过高并发架构、智能算法、多端协同与安全机制&#xff0c;构建了校园外卖同城跑腿新生态&#xff0c;实现日均3000订单的高效处理&#xff0c;推动校园生活服务向数字化、标准化、个性化升级。以下从技术架构、核心功能、创新场景、安全保障及生态价值五个维度展开分…

作者头像 李华
网站建设 2026/5/22 14:44:58

养老护理新助力:JAVA陪护系统深度剖析

JAVA陪护系统作为养老护理新助力&#xff0c;通过技术整合与创新&#xff0c;构建了高效、智能、安全的养老服务解决方案&#xff0c;有效破解了传统养老服务中的资源分散、响应滞后、安全保障不足等难题。以下是对JAVA陪护系统的深度剖析&#xff1a;一、技术架构与优势高稳定…

作者头像 李华
网站建设 2026/5/24 2:53:37

【必藏】2025年CTF完全指南:零基础也能掌握的网络安全实战技巧

2025 年的 CTF 赛场早已进入精细化对抗时代 —— 跨模块题型占比超 60%、云环境漏洞成主流考点、多层反调试让工具党频频卡壳。不少选手拿着传统解题思路刷题&#xff0c;却在实战中屡屡碰壁。 其实 CTF 解题有一套标准化的破局逻辑&#xff0c;今天就结合 2025 年最新赛事趋势…

作者头像 李华
网站建设 2026/6/10 13:03:01

git diff查看修改内容:在PyTorch-CUDA-v2.7环境中进行版本控制

在深度学习项目中实现高效版本控制&#xff1a;PyTorch-CUDA环境与 git diff 的协同实践 在现代AI研发流程中&#xff0c;一个常见的痛点是&#xff1a;模型训练结果无法复现。你可能经历过这样的场景——昨天还跑出95%准确率的代码&#xff0c;今天重新运行却只有87%&#xff…

作者头像 李华