# WooCommerce 商店的支付网关

Source: https://support.kapsulehost.com/zh-cn/site-payments

支付网关标签页列出了您的WooCommerce商店可用的支付网关，显示哪些已安装、哪些已启用，并提供一键安装和启用功能，让您的商店从无结账功能在几分钟内变为可以接受银行卡支付。

## 支付标签页的位置

打开**网站**，点击该商店，在网站左侧菜单中打开**WordPress**分组，然后选择**支付**。该页面标题为**支付网关**。

该标签页仅出现在创建为WooCommerce网站的站点上。如果该网站是普通的WordPress安装，则不会显示该菜单项，若您仍然进入该页面，您将看到升级提示横幅，而非网关列表。请查看页面顶部网站名称旁边的堆栈标签，以了解该网站的分类。

![KPanel中WooCommerce商店的支付网关页面](https://support.kapsulehost.com/help/screenshots/site-payments.23b0b42c.webp)

## 可选用的网关

| 网关 | 处理内容 |
|---|---|
| Stripe | 银行卡、Apple Pay和Google Pay |
| PayPal | PayPal和银行卡 |
| Afterpay | 先买后付 |
| POLi | 新西兰银行转账 |
| Windcave | 新西兰银行卡处理和EFTPOS |

对新西兰商户尤为重要的网关在列表中带有**NZ**标签。

> **Note:** Apple Pay和Google Pay不需要各自独立的网关。它们随Stripe一同提供，面板也在Stripe所在行中说明了这一点。启用Stripe即可。

## 解读状态标签

每一行显示以下三种状态之一：

- **已连接**，绿色：插件已安装并处于活动状态，正在参与您的结账流程。
- **已安装**，琥珀色：插件已在网站上，但处于关闭状态，客户看不到它。
- **可用**，灰色：插件尚未安装。

在配置WooCommerce商店时，大多数网关会预先安装但处于非活动状态，这是刻意为之的设计。一个没有凭证支撑的活动网关可能会导致结账功能出错，因此在您主动选择启用之前，不会有任何网关被开启。

## 启用网关

1. 在列表中找到该网关。
2. 如果已经安装，点击**启用**；如果尚未安装，点击**安装并启用**。
3. 等待状态标签变为绿色并显示**已连接**。
4. 点击**配置**。

**配置**会在新标签页中打开该网关自身在您商店WordPress后台中的设置页面，并直接定位到正确的界面。您在此处填入您的账户凭证：支付服务商发给您的API密钥、商户ID或账号。

> **Warning:** 状态标签显示已连接，并不代表该网关已经在收款。已连接仅表示插件处于活动状态，不代表它已配置完成。在您于WooCommerce中输入自己的账户凭证并完成一笔真实的测试订单之前，请将结账功能视为尚未完成。

## 需要自行安装的网关

并非所有网关都通过WordPress插件目录分发。Windcave就是这种情况：它所在行显示的是**获取插件**按钮，会带您前往供应商自己的下载页面，而不是安装按钮。

对于这类网关，操作顺序如下：

1. 点击**获取插件**，从供应商处下载该插件。
2. 在您商店的WordPress后台中，进入插件，然后新增，上传该文件。
3. 在该处激活插件。
4. 返回支付标签页，点击**配置**以跳转到其设置页面。

安装完成后，它会和其他网关一样显示正常的状态标签。

## 关闭网关

在**已连接**的行上点击**禁用**。该插件会保持已安装状态，但不再处于活动状态，因此会立即从您的结账页面中消失，状态标签会回落为**已安装**。

当您需要暂停某种支付方式时（例如正在处理与服务商之间的账户问题），应选择禁用而非删除。配置信息会保留，因此日后重新启用时无需重新输入凭证。

## 选择要开启的网关

网关并非越多越好。结账页面上每多一个选项，客户就要多做一次决定，每一个服务商也意味着多一个需要对账的账户。

新西兰常见的配置是一个银行卡处理商加一个备选方式：

- **银行卡**：Stripe或Windcave。如果您希望无需额外设置就支持Apple Pay和Google Pay，Stripe是更快的选择；如果您已经通过Windcave建立了EFTPOS或商户关系，则可以考虑使用它。
- **一个备选方式**：出于熟悉度考虑可选PayPal，如果您的客单价适合分期付款可选Afterpay，若您的客户更喜欢直接从银行账户付款则可选POLi。

在宣布启用之前，先用一笔真实的小额订单对每个开启的网关进行测试。每个服务商都提供测试或沙盒模式，先使用该模式，然后再进行一次真实交易并予以退款。

## 故障排查

**出现警告提示插件状态无法读取。** 面板会直接向WordPress询问哪些插件已安装并处于活动状态。如果WordPress无法作答，例如网站处于维护模式或出现错误，列表会显示并附带提示，说明状态可能不完整。请先修复底层的网站问题，然后刷新页面：[错误日志](https://support.kapsulehost.com/zh-cn/error-logs)和[WordPress白屏问题](https://support.kapsulehost.com/zh-cn/wordpress-white-screen)通常是接下来需要查看的内容。

**列表为空。** 商店没有报告任何可识别的网关插件。请确认WooCommerce本身已在该网站上安装并处于活动状态。

**显示升级横幅，而非网关列表。** 该网站未被注册为WooCommerce网站，这是网站本身的属性，无法在此处切换。

**启用成功，但网关未出现在结账页面。** 几乎总是因为缺少凭证，或者该网关在KPanel中已启用，但在其自身的WooCommerce设置页面中仍处于关闭状态。请打开**配置**并同时检查这两处。

**银行卡支付出现通用错误而失败。** 请先检查该网关自身在WooCommerce中的日志，然后检查网站的错误日志。将正式密钥粘贴到测试模式字段中，或反过来操作，是最常见的原因。

## 接下来可以前往

- [KapsuleHost上的WooCommerce](https://support.kapsulehost.com/zh-cn/wordpress-woocommerce)了解更全面的商店设置。
- [网站活动日志](https://support.kapsulehost.com/zh-cn/site-activity-log)记录了从该页面所做的每一次网关变更。
- 在对正式运营中的商店进行任何改动之前，请先阅读[进行备份](https://support.kapsulehost.com/zh-cn/taking-a-backup)。