# HyperPayをストアに連携する方法

HyperPayを使うと、サウジアラビアのお客様は、安全な決済ページでmada、Visa、Mastercard、Apple Pay、STC Payでオンライン決済できます。HyperPayアカウントはそれぞれ1つの通貨（SAR、AED、QAR、EGP、USD）で動作し、価格がその通貨の場合にのみ購入手続き画面に表示されます。

## 手順

1. HyperPayから認証情報を取得します。 **アクセストークン** と、決済グループ（Visa / Mastercard、mada、有効な場合はApple PayとSTC Pay）ごとに1つの **Entity ID** です。
2. Dropifyで **アプリ → 見つける** に移動し、 **HyperPay** を見つけて **インストール** をクリックします。
3. アプリページで **HyperPay を連携** （または **アカウントを追加** ）をクリックし、 **アカウント名** を入力して、 **アクセストークン** と **Entity ID（Visa / Mastercard）** を貼り付け、任意のmada、Apple Pay、STC PayのEntity IDを追加し、 **アカウントの通貨** （サウジアラビアのアカウントはSAR）を選んで保存します。DropifyはHyperPayで各Entityを確認します。
4. **設定** カードで、テスト用の認証情報の場合は **サンドボックスモード** 、本番用の場合は **ライブモード** を選びます。
5. 推奨： **Webhook URLをコピー** をクリックし、HyperPayのダッシュボードに追加して、その復号キーを **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/ja/payments_gateways/moyasar/)
- [Geideaをストアに連携する方法](https://help.dropify.shop/ja/payments_gateways/geidea/)
