概要
VibeFox HyperPay Payment Gateway は、HyperPay の COPYandPAY ウィジェットによるクレジットカード決済を PrestaShop に追加します。購入者はチェックアウトで注文を確定すると、ストアの決済ページに HyperPay の決済ウィジェットが表示され、そこで VISA、Mastercard、mada、American Express、STC Pay、Apple Pay を使って支払えます。カード情報は HyperPay のウィジェットにのみ入力され、貴店のサーバーに届くことはありません。注文は HyperPay が支払いを確認した後にのみ作成されるため、途中で放棄された支払いや拒否された支払いによって未払いの注文が残ることはありません。
HyperPay の加盟店アカウントを持つ、サウジアラビア、アラブ首長国連邦、ヨルダン、バーレーン、オマーン、カタール、エジプト、その他の MENA 市場のストアに適しています。本モジュールは PrestaShop からの返金や取り消し（HyperPay の管理画面で行ってください）、カードの保存、サブスクリプション、Apple Pay のドメイン認証、ブランドごとの個別 Entity ID、後払い（buy now, pay later）方式には対応していません。
主な機能
HyperPay ウィジェット: 決済ページに COPYandPAY ウィジェットを表示します。Subresource Integrity を使って読み込まれ、HyperPay が対応している場合は購入者の言語で表示されます。表示するブランドを選べます。
HyperPay が確認した場合にのみ支払い済みになります: 購入者がストアに戻ったときのサーバー間ステータス照会と、ブラウザを閉じた場合の暗号化ウェブフック（AES-256-GCM）によって確認します。戻り先 URL だけでは、支払い済みの注文が作成されることはありません。
カートと照合: 支払いは、そのカート自身の HyperPay 決済セッションに属している必要があり、金額と通貨も一致しなければなりません。一致しない場合、注文は HyperPay payment on hold になり、メモが追加されます。
二重処理を防止: 各結果は 1 回だけ適用されます。ウェブフックの重複受信やページの再読み込みによって、2 つ目の注文が作成されることはありません。二重決済、キャンセル後の支払い、リバーサル（reversal）は注文にメモされます。
即時決済または事前承認: すぐに請求するか、金額を確保しておき、後で注文の HyperPay ブロックにある Capture payment でキャプチャできます。
テストと本番: モードごとに個別の Access Token、Entity ID、ウェブフックキーを設定します。ステータス照会、キャプチャ、ウェブフックは、決済セッションを作成したモードで常に処理されます。
分かりやすいメッセージ: 拒否された、完了していない、またはまだ確認できていない支払いは、チェックアウトで購入者に説明され、再試行できるようカートは保持されます。
注文ページの HyperPay ブロック: 支払い ID、決済セッション、金額、結果、キャプチャボタンを表示します。ログにはカード情報、キー、購入者データは含まれません。
要件
PrestaShop 8.0 から 9.x、OpenSSL 拡張を備えた PHP 8.0 以降。Access Token と Entity ID（テストと本番）を持つ HyperPay 加盟店アカウント、および復号キーを持つ支払い用ウェブフック。VibeFox ライセンスキー（vibefox.net で購入。1 つのキーは 1 つのドメインで使用可能）。