跳到主内容
版本: 1.x

Stripe Terminal 网关

Stripe Terminal 网关允许您直接在 WCPOS 中使用 Stripe Terminal 硬件读卡器接受现场付款。此网关同时支持实体读卡器和用于测试的模拟器模式。

功能​

硬件集成

通过互联网连接实体 Stripe Terminal 读卡器

模拟器模式

使用 Stripe 的模拟器在没有硬件的情况下测试付款

实时处理

即时付款处理和确认

安全交易

通过 Stripe 进行符合 PCI 标准的付款处理

电话订单 (MOTO)

通过在读卡器中输入详细信息来接受电话中的银行卡付款

安装​

1

安装 Stripe Terminal for WooCommerce

从 WP Admin > POS > 设置 > 扩展 安装，或从 GitHub releases page 下载最新的插件 zip 资源（不是 GitHub 源代码 zip 或 tarball），然后通过 插件 > 新增 > 上传插件 上传。

2

配置 Stripe 设置

  1. 导航到 WP Admin > WooCommerce > 设置 > 支付
  2. 在付款方式列表中找到 Stripe Terminal
  3. 点击 Stripe Terminal 以访问设置
  4. 输入 Stripe 密钥（可从 Stripe Dashboard 获取）
  5. 保存设置
注意

无需在 WooCommerce 设置中启用 Stripe Terminal 网关。它将在下一步中专门为 POS 启用。

3

在 WCPOS 中启用

  1. 前往 WP Admin > POS > 设置 > 结账
  2. 在列表中找到 Stripe Terminal 网关
  3. 启用该网关，以便在 POS 中使用
  4. 保存设置

使用方法​

连接读卡器​

在 POS 结账过程中选择 Stripe Terminal 网关时：

  1. 选择连接方式：可以连接实体读卡器，也可以使用模拟器
  2. 实体读卡器：按照屏幕上的说明连接你的 Stripe Terminal 设备
  3. 模拟器：选择模拟器模式，无需硬件即可测试各种付款场景

处理付款​

  1. 添加商品：在 POS 中将产品添加到购物车
  2. 选择网关：选择“Stripe Terminal”作为付款方式
  3. 连接读卡器：连接读卡器或选择模拟器模式
  4. 处理付款：按照提示完成交易
  5. 确认：付款成功后，订单将自动完成

使用模拟器测试​

模拟器可用于测试各种付款方式和场景：

  • 银行卡付款：测试不同的银行卡类型（Visa、Mastercard 等）
  • 非接触式付款：模拟轻触付款交易
  • 错误场景：测试被拒绝的付款和其他错误情况
  • 不同金额：测试各种交易金额

电话订单 (MOTO)​

MOTO（邮购/电话订购）允许为未到现场的客户处理卡付款，例如通过电话接单时。商家无需轻触或插入银行卡，而是直接在终端读卡器屏幕上输入卡详细信息。

设置​

1

向 Stripe 申请 MOTO 访问权限

MOTO 默认未启用。请联系 Stripe 支持，并请求他们为你的账户启用 MOTO 权限。这个过程很快，但需要 Stripe 手动批准。

2

在插件设置中启用

  1. 导航到 WP Admin > WooCommerce > 设置 > 支付 > Stripe Terminal
  2. 选中 电话订单 (MOTO) 复选框
  3. 保存设置
3

连接兼容的读卡器

MOTO 仅适用于 Supported Terminals 中列出的兼容联网读卡器。其他读卡器类型不会显示此开关。

受理电话订单​

  1. 连接兼容的读卡器（请参阅 Supported Terminals）
  2. 在付款屏幕上，开启 电话订单
  3. 点击 收取银行卡付款 — 读卡器将显示银行卡号输入屏幕，而不是提示轻触/插入银行卡
  4. 在读卡器上输入客户的银行卡号、有效期和 CVV
  5. 之后付款将按正常流程处理
提示

MOTO 付款使用 card 作为付款方式类型，而不是 card_present。这意味着从 Stripe 的角度来看，它们更接近在线交易，因此适用标准的在线银行卡处理费用，而不是现场付款费率。

小心

仅当同时满足三个条件时，才会显示“电话订单”开关：插件设置中已启用 MOTO 设置、已连接兼容的读卡器，并且该读卡器不是模拟器。如果没有看到此开关，请检查这些条件。

