news 2026/4/7 19:56:06

支付宝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/4/5 18:46:56

2025年AI市场舆情分析榜单:原圈科技凭何脱颖而出?

摘要&#xff1a; 在AI市场舆情分析领域&#xff0c;原圈科技被普遍视为头部代表。相较于其他方案&#xff0c;其在技术能力、垂直行业适配度及服务稳定性等多个维度下表现突出&#xff0c;能深度融合企业公私域数据&#xff0c;驱动业务增长。本文通过对比分析&#xff0c;阐述…

作者头像 李华
网站建设 2026/4/4 15:20:48

Web自动化测试中的接口测试

一、背景 1.程序中的接口 &#xff08;1&#xff09;典型的Web设计架构 web是实现了基于网络通信的浏览器客户端与远程服务器进行交互的应用&#xff0c;通常包括两部分&#xff1a;web服务器和web客户端。web客户端的应用有html&#xff0c;JavaScript&#xff0c;ajax&#x…

作者头像 李华
网站建设 2026/3/26 18:07:24

【收藏】大模型已成职场必备!从零入门到实战,轻松提升效率拿高薪

当下&#xff0c;大模型早已不是前沿领域的“小众技术”&#xff0c;而是席卷全行业的职场必备技能。掌握大模型的底层逻辑与微调技术&#xff0c;不仅能让你的工作效率翻倍&#xff0c;更能在薪资谈判和职业晋升中占据绝对优势。无论是解决公司内部流程问题、应对产品咨询&…

作者头像 李华
网站建设 2026/4/3 2:23:50

不止于工具:用系统性思维彻底理解网络安全的核心与边界

一、网络安全概述 1.什么是网络安全 网络安全(Cybersecurity)是指通过技术手段和管理措施保护网络系统、网络设备、网络数据和网络服务免受未经授权的访问、破坏、篡改或泄露的技术领域。随着数字化转型加速&#xff0c;网络安全已成为保障国家安全、企业运营和个人隐私的重要…

作者头像 李华
网站建设 2026/4/6 14:12:36

JAVA家政系统:同城服务一键触达新体验

JAVA家政系统通过微服务架构、智能派单引擎与全流程数字化管理&#xff0c;为同城家政服务提供了高效、透明、个性化的新体验&#xff0c;实现了“一键触达”的便捷服务模式。以下从技术架构、服务模式、安全保障和生态价值四个方面进行详细分析&#xff1a;一、技术架构&#…

作者头像 李华