要连接 HitPay,请在 EasyBiz Console 中前往 设置 › 集成,点击 HitPay 的 连接,在 HitPay 账户 窗口中打开您所在国家的一行,然后粘贴 HitPay 的 API 密钥和 webhook Salt。之后,为您的柜台和在线商店开启 HitPay 付款方式。

开始前需要准备什么

  • 您销售的每个国家各需一个 HitPay 账户(下文说明如何创建)。例如,在新加坡和马来西亚都有门店的商家,要连接一个新加坡 HitPay 账户和一个马来西亚 HitPay 账户。

  • 可以访问您的 EasyBiz Console


第 1 步:创建 HitPay 账户

如果您已有 HitPay 账户,请跳到第 2 步。

  1. 前往 HitPay,点击 Sign Up / Get started for free
  1. 输入您的电子邮件地址并创建密码

  2. 查收电子邮件中的验证码并输入

  3. 填写业务资料:选择最符合您业务的类别(例如 Retail、Laundry;如果都不完全符合,请选择 Other)

  4. 完成引导步骤,直到进入 HitPay 控制面板


第 2 步:在 EasyBiz 中打开您的 HitPay 账户

先在 EasyBiz 中打开 HitPay 窗口,接下来两步您会从 HitPay 复制内容粘贴到这里。

  1. 在 EasyBiz Console 中,点击 设置。在 管理 下,点击 集成

  2. 在列表中找到 HitPay,点击 连接

  3. 会打开一个标题为 HitPay 账户 的窗口。您销售的每个国家各占一行,例如 新加坡。尚未连接的国家会显示 未连接

  4. 如果您在多个国家销售,请点击要连接的国家那一行。如果只在一个国家销售,这一行已经展开

  5. 这一行包含 API Key 字段、显示您 webhook 网址的 Webhook Setup 方框,以及 Webhook Salt 字段

  6. 在 Webhook Setup 方框中,点击 webhook 网址旁的 Copy,您会在第 4 步把它粘贴到 HitPay

在 HitPay 控制面板中完成第 3 步和第 4 步时,请保持此窗口打开。


第 3 步:获取您的 HitPay API 密钥

API 密钥让 EasyBiz 能够安全地与您的 HitPay 账户通信。

  1. 在 HitPay 控制面板的左侧菜单中,点击 Developers

  2. 点击 API Keys 选项卡

  3. 点击 API 密钥旁的 Copy

  4. 回到 EasyBiz 窗口,把它粘贴到 API Key 字段。字段下方会说明这是正式密钥还是沙盒(test_)密钥。请使用与该密钥同一个 HitPay 环境中的 webhook 和 Salt


第 4 步:在 HitPay 中设置 Webhook

Webhook 是 HitPay 在付款完成或失败时通知 EasyBiz 的方式。您需要设置它,EasyBiz 才会知道客户已经付款。

  1. 在 HitPay 控制面板中,点击 Developers → Webhook Endpoints 选项卡

  2. 点击 + New Webhook

  3. 填写以下内容:

  • Webhook Name:任意名称,例如 EasyBiz

  • Webhook URL:粘贴您在第 2 步从 EasyBiz 窗口复制的 webhook 网址

  • 在 Payment Request 下,同时勾选 Completed 和 Failed

  1. 点击 Save

  2. 新的 webhook 会出现在列表中,旁边有一个 Salt 值。复制这个 Salt


第 5 步:在 EasyBiz 中保存连接

回到您在第 2 步保持打开的 EasyBiz 窗口。如果已经关闭,请重新前往 设置 → 集成,点击 HitPay 的 连接(已有其他国家连接时,按钮显示为 管理),然后点击您所在国家的那一行。

  1. 确认 API Key 字段中是您在第 3 步复制的密钥

  2. 把您在第 4 步复制的 Salt 粘贴到 Webhook Salt 字段

  3. 可选:使用 发送 HitPay 收据邮件给客户 开关,决定 HitPay 是否向客户发送它自己的付款收据邮件

  4. 点击 保存


设置完成

点击 保存 后,该国家的 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

  1. 前往 设置 › 销售渠道 › 在线商店与移动应用。

  2. 在商店卡片上,点击 编辑在线商店。移动应用开启时,按钮会显示为 编辑移动应用 或 编辑在线商店和移动应用。

  3. 在 页面 下,点击 付款。

  4. 在 第三方 下,开启您希望客户使用的每种付款方式,例如 PayNow 或 Card,并选择 HitPay 作为提供方。拖动各行,排成客户看到的顺序。

  5. 预览您的商店,然后发布。请参阅编辑、预览并发布您的在线商店。

商店编辑器的付款页面,已通过 HitPay 开启 PayNow 和 Card

要求保存银行卡

客户可以在预约时通过 HitPay 保存银行卡。订单准备好后,系统会自动从这张银行卡扣款。如果要让某个业务单元在预约时必须保存银行卡,请在商店编辑器的 结账 页面,把该业务单元的付款一行设为 必须绑定银行卡。

这需要一个可以保存银行卡的 HitPay 账户。如果付款一行提示您检查,请点击 检查 HitPay。如果它显示您的账户无法保存银行卡(仅限 GIRO),客户在预约时就无法添加银行卡:请联系 HitPay 为定期扣款开通银行卡功能,然后再检查一次。

如果之后保存了另一个 API 密钥,请在发布前再点击一次 检查 HitPay。

HitPay 会把每张已保存的银行卡记在客户的电子邮箱名下。账户中没有电子邮箱的客户会看到“请先在联系方式中添加邮箱,才能保存银行卡。”

完整的在线商店收款设置,请参阅在您的在线商店收款。


如果没有成功

客户已经付款,但 EasyBiz 中的订单没有显示为已付款。

这几乎总是因为 HitPay 无法通知 EasyBiz。请检查三件事:

  1. Webhook 网址正确。 在 HitPay 控制面板中前往 Developers → Webhook Endpoints,把网址与 EasyBiz Webhook Setup 方框中显示的网址逐字比对。请使用两边的 Copy 按钮,不要手动重新输入。

  2. 两个事件都已勾选。 Webhook 必须在 Payment Request 下勾选 Completed 和 Failed。

  3. 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 概览。