摘要:QashierHQ 中的 在线支付 页面用于申请在线收款、开启顾客在线付款的方式,以及连接你的网站或应用,包括通过开发者 API 接入你自己的结账页面。
适用范围:新加坡和马来西亚 · QashierHQ · QashierPay 在线收款 · 账户所有者或拥有完整权限的登录账号。访问权限受限的登录账号看不到此页面。
开始之前
登录 QashierHQ,在侧边栏的 销售渠道 下点击 在线支付。页面标题为 在线收款。
你的在线收款账户必须先通过审核,顾客才能向你付款。如果页面显示 开始在线收款,点击 立即申请(如果你保存过草稿,则点击 继续申请)并完成申请。审核期间,页面显示 您的账户正在审核中 以及 审核中 标记。审核通过后,页面顶部显示 账户已验证。
如果你有多家门店,请用 店铺 选择器选择门店。收款渠道和收款方式按门店分别设置。
第 1 步:启用收款方式
收款方式 表格列出顾客可以在线付款的方式,并显示所选门店的 状态:已启用、审核中 或 未启用。
新加坡:借记卡 / 信用卡(Visa、Mastercard)、PayNow、GrabPay 和 WeChat Pay。
马来西亚:借记卡 / 信用卡(Visa、Mastercard)和 DuitNow。
在状态为 未启用 的收款方式旁,点击 启用。系统会打开 支付方式管理 中的收款方式选择页面。
为每家门店勾选你需要的收款方式,然后点击 保存。
已申请的收款方式会显示 待激活("已请求激活。一旦该付款方式已为商店激活,我们将通过电子邮件通知您。"),并在在线支付页面上显示 审核中。
需要的收款方式不在列表中?点击表格下方的 申请新的收款方式。如需关闭某个收款方式,请联系客服。关于结算和打款时间,请参阅 [SG] 我什么时候会收到打款?结算与打款时间表 或 [MY] QashierPay 打款时间表、费用和最低打款金额。
第 2 步:选择收款渠道
收款渠道 是顾客在线向你付款的地方。每张卡片上都有一个按钮:
渠道 | 说明 | 按钮 |
在线 / 二维码点单 | 带有你品牌的网店或餐桌二维码 | 已开启时显示 管理,未开启时显示 启用。两者都会打开在线点单页面。 |
链接收款 | 通过 WhatsApp、短信或电子邮件发送的付款链接 | 管理 或 启用 会打开 Pay by Link。 |
电子发票 | 带有付款按钮的发票 | 管理 或 启用 会打开发票管理。 |
WooCommerce | 在你的 WordPress / WooCommerce 网店上使用 Qashier 收款 | 连接 会打开 连接 WooCommerce 窗口。请参阅 [SG/MY] 如何安装和设置 QashierPay WooCommerce 插件。 |
开发者 API | 你基于 REST API 和 webhook 自建的结账页面 | 管理 会打开 开发者 API 窗口(第 3 步)。 |
Shopify 和 Wix | 标记为 即将推出 | 点击 我有兴趣。按钮会变为 已登记意向,并显示确认信息:"感谢——我们会就此项集成与您联系。" |
第 3 步:通过开发者 API 连接你自己的结账页面
此步骤由你的网站开发人员完成。开发者 API 窗口针对顶部所选的门店显示三个步骤。
在 生成您的 API 密钥 下,填写 您的网站 URL。你也可以填写 Webhook URL(可选),这样付款完成时 Qashier 可以通知你的网站。
点击 生成 API 密钥。窗口会显示你的 API 密钥 和 Webhook 密钥。分别点击 复制,并将它们保存在你的服务器上,切勿放在网站的公开代码中。它们只显示一次:"请立即保存——它们将不会再次显示。"
开发人员使用 API 密钥创建结账会话,并将顾客引导至 Qashier 托管的付款页面。窗口在 创建结账会话 下提供了示例请求。
在 监听 webhook 下,开发人员为 checkout.session.completed 事件注册 webhook URL,并在将订单标记为已付款之前校验 Qashier-Signature 请求头。
点击 查看 API 文档 查看完整参考,然后点击 完成。
更换密钥:点击 重新生成。窗口会提示"生成新密钥将使旧密钥失效。请输入 REGENERATE 以确认。"输入 REGENERATE,然后点击 确认重新生成。请立即在网站上更新新密钥,因为旧密钥会停止生效。API 密钥历史记录 按日期、密钥后四位和状态列出以前的密钥。
你应该看到的结果
你启用的收款方式在 收款方式 表格中显示 已启用。
在线 / 二维码点单、链接收款 和 电子发票 开启后显示 已启用 和 管理 按钮。
生成密钥后,API 密钥历史记录 显示新密钥为有效状态。
如果出现问题
现象 | 原因 | 解决方法 |
侧边栏中没有 在线支付 | 你的门店不在新加坡或马来西亚,或你的登录账号访问权限受限 | 使用账户所有者身份登录,或请所有者操作。 |
生成 API 密钥 按钮呈灰色 | 您的网站 URL 为空或不是有效的网址,或你填写的 Webhook URL(可选) 不是有效的网址 | 填写完整网址,例如 https://www.example.com,并检查 webhook 地址或将其留空。 |
"安全词不正确——请输入 REGENERATE 以确认。" | 确认词输入有误 | 准确输入 REGENERATE。 |
"生成 API 密钥失败" | 请求未成功 | 请重试。如果一直失败,请联系客服。 |
重新生成后网站无法收款 | 旧密钥已失效 | 将新的 API 密钥和 Webhook 密钥填入你的网站或插件设置。 |
某个收款方式一直显示 审核中 | 启用申请仍在处理中 | 请等待电子邮件通知。如果时间超出预期,请联系客服。 |
相关文章
最后核实:2026年9月25日 · 适用市场:SG、MY
