# PayPal 读卡器 (Zettle) 网关

PayPal 读卡器网关可让您使用 **PayPal 读卡器 (Zettle)** 卡终端直接从 WCPOS 接受当面卡付款。浏览器通过安全连接将实时支付状态从读卡器传输到 Zettle 的 Reader Connect API，以便收银员实时查看支付的每一步。

## 特点[​](#features "直接链接到 特点")

#### 亲自刷卡付款

在 PayPal 读卡器 (Zettle) 终端上进行芯片、非接触式和移动钱包支付

#### 实时付款状态

POS 显示实时进度 - 连接、付款正在进行、已完成或已取消

#### 服务器端验证金额

在下订单之前，始终会根据订单总额检查报告的金额

#### 简单配对

使用设备上显示的配对代码从网关设置链接阅读器

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

WCPOS

<!-- -->

: POS 结账需要专业版

WordPress

<!-- -->

: WordPress 5.2+，WooCommerce 处于活动状态

PHP

<!-- -->

: PHP 7.4 或更高

Zettle 帐户

<!-- -->

: Zettle 开发者商家帐户，以及来自 Zettle 开发者门户的 Zettle 客户端 ID 和断言 (JWT)

兼容硬件

<!-- -->

: PayPal 读卡器（Zettle）卡终端

连接稳定

<!-- -->

: 实时支付状态通过网络传输给读卡器，并且需要互联网连接

支持的硬件和区域

PayPal 读卡器/Zettle 可用性、支持的读卡器型号以及支持的国家/地区由您的**Zettle 商家帐户**决定，而不是由 WCPOS 决定。购买前请确认您的读卡器和区域受 PayPal/Zettle 支持。

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

1

#### 安装 WooCommerce 的 PayPal 阅读器

从 `WP Admin > POS > Settings > Extensions` 安装，或从 [GitHub 发布页面](https://github.com/wcpos/paypal-reader-for-woocommerce/releases) 下载最新的 **插件 zip 资源**（不是 GitHub 源代码 zip 或 tarball）并通过 `Plugins > Add New > Upload Plugin` 上传。 WooCommerce 必须已安装并处于活动状态。

2

#### 配置网关

1. 导航至 `WP Admin > WooCommerce > Settings > Payments`
2. 在付款方式列表中找到**PayPal Reader**并打开其设置
3. 验证设置时，将 **启用测试模式** 保持打开状态。在测试模式下使用 Zettle 开发者商家帐户中的凭据；稍后禁用它以进行实时付款
4. 输入您的 **Zettle 客户端 ID** - 来自 Zettle 开发者门户的 Zettle OAuth 客户端 ID
5. 输入您的 **Zettle 断言** — 您的 Zettle OAuth 断言 (JWT)。这被视为秘密
6. （可选）设置向客户显示的 **标题** 和 **描述**
7. **保存**设置

注意

\*\*“启用 PayPal 阅读器进行网络结帐”\*\*复选框仅适用于您在线商店的结帐 - **POS 不需要**。您将在后续步骤中启用 POS 的网关。

3

#### 配对您的阅读器

1. 保存后，滚动到设置屏幕底部的 **配对阅读器** 部分（保存客户端 ID 和断言后就会出现）
2. 在 PayPal 阅读器设备上，打开 **设置 → 与开发人员链接** 以显示配对代码
3. 在 **配对新读卡器** 下，输入 **配对代码** 和可选的 **读卡器名称**（例如“前台”）
4. 单击**配对阅读器**。读者出现在配对列表中并准备好接受付款

重要

读卡器必须成功配对才能付款。使用配对列表上的 **取消配对** 来删除读取器。

4

#### 在 WCPOS 中启用

1. 转到 `WP Admin > POS > Settings > Checkout`
2. 在列表中找到 **PayPal Reader** 网关
3. 启用它以在 POS 中使用
4. 保存您的设置

## 付款[​](#taking-a-payment "直接链接到 付款")

1. **将商品**添加到 POS 中的购物车并继续结帐
2. **选择PayPal Reader**作为付款方式
3. **选择配对的读卡器**并开始付款。 （如果没有配对，系统会提示您要求商店管理员在 `WooCommerce → Settings → Payments → PayPal Reader` 中配对一个。）
4. POS 在连接时显示实时状态：*“正在连接读卡器...”*，*“读卡器已准备好。请求付款...”*，*“付款正在进行中...”*
5. 顾客将卡轻触或插入读卡器
6. 成功后，将根据订单总额验证金额，记录交易参考，并自动下订单
7. 随时使用**取消付款**来取消对读卡器的请求

## 即将上线[​](#going-live "直接链接到 即将上线")

当您在测试模式下验证完所有内容后：

1. 禁用**启用测试模式**
2. 将您的 Zettle 测试凭据替换为您的 **生产** 客户端 ID 和断言
3. 保存 — 端点和流程相同；仅商家帐户不同

## 要求回顾和限制[​](#limitations "直接链接到 要求回顾和限制")

* **订单仅在确认阅读器结果后完成。** WCPOS 不会下订单，除非付款报告已完成。
* **金额不匹配保护。** 如果读者报告的金额与订单总额不符，付款将被拒绝 - 因此请避免在付款期间编辑购物车总额。
* **连接性。** 实时付款取决于浏览器维护与 Zettle 的 Reader Connect API 的会话；需要稳定的互联网连接。

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

配对读者部分未显示

首先保存您的 **Zettle 客户端 ID** 和 **断言**。仅在保存两个凭据后才会出现配对面板。否则，您会看到\_“在配对阅读器之前保存上面的 Zettle 客户端 ID 和断言。”\_

读者不会配对

* 在读卡器上，确保您打开 **设置 → 与开发人员链接** 以获取新的配对代码
* 在代码过期前准确输入所示代码
* 确认您的 Zettle 客户端 ID 和断言正确并保存
* 确保阅读器和您的网络具有稳定的互联网连接

付款因金额不匹配而被拒绝

该插件会根据订单总额验证读者报告的金额并拒绝任何不匹配的情况。付款正在进行时，请勿更改购物车或订单总额 - 取消付款，调整购物车，然后开始新的付款。

不处理真正的付款/出现有关“模拟阅读器”的管理员警告

开发/CI 常数 (`PRWC_USE_MOCK_READER`) 在 `wp-config.php` 中定义。在进行实时付款之前删除该常量 - 设置后，不会处理任何实际付款。

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

* 报告 [GitHub 存储库](https://github.com/wcpos/paypal-reader-for-woocommerce) 上的网关问题
* 有关帐户、读卡器硬件和区域可用性问题，请联系 PayPal/Zettle 支持人员