讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

uni-app怎么集成Stripe支付

小明君_1517

小明君_1517

发布时间:2026-11-20 05:49:18

|

987人浏览过

|

来源于php中文网

原创

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 错误。

uni-app
uni-app

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

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

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

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

  • 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 的处理差异——这些细节不提前踩一遍,上线当天准出问题。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

3123

2023.08.11

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

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

6843

2023.10.09

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

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

7650

2024.03.19

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

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

7618

2024.03.22

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

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

1083

2024.05.22

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

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

5650

2024.08.16

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

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

20

2026.11.17

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

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

40

2026.11.17

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

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

20

2026.11.17

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn