uni-app怎么集成Stripe支付

小明君_1517

小明君_1517

2026-11-20

987人浏览

原创

uni-app必须通过后端生成client_secret并由前端调用原生插件或uni.requestPayment唤起支付,H5端只能用Stripe.js或WebView加载Checkout页面。

uni-app怎么集成stripe支付

uni-app 不能直接调用 Stripe SDK,必须走「后端生成支付凭证 + 前端唤起支付组件」的路径。App 端依赖原生插件或 uni.requestPayment,H5 端只能用 Stripe.js 或 WebView 加载 Checkout 页面——这是最常被忽略的前提。

uni-app App 端必须用原生插件或云函数中转

App 打包后运行在原生容器里,stripe.js 无法加载,fetch 也不能直接调用 Stripe API(CORS + 秘钥安全限制)。所以你不能在前端写 stripe.confirmCardPayment 这类调用。

  • 必须由业务服务器(或 uniCloud 云函数)调用 Stripe 后端 SDK 创建 PaymentIntent,返回 client_secret
  • App 前端拿到 client_secret 后,通过原生插件(如 Stripe-Plugin)或 uni.requestPayment({ provider: 'stripe', orderInfo: {...} }) 唤起支付界面
  • orderInfo 中的 publishKey 必须是测试公钥(pk_test_...),不能是私钥;paymentIntent 字段实际应填 client_secret(不是 ID)
  • 若使用 uni.requestPayment,需在 manifest.json → App模块配置 → Payment(支付) 中勾选并配置 Stripe,否则调用直接失败

H5 端只能用 Stripe.js 或 WebView,别硬套 App 方式

H5 没有原生能力,uni.requestPayment 在 H5 下不生效。强行在 H5 调用会静默失败或报 provider not found 错误。

  • 推荐方案:用 stripe-js + Elements 自定义卡输入框,配合后端返回的 client_secret 调用 stripe.confirmCardPayment
  • 快速方案:后端创建 Stripe Checkout Session,返回 session_id,前端用 加载托管页面
  • 注意 WebView 在某些 Android App 内核中可能拦截跳转,需确保 web-view 组件启用 allowsInlineMediaPlayback 和 scrollable 等兼容属性

orderInfo 结构容易填错的几个字段

很多人卡在 uni.requestPayment 报错 invalid orderInfo 或支付页空白,基本都是这几个字段没对齐 Stripe 要求:

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • customer 和 ephemeralKey 不是必填,但如果你用了 Customer 对象做复购,就必须同时传两者,且 ephemeralKey 必须由后端用 stripe.ephemeralKeys.create({customer: 'cus_xxx'}) 动态生成
  • paymentIntent 字段名有误导性——它实际要填的是 client_secret(形如 pi_xxx_secret_yyy),不是 pi_xxx
  • billingDetails 中的 country 必须是 ISO 3166-1 alpha-2 格式(如 'US'、'HK'),填 'China' 或 'Hong Kong' 会导致支付页崩溃
  • isAllowDelay 是布尔值,但文档里写成 String 类型——实际传 true 或 false 即可,字符串会解析失败

Webhook 和退款逻辑必须在服务端实现

前端永远不要尝试自己验证支付结果或发起退款。PaymentIntent.succeeded 状态只能由 Stripe 通过 Webhook 推送,或你主动调用 retrieve 查询。

  • 你的服务器必须暴露一个 HTTPS 接口接收 Stripe Webhook(如 /stripe/webhook),并用 stripe.webhooks.constructEvent 验证签名
  • 退款不能靠前端发请求,必须由服务端调用 stripe.refunds.create({ payment_intent: 'pi_xxx', amount: 1000 })
  • 测试时用 4242 4242 4242 4242 卡号 + 任意未来日期 + 任意三位 CVC,但注意:延迟支付方式(如 SEPA)在测试模式下不会立即成功,得等 Webhook 回调

真正麻烦的从来不是“怎么调通”,而是服务端密钥管理、Webhook 签名验证、client_secret 一次性使用限制、以及不同平台对 URL Scheme 的处理差异——这些细节不提前踩一遍,上线当天准出问题。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3123

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6843

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7650

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7618

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.16

5650

6

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习