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

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











