概要
VibeFox HyperPay Payment Gateway は、HyperPay COPYandPAY ウィジェットによるカード決済を OpenCart 3 と OpenCart 4 に追加します。購入者が Confirm Order をクリックすると、ストアの決済ページに HyperPay ウィジェットが表示され、購入者は VISA、Mastercard、mada、American Express、STC Pay、Apple Pay のいずれかで支払います。カード情報は HyperPay ウィジェットでのみ入力され、お使いのサーバーを経由することはありません。OpenCart は支払いの前に注文を作成しますが、注文にステータスが設定されるのは HyperPay が支払いを確認した後です。そのため、途中で離脱された支払いや拒否された支払いは、欠落した注文として残ります。
HyperPay の加盟店アカウントをお持ちの、サウジアラビア、アラブ首長国連邦、ヨルダン、バーレーン、オマーン、カタール、エジプトなどの MENA 市場のストアに適しています。OpenCart からの返金や取消（OpenCart からは行えず、HyperPay のダッシュボードで実施します）、カードの保存、サブスクリプション、Apple Pay のドメイン検証、ブランドごとの個別事業体、後払い（buy now, pay later）の決済方法には対応していません。
主な機能
HyperPay ウィジェット：決済ページの COPYandPAY ウィジェットです。Subresource Integrity を使って読み込まれ、HyperPay が対応している場合は購入者の言語で表示されます。表示するブランドを選択できます。
HyperPay が確認した場合にのみ支払い済みに：購入者がストアに戻った際のサーバー間ステータス照会と、ブラウザーを閉じた場合の暗号化された Webhook（AES-256-GCM）によって確認されます。戻り先 URL だけで注文が支払い済みになることはありません。その後、OpenCart は通常どおり注文メールを送信します。
注文との照合：支払いは注文自身のチェックアウトのいずれかに属している必要があり、金額と通貨も一致している必要があります。不一致の場合、注文はメモ付きのレビュー状態になります。
二重処理の防止：各結果は一度だけ適用されます。Webhook の重複受信やページの再読み込みによって支払いが二重に処理されることはなく、別の注文ですでに支払い済みのカートに再度請求されることもありません。二重払い、キャンセル後の支払い、取り消しはすべて注文にメモとして記録されます。
即時請求または事前承認：すぐに請求するか、金額を確保しておき、後で注文ページのタブから Capture payment でキャプチャできます。
テストモードと本番モード：モードごとに Access Token、Entity ID、Webhook キーを個別に設定します。ステータス照会、キャプチャ、Webhook は常に、チェックアウトが作成されたときのモードを使用します。
ストア独自の注文ステータス：支払い済み、承認済み、保留中、保留（審査中）、キャンセル済み、返金済みの各状態に対応する OpenCart のステータスを選択できます。
OpenCart の条件設定：ジオゾーン、最小注文金額、並び順。ログにはカード情報、キー、購入者データを記録しません。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、OpenSSL 拡張機能を備えた PHP 8.0 以降。ダウンロードには両バージョンのパッケージが含まれています。Access Token と Entity ID（テストおよび本番）を持つ HyperPay 加盟店アカウントと、復号キーを持つ支払い Webhook。vibefox.net で入手できる VibeFox ライセンスキー（ドメインごとに 1 つ）。