跳转至正文

Stripe Terminal Capacitor 插件

用于 Stripe Terminal 线下支付的 Capacitor 插件。

安装

bun add @capgo/capacitor-stripe-terminal bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-stripe-terminal
  • pnpm add @capgo/capacitor-stripe-terminal
  • yarn add @capgo/capacitor-stripe-terminal

指南

如何在 Capacitor 中使用 Stripe Terminal

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Stripe Terminal 插件预览二维码 code

使用 @capgo/capacitor-stripe-terminal

用于 Stripe Terminal 线下支付的 Capacitor 插件。

为什么选择 Capgo?

Capgo 维护以下项目的官方 fork @capacitor-community/stripe。我们会跟进上游的 issue 和 pull request,合并相关修复,并基于最新的 Stripe SDK 发布更新,同时提供示例 App 和文档。

如果你现在用的是社区包,Capgo 的 Stripe 插件是持续维护的方案,对 bug 和平台变更的响应也更快。

安装

bun add @capgo/capacitor-stripe-terminal
bunx cap sync

插件暴露的内容

  • initialize - 使用连接 token 提供方端点初始化 Terminal。
  • discoverReaders - 发现 Tap to Pay、蓝牙或网络读卡器。
  • cancelDiscoverReaders - 取消正在进行的读卡器发现会话。
  • connectReader - 连接已发现的读卡器。

完整参考

常见问题

Stripe Terminal 插件常见问题

如何在 Capacitor 应用中安装 Stripe Terminal 插件?

运行 "bun add @capgo/capacitor-stripe-terminal"(或 "npm install @capgo/capacitor-stripe-terminal"),然后运行 "bunx cap sync",让 iOS 和 Android 项目识别到原生 code。再在应用的 code 中从 "@capgo/capacitor-stripe-terminal" 导入。

@capgo/capacitor-stripe-terminal 支持 React、Vue 和 Angular 吗?

支持。Stripe Terminal 是一个 Capacitor 包,因此任何运行在 Capacitor 里的 Web 框架都能用,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-stripe-terminal 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-stripe-terminal 是免费开源的吗?

是的。code 的源码已在 GitHub 上公开,地址为 https://github.com/Cap-go/capacitor-stripe-terminal/,也可以从 npm 免费安装该包。欢迎提交 Bug 报告和 Pull Request。

使用 Stripe Terminal 的 code 能否无需 App Store 审核直接更新?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核,即可发布 Stripe Terminal 变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo