# Stripe Terminal 网关

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

## 功能[​](#features "直接链接到 功能")

#### 硬件集成

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

#### 模拟器模式

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

#### 实时处理

即时付款处理和确认

#### 安全交易

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

#### 电话订单 (MOTO)

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

## 安装[​](#installation "直接链接到 安装")

1

#### 安装 Stripe Terminal for WooCommerce

从 `WP Admin > POS > 设置 > 扩展` 安装，或从 [GitHub releases page](https://github.com/wcpos/stripe-terminal-for-woocommerce/releases) 下载最新的**插件 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. 保存设置

## 使用方法[​](#usage "直接链接到 使用方法")

### 连接读卡器[​](#connecting-a-reader "直接链接到 连接读卡器")

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

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

### 处理付款[​](#processing-payments "直接链接到 处理付款")

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

### 使用模拟器测试[​](#testing-with-simulator "直接链接到 使用模拟器测试")

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

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

### 电话订单 (MOTO)[​](#phone-orders-moto "直接链接到 电话订单 (MOTO)")

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

#### 设置[​](#setup "直接链接到 设置")

1

#### 向 Stripe 申请 MOTO 访问权限

MOTO 默认未启用。请联系 [Stripe 支持](https://support.stripe.com/contact)，并请求他们为你的账户启用 MOTO 权限。这个过程很快，但需要 Stripe 手动批准。

2

#### 在插件设置中启用

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

3

#### 连接兼容的读卡器

MOTO 仅适用于 [Supported Terminals](#supported-terminals-internet-connected) 中列出的兼容联网读卡器。其他读卡器类型不会显示此开关。

#### 受理电话订单[​](#taking-a-phone-order "直接链接到 受理电话订单")

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

提示

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

小心

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

## 要求[​](#requirements "直接链接到 要求")

Stripe 账户

<!-- -->

: 已启用 Stripe Terminal 的有效 Stripe 账户

API 密钥

<!-- -->

: 来自控制台的 Stripe 密钥

WCPOS

<!-- -->

: POS 结账需要 Pro 版本

HTTPS

<!-- -->

: 为确保安全，您的站点必须使用 SSL/HTTPS

## 硬件兼容性[​](#hardware-compatibility "直接链接到 硬件兼容性")

连接要求

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

### 支持的终端（已连接互联网）[​](#supported-terminals-internet-connected "直接链接到 支持的终端（已连接互联网）")

* **Stripe Reader S700/S710** ✅ - 通过以太网/WiFi 连接的终端
* **WisePOS E** ✅ - 通过 WiFi 连接的终端

### 不支持的终端（蓝牙）[​](#unsupported-terminals-bluetooth "直接链接到 不支持的终端（蓝牙）")

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

未来支持

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

### 常见问题[​](#common-issues "直接链接到 常见问题")

读卡器无法连接

* 确保使用[受支持的联网终端](#supported-terminals-internet-connected)
* 确认终端已连接到 WiFi/以太网并处于在线状态
* 检查 Stripe 账户是否已启用 Terminal
* 确认终端已在 Stripe Dashboard 中注册

付款被拒绝

* 检查 Stripe 账户是否处于有效状态且信誉良好
* 确认使用的银行卡有效
* 确保可用余额充足

未显示电话订单开关

* 确认已在 `WooCommerce > 设置 > 支付 > Stripe Terminal` 中启用 **电话订单 (MOTO)** 设置
* 确保已连接到兼容的读卡器（请参阅[支持的终端](#supported-terminals-internet-connected)）— 对于其他读卡器类型，该开关会隐藏
* 使用模拟器时不会显示该开关

MOTO 付款失败并显示错误

* 确认 Stripe 已为您的账户启用 MOTO 权限；如果尚未启用，请联系 [Stripe 支持](https://support.stripe.com/contact)
* 再次检查卡片详细信息是否已在读卡器上正确输入
* MOTO 付款可能有更严格的欺诈检查；请确保卡片有效且资金充足

SSL 证书错误

* Stripe Terminal 要求使用 HTTPS，请确保您的站点具有有效的 SSL 证书
* 检查您的 SSL 证书是否已正确配置

### 获取帮助[​](#getting-help "直接链接到 获取帮助")

技术支持：

* 访问 [GitHub 仓库](https://github.com/wcpos/stripe-terminal-for-woocommerce)以报告问题
* 查看 [Stripe Terminal 文档](https://stripe.com/docs/terminal)，了解特定硬件的指导
* 如遇账户相关问题，请联系 Stripe 支持

## 截图[​](#screenshots "直接链接到 截图")

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

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