Stripe 终端网关
Stripe 终端网关允许您使用 Stripe 终端硬件读取器在 WooCommerce POS 中直接接受线下付款。此网关支持物理卡读取器和模拟模式，以便进行测试。
功能
硬件集成
通过互联网连接连接物理 Stripe 终端读取器
模拟模式
使用 Stripe 的模拟器测试无硬件的付款
实时处理
即时付款处理和确认
安全交易
通过 Stripe 进行符合 PCI 标准的付款处理
安装
1
下载并安装
- 访问 WooCommerce 的 Stripe 终端发布页面
- 下载最新的 stripe-terminal-for-woocommerce.zip 文件
- 在您的 WordPress 管理后台，转到
插件 > 添加新 > 上传插件 - 上传 zip 文件并激活插件
2
配置 Stripe 设置
- 导航到
WP 管理 > WooCommerce > 设置 > 付款 - 在付款方式列表中找到 Stripe 终端
- 点击 Stripe 终端 以访问设置
- 输入您的 Stripe Secret Key（您可以从 Stripe 仪表板获取）
- 保存设置
注意
您不需要在 WooCommerce 设置中启用 Stripe 终端网关。它将在下一步特定于 POS 被启用。
3
在 WooCommerce POS 中启用
- 转到
WP 管理 > WooCommerce POS > 设置 > 结账 - 在列表中找到 Stripe 终端 网关
- 启用此网关以在 POS 中使用
- 保存您的设置
使用方法
连接读取器
当您在 POS 中的结账过程中选择 Stripe 终端网关时：
- 选择连接方式：您可以连接物理读取器或使用模拟器
- 物理读取器：按照屏幕上的说明连接您的 Stripe 终端设备
- 模拟器：选择模拟模式以测试各种付款场景，无需硬件
处理付款
- 添加商品：在 POS 中将产品添加到购物车
- 选择网关：选择“Stripe 终端”作为付款方式
- 连接读取器：连接您的读取器或选择模拟模式
- 处理付款：按照提示完成交易
- 确认：付款成功后订单将自动完成
使用模拟器进行测试
模拟器允许您测试各种付款方式和场景：
- 卡付款：测试不同的卡类型（Visa、Mastercard 等）
- 非接触式付款：模拟轻触付款交易
- 错误场景：测试被拒绝的付款和其他错误条件
- 不同金额：测试不同的交易金额
要求
Stripe 帐户: 已启用终端的活动 Stripe 帐户
API Keys: 您仪表板上的 Stripe Secret Key
WooCommerce POS: 已安装并激活的免费或专业版
HTTPS: 您的网站必须使用 SSL/HTTPS 以确保安全
硬件兼容性
连接要求
此实现使用 Stripe 的 JavaScript SDK，这意味着它通过 Web 应用程序工作，但仅支持 仅互联网连接的终端。当前不支持蓝牙终端。
支持的终端（互联网连接）
- Stripe Reader S700 ✅ - 以太网/WiFi 连接的终端
- WisePOS E ✅ - WiFi 连接的终端
不支持的终端（蓝牙）
- BBPOS Chipper 2X BT ❌ - 仅支持蓝牙
- BBPOS WisePad 3 ❌ - 仅支持蓝牙
- Verifone P400 ❌ - 仅支持蓝牙
未来支持
蓝牙终端支持将在 2026 年第一季度 添加到 iOS 和 Android 应用程序中。这将使所有 Stripe 终端认证读取器包括 M2 和 WisePad 3 获得支持。
常见问题
读取器无法连接
- 确保您使用的是支持的互联网连接终端（S700 或 WisePOS E）
- 验证终端已连接至 WiFi/Ethernet 并在线
- 检查您的 Stripe 帐户是否已启用终端
- 确认终端已在您的 Stripe 仪表板中注册
付款被拒绝
- 检查您的 Stripe 帐户是否活跃且信誉良好
- 验证所使用的卡是否有效
- 确保有足够的资金可用
SSL 证书错误
- Stripe 终端要求 HTTPS - 确保您的网站具有有效的 SSL 证书
- 检查您的 SSL 证书是否配置正确
寻求帮助
如需技术支持：
- 访问 GitHub 代码库 以报告问题
- 查看 Stripe 终端文档 以获取特定硬件的指导
- 联系 Stripe 支持以处理帐户相关问题
截图
截图将在未来的更新中添加，以展示：
- WooCommerce 付款设置中的网关配置
- POS 结账界面中选择 Stripe 终端
- 模拟器测试界面与各种付款方式