跳到主内容
版本: 1.x

Stripe Terminal 网关

Stripe Terminal 网关允许您直接在 WooCommerce POS 中使用 Stripe Terminal 硬件读卡器接受面对面支付。该网关支持物理读卡器和用于测试的模拟模式。

功能​

硬件集成

通过互联网连接连接物理的 Stripe Terminal 阅读器

模拟模式

使用 Stripe 的模拟器测试无硬件的支付

实时处理

即时支付处理和确认

安全交易

通过 Stripe 进行 PCI 合规的支付处理

安装​

1

下载并安装

  1. 访问 Stripe Terminal for WooCommerce 发行页面
  2. 下载最新的 stripe-terminal-for-woocommerce.zip 文件
  3. 在您的 WordPress 管理后台，转到 插件 > 添加新插件 > 上传插件
  4. 上传 zip 文件并激活插件
2

配置 Stripe 设置

  1. 导航到 WP 管理 > WooCommerce > 设置 > 支付
  2. 在支付方式列表中找到 Stripe Terminal
  3. 点击 Stripe Terminal 以访问设置
  4. 输入您的 Stripe 秘钥（您可以从您的 Stripe 仪表板获取）
  5. 保存设置
注意

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

3

在 WooCommerce POS 中启用

  1. 转到 WP 管理 > WooCommerce 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等）
  • 非接触式支付：模拟轻触支付交易
  • 错误场景：测试被拒绝的支付和其他错误情况
  • 不同金额：测试各种交易金额

需求​

Stripe 账户: 激活的 Stripe 账户并启用 Terminal
API 密钥: 您仪表板上的 Stripe 秘钥
WooCommerce POS: 结账时需要专业版
HTTPS: 您的网站必须使用 SSL/HTTPS 以确保安全

硬件兼容性​

连接要求

此实现使用 Stripe 的 JavaScript SDK，这意味着它通过 Web 应用程序工作，但仅在互联网连接的终端上有效。目前不支持蓝牙终端。

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

  • Stripe Reader S700 ✅ - Ethernet/WiFi 连接的终端
  • WisePOS E ✅ - WiFi 连接的终端

不支持的终端（蓝牙）​

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

蓝牙终端的支持将在 2026 年 Q1 添加到 iOS 和 Android 应用程序中。这将支持所有经过 Stripe Terminal 认证的读卡器，包括 M2 和 WisePad 3。

常见问题​

读卡器无法连接
  • 确保您使用的是支持的互联网连接终端（S700 或 WisePOS E）
  • 验证终端是否已连接 WiFi/Ethernet 并在线
  • 检查您的 Stripe 账户是否启用了 Terminal
  • 确认证终端在您的 Stripe 仪表板中已注册
支付被拒绝
  • 检查您的 Stripe 账户是否有效且状态良好
  • 验证所用卡是否有效
  • 确保账户中有足够资金
SSL 证书错误
  • Stripe Terminal 需要 HTTPS - 确保您的网站具有有效的 SSL 证书
  • 检查您的 SSL 证书是否配置正确

获取帮助​

对于技术支持：

截图​

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

  • WooCommerce 支付设置中的网关配置
  • 具有 Stripe Terminal 选择的 POS 结账界面
  • 测试各种支付方式的模拟器界面