概要
VibeFox SimplePay Gateway は、ハンガリーの決済サービスである SimplePay によるカード決済を OpenCart 3 と OpenCart 4 に追加します。拡張機能は SimplePay API v2 に接続します。最後のチェックアウトステップで購入者が Confirm Order をクリックすると、SimplePay の決済ページに移動し、カードで支払って貴店に戻ります。カード情報が貴サイトを経由することはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが付くのは SimplePay が決済を確認した後だけです。そのため、未払いの試行は欠番の注文として残ります。
HUF、EUR、USD で販売し、SimplePay の加盟店アカウントを持つストアに適しています。拡張機能が対応するのは 1 回限りのカード決済だけです。保存済みカードやワンクリック決済、定期購入や継続決済、オーソリとキャプチャの分離には対応しておらず、SimplePay の加盟店管理画面で行われた返金は自動では同期されません。
主な機能
通貨ごとに 1 アカウント:HUF、EUR、USD それぞれの MERCHANT と SECRET KEY を、本番とサンドボックスの両方で設定できます。決済方法は、現在のモードでアカウントがある注文通貨に対してのみ提示されます。HUF の金額は整数のフォリントで送信されます。
SimplePay が確認した場合にのみ支払い済み:注文のステータスは、署名された SimplePay の IPN を受け取った後、または購入者が成功結果を伴って戻った後に署名付きのステータス照会を行った後に設定されます。戻っただけで注文が支払い済みになることはありません。
署名付きのリクエスト:SimplePay へのすべてのリクエストに署名し、SimplePay からの応答を検証します。署名が無効な IPN は拒否されます。
金額と通貨の確認:決済を開始した後に注文が変更されていた場合、注文は支払い済みにする代わりに、メモ付きの確認ステータスに移ります。
二重処理の防止:繰り返し届く IPN や同時に発生する戻りによって、決済が二重に適用されることはありません。各再試行には独自の SimplePay 参照番号が割り当てられ、古い試行の遅延した決済も引き続き認識されます。
注文ページからの返金:注文の VibeFox SimplePay Gateway タブで全額返金と一部返金ができます。返金は常に、その決済で使われた加盟店アカウントとモード（サンドボックスまたは本番）で行われます。全額返金を行うと Refunded ステータスが設定されます。
SimplePay が求める表示:注文の完了ページに SimplePay のトランザクション ID を表示し、チェックアウトでは決済の失敗、キャンセル、タイムアウト時に SimplePay が提供する文言を表示します。
OpenCart の条件:独自の注文ステータス、地域（ジオゾーン）、最低注文金額、並び順を設定できます。キーや購入者データを含まないログを任意で有効にできます。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。販売する通貨の SimplePay 加盟店アカウント（MERCHANT と SECRET KEY）：HUF、EUR、USD。vibefox.net で購入した VibeFox ライセンスキー（1 つのキーは 1 つのドメインで使用可能）。