要连接 HitPay,请在 EasyBiz Console 中前往 设置 › 集成,点击 HitPay 的 连接,在 HitPay 账户 窗口中打开您所在国家的一行,然后粘贴 HitPay 的 API 密钥和 webhook Salt。之后,为您的柜台和在线商店开启 HitPay 付款方式。
开始前需要准备什么
您销售的每个国家各需一个 HitPay 账户(下文说明如何创建)。例如,在新加坡和马来西亚都有门店的商家,要连接一个新加坡 HitPay 账户和一个马来西亚 HitPay 账户。
可以访问您的 EasyBiz Console
第 1 步:创建 HitPay 账户
如果您已有 HitPay 账户,请跳到第 2 步。
- 前往 HitPay,点击 Sign Up / Get started for free
输入您的电子邮件地址并创建密码
查收电子邮件中的验证码并输入
填写业务资料:选择最符合您业务的类别(例如 Retail、Laundry;如果都不完全符合,请选择 Other)
完成引导步骤,直到进入 HitPay 控制面板
第 2 步:在 EasyBiz 中打开您的 HitPay 账户
先在 EasyBiz 中打开 HitPay 窗口,接下来两步您会从 HitPay 复制内容粘贴到这里。
在 EasyBiz Console 中,点击 设置。在 管理 下,点击 集成
在列表中找到 HitPay,点击 连接
会打开一个标题为 HitPay 账户 的窗口。您销售的每个国家各占一行,例如 新加坡。尚未连接的国家会显示 未连接
如果您在多个国家销售,请点击要连接的国家那一行。如果只在一个国家销售,这一行已经展开
这一行包含 API Key 字段、显示您 webhook 网址的 Webhook Setup 方框,以及 Webhook Salt 字段
在 Webhook Setup 方框中,点击 webhook 网址旁的 Copy,您会在第 4 步把它粘贴到 HitPay
在 HitPay 控制面板中完成第 3 步和第 4 步时,请保持此窗口打开。
第 3 步:获取您的 HitPay API 密钥
API 密钥让 EasyBiz 能够安全地与您的 HitPay 账户通信。
在 HitPay 控制面板的左侧菜单中,点击 Developers
点击 API Keys 选项卡
点击 API 密钥旁的 Copy
回到 EasyBiz 窗口,把它粘贴到 API Key 字段。字段下方会说明这是正式密钥还是沙盒(
test_)密钥。请使用与该密钥同一个 HitPay 环境中的 webhook 和 Salt
第 4 步:在 HitPay 中设置 Webhook
Webhook 是 HitPay 在付款完成或失败时通知 EasyBiz 的方式。您需要设置它,EasyBiz 才会知道客户已经付款。
在 HitPay 控制面板中,点击 Developers → Webhook Endpoints 选项卡
点击 + New Webhook
填写以下内容:
Webhook Name:任意名称,例如 EasyBiz
Webhook URL:粘贴您在第 2 步从 EasyBiz 窗口复制的 webhook 网址
在 Payment Request 下,同时勾选 Completed 和 Failed
点击 Save
新的 webhook 会出现在列表中,旁边有一个 Salt 值。复制这个 Salt
第 5 步:在 EasyBiz 中保存连接
回到您在第 2 步保持打开的 EasyBiz 窗口。如果已经关闭,请重新前往 设置 → 集成,点击 HitPay 的 连接(已有其他国家连接时,按钮显示为 管理),然后点击您所在国家的那一行。
确认 API Key 字段中是您在第 3 步复制的密钥
把您在第 4 步复制的 Salt 粘贴到 Webhook Salt 字段
可选:使用 发送 HitPay 收据邮件给客户 开关,决定 HitPay 是否向客户发送它自己的付款收据邮件
点击 保存
设置完成
点击 保存 后,该国家的 HitPay 账户就已连接。它在 HitPay 账户 窗口中的那一行会显示您保存的是哪种密钥,以及 webhook 的状态,例如 正式密钥 · Webhook 尚未验证,并带有 检查 Webhook 标签。HitPay 第一次向 EasyBiz 发送付款更新后,这一行会显示 Webhook 已验证,标签也会变为 可收款。
集成页面上的 HitPay 卡片会显示同样的状态,例如 正式密钥 · Webhook 已验证。如果您连接了多个国家,卡片会逐一列出,例如 新加坡: 正式密钥 · 马来西亚: 沙盒密钥。卡片上的按钮现在显示为 管理。
以后要连接另一个国家,请点击 HitPay 卡片上的 管理,点击该国家的那一行,再用该国家的 HitPay 账户重复第 3 步到第 5 步。每个 HitPay 账户都有自己的 webhook,所以每个国家都有自己的 Salt。
连接 HitPay 本身不会开启任何付款方式。请选择客户可以在哪里使用它:
在您的柜台: 把 HitPay 的 PayNow 添加到您的 POS,马来西亚店铺则添加 DuitNow QR。请参阅设置 POS 支付方式。
在您的在线商店和移动应用上: 在商店编辑器的 付款 页面开启 HitPay 付款方式。请参阅在您的在线商店收款。
在您的在线商店使用 HitPay
前往 设置 › 销售渠道 › 在线商店与移动应用。
在商店卡片上,点击 编辑在线商店。移动应用开启时,按钮会显示为 编辑移动应用 或 编辑在线商店和移动应用。
在 页面 下,点击 付款。
在 第三方 下,开启您希望客户使用的每种付款方式,例如 PayNow 或 Card,并选择 HitPay 作为提供方。拖动各行,排成客户看到的顺序。
预览您的商店,然后发布。请参阅编辑、预览并发布您的在线商店。

