# SumUp Terminal 网关

SumUp Terminal 网关支持直接在 WCPOS 中使用 SumUp 读卡器接受银行卡付款。此网关与 SumUp 的付款处理系统无缝集成，适用于现场交易。

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

#### 硬件集成

通过互联网连接将 SumUp 读卡器连接到 POS 系统

#### 实时处理

即时处理付款并完成订单

#### 安全交易

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

#### 轻松配对

使用配对码即可完成简单的设备配对流程

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

1

#### 安装适用于 WooCommerce 的 SumUp Terminal

从 `WP Admin > POS > 设置 > 扩展` 安装，或从 [GitHub releases 页面](https://github.com/wcpos/sumup-terminal-for-woocommerce/releases)下载最新的**插件 zip 资源文件**（不是 GitHub 源代码 zip 或 tarball），然后通过 `插件 > 新增 > 上传插件` 上传。

2

#### 配置 SumUp 设置

1. 导航到 `WP Admin > WooCommerce > 设置 > 支付`
2. 在付款方式列表中找到 **SumUp Terminal**
3. 点击 **SumUp Terminal** 以访问设置
4. 输入你的 **SumUp API 密钥**（可从 SumUp 商户仪表盘获取）
5. 保存设置

注意

无需在 WooCommerce 设置中启用 SumUp Terminal 网关。稍后的步骤会专门为 POS 启用它。

3

#### 配对 SumUp Terminal

1. 在同一设置页面中，找到 **配对读卡器** 部分
2. 在 SumUp 设备上，前往配对屏幕以显示配对码
3. 输入 SumUp 设备上显示的配对码
4. 点击 **"配对读卡器"** 以建立连接
5. 等待确认读卡器已成功配对

重要

读卡器必须成功配对后才能处理付款。请确保完成配对流程后再继续。

4

#### 在 WCPOS 中启用

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

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

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

1. **添加商品**：在 POS 中将产品添加到购物车
2. **选择网关**：选择“SumUp Terminal”作为付款方式
3. **开始付款**：点击以在 SumUp 设备上发起新的付款
4. **顾客付款**：顾客在 SumUp terminal 上完成付款
5. **自动完成**：检测到付款后，订单会自动完成

### 付款控制[​](#payment-controls "直接链接到 付款控制")

使用 SumUp Terminal 网关时，可以使用以下选项：

* **开始新付款**：在已连接的终端上发起付款请求
* **取消付款**：取消当前正在处理的付款
* **付款状态**：监控付款流程的当前状态

### 订单管理[​](#order-management "直接链接到 订单管理")

* **自动更新**：付款成功后，订单会自动标记为已完成
* **付款跟踪**：所有付款详情都会记录在订单备注中
* **收据生成**：付款成功后会生成标准 POS 收据

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

SumUp 账户

<!-- -->

: 有效的 SumUp 商户账户

API 访问权限

<!-- -->

: 商户仪表盘中的 SumUp API 密钥

兼容硬件

<!-- -->

: SumUp 读卡器设备

WCPOS

<!-- -->

: POS 结账需要 Pro 版本

稳定连接

<!-- -->

: 用于 API 通信的可靠互联网连接

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

连接要求

此实现使用 SumUp 的 JavaScript SDK，这意味着它可通过 Web 应用程序工作，但要求**仅使用联网终端**。目前不支持蓝牙终端。

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

* **SumUp Solo** ✅ - 通过 WiFi/以太网连接的终端

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

* **SumUp Air** ❌ - 仅支持蓝牙
* **SumUp 3G** ❌ - 仅支持蓝牙

未来支持

计划在未来的 iOS 和 Android 应用版本中支持蓝牙终端。可用后，将支持所有 SumUp 认证终端，包括 Air 和 3G 型号。

## 故障排除[​](#troubleshooting "直接链接到 故障排除")

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

读卡器无法配对

* 确保使用受支持且已连接互联网的终端（仅 Solo）
* 确认 SumUp Solo 设备已连接 WiFi 并处于在线状态
* 检查设备是否处于配对模式，并确认配对代码输入正确
* 确认您的 SumUp 账户已启用 API 访问权限
* 确保配对期间互联网连接稳定

付款无法处理

* 验证读卡器是否已正确配对
* 检查您的 SumUp 账户是否处于活动状态且状态良好
* 确保设备电量充足且连接正常
* 确认 API 密钥正确且处于活动状态

订单未完成

* 检查互联网连接稳定性
* 验证您的 SumUp 账户中的 webhook 设置
* 确保付款已在 SumUp Terminal 上成功完成
* 检查 WordPress 错误日志，了解 API 通信问题

### API 速率限制[​](#api-rate-limits "直接链接到 API 速率限制")

该网关经过优化，可减少 API 调用并避免触发速率限制：

* 高效检查付款状态
* 尽量减少不必要的 API 请求
* 自动重试逻辑会处理临时故障

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

如需技术支持：

* 访问 [GitHub 仓库](https://github.com/wcpos/sumup-terminal-for-woocommerce)报告问题
* 如有 API 相关问题，请查看 [SumUp 开发者文档](https://developer.sumup.com/)
* 如有账户和硬件问题，请联系 SumUp 支持

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

截图将在后续更新中添加，用于展示：

* SumUp API 密钥配置和设备配对界面
* WCPOS 设置中的网关启用
* POS 结账中的支付处理工作流程