@capgo/capacitor-stripe-terminal

概览

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

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

平台支持

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

为什么选择 Capgo？

这些插件是以下项目的维护分支： @capacitor-community/stripe. Capgo 将社区项目拆分为针对每个 Stripe 平台的专用包，并为每个包提供了文档、示例应用和 CI。

Capgo 会追踪社区仓库中的 open issues 和 pull requests，将相关的修复移植到我们的仓库中，并随最新的 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 适用于仅使用 Apple Pay / Google Pay（不含 Stripe Payment Sheet）的钱包支付