概要
VibeFox Adyen Gateway は、Adyen Payment Links による決済を OpenCart 3 と OpenCart 4 に追加します。最後のチェックアウトの手順で、購入者は Confirm Order をクリックし、Adyen がホストする決済ページに移動して、Adyen の加盟店アカウントで有効になっている任意の方法（カード、ウォレット、各国のローカル決済手段）で支払い、貴店に戻ります。カード情報が貴店のサイトを経由することはありません。OpenCart は決済前に注文を作成しますが、注文がステータスを持つのは、Adyen が署名付きのウェブフックで決済を確認した後だけです。そのため、支払われなかった試行は欠落注文として残ります。
Adyen の加盟店アカウントを持っており、自店のサイト上に決済フォームを作ることなく、そのアカウントの決済手段を利用したいストアに適しています。本拡張機能には、サブスクリプションや定期決済、保存済みカード、サイト上のカード入力欄（Drop-in や Components）、OpenCart 内のキャプチャまたはキャンセルのボタンはありません。キャプチャは Adyen アカウントの設定に従います。
主な機能
Adyen Payment Links: 注文通貨での注文合計に対して決済リンクが作成されます。金額は、通貨ごとに Adyen が要求するマイナー単位で指定されます（JPY、KRW、IDR など小数点なしの通貨、KWD、BHD など小数点以下 3 桁の通貨）。
Adyen が確認した場合にのみ支払い済みに: 注文のステータスは、HMAC 署名付きの AUTHORISATION ウェブフックによってのみ設定されます。ストアに戻っただけでは注文が支払い済みになることはありません。その後、OpenCart は通常の注文メールを送信します。
金額と通貨の確認: Adyen が確認した金額と通貨を注文と照合します。不一致の場合、注文はメモ付きの確認中ステータスになります。
二重処理なし: 繰り返し届いたり並行して届いたりしたウェブフックの配信によって、決済が二重に記録されることはありません。新しい決済の試行によって、その注文とカートの以前の決済リンクは期限切れになります。支払い済みの注文に対して 2 回目の決済が成功した場合は、警告のメモが追加されます。
テストモードと本番モード: 環境ごとに、API キーと HMAC キーを別々に設定します。テストの通知が本番の決済を確定させることはなく、返金は常に決済が行われた環境と加盟店アカウントに対して行われます。
注文ページからの返金: 注文の VibeFox Adyen Gateway タブで、Adyen が承認した金額と通貨により、全額返金と一部返金ができます。結果は Adyen からのウェブフックで確認されます。全額返金を行うと Refunded ステータスになります。
独自の注文ステータス: 支払い済みの注文、審査中の決済、キャンセルされた決済、全額返金それぞれに対して、OpenCart の注文ステータスを選択できます。
OpenCart の条件とログ: 地域（Geo Zone）、注文の最低合計金額、並び順。API キーや購入者の個人データを含まないログを利用できます。
要件
OpenCart 3.0.x（3.0.5.0 で検証）または OpenCart 4.0.2 以降（4.1.0.3 で検証）、PHP 8.0 以降。両方のバージョン用のパッケージが 1 つのダウンロードに含まれています。API キーを持つ Adyen の加盟店アカウント、HMAC キーを持つ Standard ウェブフック、そして本番決済用のライブ URL プレフィックス。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つのキー）。