本文介绍如何从 QashierHQ 获取 QashierPay WooCommerce 插件和你的 API 凭据，在你的 WordPress 网站上安装插件，并完成设置，让顾客可以在你的 WooCommerce 结账页面使用 QashierPay 付款。本文适用于已获批准 QashierPay 线上收款账户的新加坡和马来西亚商家。
适用范围：新加坡和马来西亚 · QashierPay 线上收款 · QashierHQ 在线收款 · 安装了 WooCommerce 的 WordPress。你需要 QashierHQ 登录账号和 WordPress 管理员权限。
开始之前
你的 QashierPay 线上收款账户必须已获批准。在 QashierHQ 中，打开左侧菜单中的在线支付。如果你看到开始在线收款，请点击立即申请并先完成申请。QashierHQ 显示审核通常需要 1–2 个工作日。
准备好你的 WordPress 管理员登录信息。
在启用支付网关之前，将你的 WooCommerce 商店货币设置为 SGD（新加坡）或 MYR（马来西亚）。
此插件用于收款。它不是 QashierHQ 中用于同步库存的设置 > WooCommerce API 设置。关于库存，请参阅如何将 WooCommerce 库存与 Qashier 同步。
第 1 步：在 QashierHQ 中获取插件和 API 凭据
在 QashierHQ 中有两个地方可以完成此操作。方式 A 位于在线设置页面，适用于在线注册的商家；如果 QashierHQ 无法为你打开该页面，请使用方式 B。两种方式生成的是同一套密钥：每个店铺一个 API 密钥和 webhook 密钥，也可用于开发者 API（Developer API）。
方式 A：在线收款设置页面
选择 WooCommerce 标签页，点击 Configure API keys（配置 API 密钥）。Configure for WooCommerce（为 WooCommerce 配置）窗口随即打开。
如果你有多个店铺，请在商店下选择。输入 Your website URL（你的网站 URL），然后点击 Generate API keys（生成 API 密钥）。
复制 API key（API 密钥）、Store ID（店铺 ID）和 Webhook secret（Webhook 密钥），并保存在安全的地方。它们只会显示一次。
方式 B：在线支付页面
在 QashierHQ 左侧菜单中，点击在线支付。密钥将为 QashierHQ 中当前选择的店铺创建。
在 WooCommerce 卡片上，点击连接。连接 WooCommerce 窗口随即打开。
在第 1 步下，点击下载插件（.zip）并保存文件。
在第 2 步下，输入您的店铺 URL，然后点击生成密钥。
复制 Consumer key（API 密钥）和 Consumer secret（webhook 密钥），并保存在安全的地方。它们只会显示一次。此窗口不会显示插件同样需要的店铺 ID（Store ID）。请向你的 Qashier 开通对接人或 Qashier 客服索取。如果你可以改用方式 A，该方式会同时显示店铺 ID 以及新的 API 密钥和 webhook 密钥；在那里生成密钥会替换此窗口中的密钥，因此请将这三个新值全部粘贴到插件中。
使用下表将 QashierHQ 中的值与插件字段对应起来：
在 QashierHQ 中 | 在插件设置中 |
API key / Consumer key（API 密钥） | API Key |
Webhook secret / Consumer secret（webhook 密钥） | Webhook Secret Key |
Store ID | Store Id |
如果你的账户是由 Qashier 为你设置的，你的开通对接人可能已经将插件文件和这些值发送给你。
第 2 步：安装并启用插件
单站点 WordPress
在你的 WordPress 控制面板中，前往 Plugins（插件）> Add New（安装插件）。
点击页面顶部的 Upload Plugin（上传插件）。
选择你从 QashierHQ 下载的插件 .zip 文件，然后点击 Install Now（立即安装）。
安装完成后，点击 Activate Plugin（启用插件）。
多站点 WordPress
在你的 WordPress 网络控制面板中，前往 Plugins > Add New。
点击 Upload Plugin，然后选择插件 .zip 文件。
点击 Install Now。
点击 Network Activate（在全网络启用），在所有站点上启用该插件。如果你只想在部分站点上使用 QashierPay，请改为前往各站点的 Plugins 页面，并在那里点击 Activate（启用）。
第 3 步：在 WooCommerce 中设置插件
如果你使用多站点，请打开你要设置的站点的控制面板。
前往 WooCommerce > Settings（设置）> Payments（付款）。
在列表中找到 Qashier – Qashier Pay，点击 Finish Setup（完成设置）。
按字段显示的顺序填写：
Enable Qashier Pay（启用 Qashier Pay）：勾选以开启支付网关。
Qashier Gateway In Use（使用中的 Qashier 网关）：选择你的市场，Singapore（新加坡）或 Malaysia（马来西亚）。
Mode（模式）：设置期间选择 Test（测试），接收真实付款时选择 Live（正式）。
Description（描述）：顾客在结账时看到的付款选项旁的文字，例如 "Pay via QPay"。
Store Id（店铺 ID）：粘贴你从 QashierHQ 获取的店铺 ID。
API Key（API 密钥）：粘贴你从 QashierHQ 获取的 API 密钥。
Webhook Secret Key（Webhook 密钥）：粘贴你从 QashierHQ 获取的 webhook 密钥。
Debug Log（调试日志）：仅在测试期间勾选。
点击 Save changes（保存更改）。
第 4 步：测试并正式上线
在 Mode 设置为 Test 的情况下，在你的商店下一笔测试订单，并在结账时选择 Qashier Pay。检查你是否会被带到 QashierPay 付款页面，然后返回你的商店。
在插件设置中，将 Mode 改为 Live，取消勾选 Debug Log，然后点击 Save changes。
下一笔小额真实订单，确认它出现在 QashierHQ 中。
你应该看到的结果
顾客在结账时会看到 Qashier Pay 付款方式。关于顾客看到的内容以及每笔付款的记录位置，请参阅[SG/MY] 顾客如何在你的 WooCommerce 商店使用 QashierPay 付款。
已付款的订单在 WooCommerce 中标记为已付款，付款会显示在 QashierHQ 中。全额和部分退款会同步回你的 WooCommerce 订单。
打款显示在 QashierHQ 的金融财务 > 收款报告下（打开后页面标题显示为"付款报告"）。
常见问题及处理方法
问题 | 可能原因 | 处理方法 |
结账时没有显示 Qashier Pay | 插件未启用、未勾选 Enable Qashier Pay，或商店货币不是 SGD 或 MYR | 在 Plugins 页面启用插件，在 WooCommerce > Settings > Payments > Qashier Pay 下勾选 Enable Qashier Pay，并将货币设置为 SGD（新加坡）或 MYR（马来西亚） |
付款页面出错或订单一直未付款 | API 密钥、Store Id 或 webhook 密钥错误或已过时，或 Qashier Gateway In Use 选择的市场不正确 | 在 QashierHQ 中重新生成密钥（见下文），并重新粘贴全部三个值；检查所选市场是否与你的 Qashier 账户一致 |
你遗失了 API 密钥或 webhook 密钥 | 密钥只会显示一次 | 在 QashierHQ 中重新生成（见下文） |
点击 Configure API keys 时要求你先验证商家 | 你尚未提交 QashierPay 申请 | 完成申请（在线支付 > 立即申请）。提交后即可生成密钥；但只有在申请获批后才能接收真实付款。 |
重新生成密钥的方法：在 QashierHQ 中，打开 Configure for WooCommerce（方式 A）或连接 WooCommerce（方式 B），输入你的店铺 URL，然后点击 Generate API keys 或重新生成密钥。出现提示时输入 REGENERATE，然后点击 Regenerate（重新生成）或确认重新生成。你旧的 API 密钥和 webhook 密钥会立即失效，因此请马上将新值粘贴到插件中。
如果仍有问题，请联系你当地的客服团队：通过电话、WhatsApp、LINE 或 Viber 联系 Qashier 客服（SG、MY、TH、PH）。
相关文章
最后核实：2026年9月25日 · 适用市场：SG, MY