@capgo/capacitor-stripe-terminal

概览

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

从 initialize() 以及下方列出的其他核心方法。

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	否	使用 Capacitor.getPlatform() 做保护

为什么选择 Capgo？

这些插件是以下项目的维护分支： @capacitor-community/stripe. Capgo 将社区项目拆分为聚焦的包，每个 Stripe 功能面都配有文档、示例应用和 CI。

Capgo 跟踪社区仓库中的开放 issue 和 pull request，将相关修复移植到我们的仓库，并在当前 Stripe SDK 上发布。当出现 bug 或平台更新时，我们旨在比社区维护者更快速地响应。

对于使用 Tap to Pay 和物理读卡器进行面对面支付， @capgo/capacitor-stripe-terminal 是从社区包升级的受维护路径。

核心功能

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

公开 API

方法	描述
initialize	使用连接 token 提供方端点初始化 Terminal。
discoverReaders	发现 Tap to Pay、蓝牙或互联网读卡器。
cancelDiscoverReaders	取消进行中的读卡器发现会话。
connectReader	连接到已发现的读卡器。
getPluginVersion	获取原生 Capacitor 插件版本。

参考值

将这些值与 TapToPayUxConfiguration.darkMode 配合使用，以配置 Tap to Pay。

Tap To Pay 深色模式

值	用户会发现
SYSTEM	匹配设备的系统外观。
DARK	强制 Tap to Pay 流程使用深色外观。
LIGHT	强制 Tap to Pay 流程使用浅色外观。

单一事实来源

此参考文档同步自 src/definitions.ts 中的 capacitor-stripe-terminal.

相关插件

• @capgo/native-purchases 适用于 App Store 和 Play Store 订阅
• @capgo/capacitor-pay 适用于不使用 Stripe Payment Sheet 的纯钱包 Apple Pay / Google Pay