# 如何将 HyperPay 连接到我的店铺？

HyperPay 让沙特阿拉伯的客户可以在安全的支付页面上，通过 mada、Visa、Mastercard、Apple Pay 和 STC Pay 在线付款。每个 HyperPay 账户只使用一种货币（SAR、AED、QAR、EGP 或 USD），只有当您的价格使用该货币时，它才会在结账页面显示。

## 步骤

1. 从 HyperPay 获取您的凭据：一个 **访问令牌**，以及每个支付组（Visa / Mastercard、mada，如已开通还有 Apple Pay 和 STC Pay）各一个 **Entity ID**。
2. 在 Dropify 中，前往 **应用 → 探索**，找到 **HyperPay**，然后点击 **安装**。
3. 在应用页面点击 **连接 HyperPay**（或 **添加账户**），输入 **账户名称**，粘贴 **访问令牌 (Access Token)** 和 **Entity ID（Visa / Mastercard）**，添加可选的 mada、Apple Pay 和 STC Pay Entity ID，选择 **账户货币**（沙特账户为 SAR）并保存。Dropify 会向 HyperPay 验证每个 Entity。
4. 在 **设置** 卡片中，使用测试凭据时选择 **沙盒模式**，使用正式凭据时选择 **生产模式**。
5. 推荐：点击 **复制 Webhook URL**，将其添加到 HyperPay 的后台，并将其解密密钥粘贴到 **Webhook 密钥 (Webhook Secret)** 中。
6. 前往 **店铺设置 → 支付方式** 并开启 **HyperPay**。可选：设置 **在线预付款折扣**。
7. 下一笔测试订单：客户选择 mada、银行卡、Apple Pay 或 STC Pay，然后付款。

只有您已填写 Entity ID 的支付方式才会提供给客户。

## 常见问题

- “HyperPay 在测试模式下拒绝了这些密钥” → 令牌或某个 Entity ID 属于另一个环境。在沙盒模式下请使用测试凭据。
- 支付页面上没有 mada → 请添加 **Entity ID（mada，可选）**；mada 始终有自己的 Entity。
- HyperPay 未在结账页面显示 → 您的店铺货币与 **账户货币** 不同，账户处于未启用状态，或者 HyperPay 在支付方式中处于关闭状态。
- 客户关闭页面后订单一直显示未付款 → 请添加 Webhook（第 5 步）。

## 相关文章

- available payment gateways by country
- [如何将 Moyasar 连接到我的店铺？](https://help.dropify.shop/zh/payments_gateways/moyasar/)
- [如何将 Geidea 连接到我的店铺？](https://help.dropify.shop/zh/payments_gateways/geidea/)