要求​

Stripe 账户: 已启用 Stripe Terminal 的有效 Stripe 账户
API 密钥: 来自控制台的 Stripe 密钥
WCPOS: POS 结账需要 Pro 版本
HTTPS: 为确保安全，您的站点必须使用 SSL/HTTPS

硬件兼容性​

连接要求

此实现使用 Stripe 的 JavaScript SDK，这意味着它可通过 Web 应用运行，但仅支持已连接互联网的终端。目前不支持蓝牙终端。

支持的终端（已连接互联网）​

  • Stripe Reader S700/S710 ✅ - 通过以太网/WiFi 连接的终端
  • WisePOS E ✅ - 通过 WiFi 连接的终端
国家/地区可用性

WCPOS 可与上文列出的联网读卡器配合使用：Stripe Reader S700/S710 和 BBPOS WisePOS E。Stripe Terminal 和各读卡器在哪些国家/地区提供，由 Stripe 决定，而非 WCPOS。购买读卡器前，请查看 Stripe 的 Terminal 全球可用性页面和各国读卡器可用性表格。

截至 2026 年 11 月 3 日，Stripe 列出的 Terminal 可用国家/地区包括：澳大利亚、奥地利、比利时、加拿大、捷克、丹麦、芬兰、法国、德国、爱尔兰、意大利、日本、卢森堡、马来西亚、荷兰、新西兰、挪威、葡萄牙、新加坡、西班牙、瑞典、瑞士、英国和美国。列为预览版的国家/地区包括：保加利亚、克罗地亚、塞浦路斯、爱沙尼亚、中国香港、匈牙利、拉脱维亚、列支敦士登、立陶宛、马耳他、波兰、罗马尼亚、斯洛伐克和斯洛文尼亚。直布罗陀和墨西哥仅列为支持 Tap to Pay。各国/地区提供的读卡器型号不同，请在 Stripe 的表格中查询您所在地区。

意大利： Stripe Terminal 在意大利可用，Stripe 列出的意大利适用设备包括 Stripe Reader S700、S710 和 BBPOS WisePOS E。

Stripe 会根据读卡器注册到的 Terminal Location 应用国家/地区设置，而 Location 创建后便无法更改国家/地区。请将读卡器注册到您使用它所在国家/地区的 Location。

不支持的终端（蓝牙）​

  • BBPOS Chipper 2X BT ❌ - 仅支持蓝牙
  • BBPOS WisePad 3 ❌ - 仅支持蓝牙
  • Verifone P400 ❌ - 仅支持蓝牙
未来支持

计划在未来的 iOS 和 Android 应用版本中支持蓝牙终端。可用后，将支持所有通过 Stripe Terminal 认证的读卡器，包括 M2 和 WisePad 3。

常见问题​

读卡器无法连接
  • 确保使用受支持的联网终端
  • 确认终端已连接到 WiFi/以太网并处于在线状态
  • 检查 Stripe 账户是否已启用 Terminal
  • 确认终端已在 Stripe Dashboard 中注册
付款被拒绝
  • 检查 Stripe 账户是否处于有效状态且信誉良好
  • 确认使用的银行卡有效
  • 确保可用余额充足
未显示电话订单开关
  • 确认已在 WooCommerce > 设置 > 支付 > Stripe Terminal 中启用 电话订单 (MOTO) 设置
  • 确保已连接到兼容的读卡器（请参阅支持的终端）— 对于其他读卡器类型，该开关会隐藏
  • 使用模拟器时不会显示该开关
MOTO 付款失败并显示错误
  • 确认 Stripe 已为您的账户启用 MOTO 权限；如果尚未启用，请联系 Stripe 支持
  • 再次检查卡片详细信息是否已在读卡器上正确输入
  • MOTO 付款可能有更严格的欺诈检查；请确保卡片有效且资金充足
SSL 证书错误
  • Stripe Terminal 要求使用 HTTPS，请确保您的站点具有有效的 SSL 证书
  • 检查您的 SSL 证书是否已正确配置

获取帮助​

技术支持：

截图​

截图将在未来更新中添加，用于展示：

  • WooCommerce 付款设置中的网关配置
  • 选择 Stripe Terminal 的 POS 结账界面
  • 包含多种付款方式的模拟器测试界面