要求保存银行卡
客户可以在预约时通过 HitPay 保存银行卡。订单准备好后,系统会自动从这张银行卡扣款。如果要让某个业务单元在预约时必须保存银行卡,请在商店编辑器的 结账 页面,把该业务单元的付款一行设为 必须绑定银行卡。
这需要一个可以保存银行卡的 HitPay 账户。如果付款一行提示您检查,请点击 检查 HitPay。如果它显示您的账户无法保存银行卡(仅限 GIRO),客户在预约时就无法添加银行卡:请联系 HitPay 为定期扣款开通银行卡功能,然后再检查一次。
如果之后保存了另一个 API 密钥,请在发布前再点击一次 检查 HitPay。
HitPay 会把每张已保存的银行卡记在客户的电子邮箱名下。账户中没有电子邮箱的客户会看到“请先在联系方式中添加邮箱,才能保存银行卡。”
完整的在线商店收款设置,请参阅在您的在线商店收款。
如果没有成功
客户已经付款,但 EasyBiz 中的订单没有显示为已付款。
这几乎总是因为 HitPay 无法通知 EasyBiz。请检查三件事:
Webhook 网址正确。 在 HitPay 控制面板中前往 Developers → Webhook Endpoints,把网址与 EasyBiz Webhook Setup 方框中显示的网址逐字比对。请使用两边的 Copy 按钮,不要手动重新输入。
两个事件都已勾选。 Webhook 必须在 Payment Request 下勾选 Completed 和 Failed。
Salt 一致。 如果您建立了多个 webhook,每个都有自己的 Salt。请从使用 EasyBiz 网址的那个 webhook 复制 Salt,粘贴到 EasyBiz 中对应国家那一行的 Webhook Salt 字段,然后再次点击 保存。
HitPay 卡片或某个国家的那一行显示“Webhook 签名验证失败”。
EasyBiz 中保存的 Salt 与 HitPay 正在调用的 webhook 不一致。请从与 API 密钥相同的 HitPay 环境(正式或沙盒)重新复制 Salt,粘贴到 Webhook Salt,然后点击 保存。在 Salt 一致之前,PayNow 付款仍会完成,但会延迟 15 到 35 分钟。
EasyBiz 在收取 HitPay 付款时显示错误。
打开 设置 → 集成,点击 HitPay 卡片上的 管理,点击您所在国家的那一行,再从 HitPay 的 Developers → API Keys 页面重新粘贴 API 密钥。被截断、或前后多了空格的密钥都会失败。如果您在 HitPay 中重新生成了 API 密钥,EasyBiz 中保存的旧密钥就会失效,请粘贴新密钥并保存。
仍然无法解决?
在 HitPay 控制面板的 Webhook Endpoints 页面查看 webhook 的发送状态。如果 HitPay 显示发送失败,请删除该 webhook,用复制的 EasyBiz 网址重新建立,并在 EasyBiz 中更新新的 Salt。如果付款仍然无法确认,请联系 EasyBiz 支持团队,并提供订单号和大致的付款时间。
下一步
HitPay 连接好后,您就可以在柜台和在线商店上收款了。要在柜台提供 HitPay 付款方式,请参阅设置 POS 支付方式。要了解客户如何通过 HitPay 付款,请参阅HitPay 概览。