概要
VibeFox Flutterwave Payment は、Flutterwave のホスト型決済ページ（Flutterwave Standard、API v3）を通じて Flutterwave の決済を OpenCart 3 および OpenCart 4 に追加します。チェックアウトの最後の手順で、購入者は Confirm Order をクリックし、Flutterwave のページに移動して、カード、銀行振込、USSD、モバイルマネーなど、Flutterwave アカウントで有効になっている任意の方法で支払い、ストアに戻ります。OpenCart は決済の前に注文を作成しますが、注文に状態が付与されるのは Flutterwave が決済を確認した後です。そのため、未払いの試行は欠番の注文として残ります。
ナイジェリア、ガーナ、ケニア、南アフリカ、東アフリカおよびフランス語圏アフリカのストア、ならびに国際カードを受け付けるストアに適しています。注文は常に注文通貨で請求されます。この拡張機能は一回限りの決済のみに対応しています。サイト上でのインラインまたはモーダルのチェックアウトはなく、保存済みカード、サブスクリプション、分割払い、支払いプランにも対応していません。Flutterwave の管理画面で行った返金は OpenCart に同期されません。
主な機能
ホスト型チェックアウト：注文金額を注文通貨で決済として作成し、通貨の精度に合わせて丸めます（XOF、XAF、UGX、RWF などは小数点がありません）。Flutterwave ページに表示される決済オプションを制限できます。
Flutterwave が確認した場合にのみ支払い済み：戻りの URL も Webhook の内容も信頼されません。すべての決済はサーバーから Flutterwave に改めて問い合わせられ、ステータスが成功で、金額と通貨が一致した場合にのみ、注文は支払い済みになります。その後、OpenCart は通常の注文メールを送信します。
署名付き Webhook：Webhook は、あなたのシークレットハッシュが付いている場合にのみ受け付けられます。購入者がブラウザを閉じた場合でも決済を確認します。
二重処理の防止：繰り返し届く Webhook や戻りが決済を二重に適用することはありません。新しい試行の前に、注文とカートの未完了の決済が確認され、後から支払われた古い決済リンクも引き続き受け付けられ、支払い済みの注文に対する二度目の決済は返金対象としてマークされます。
保留中の決済方法への対応：購入者が戻った時点で銀行振込、USSD、モバイルマネーの決済が保留中である場合、Flutterwave が確認するまで注文は待機ステータスになります。
注文ページからの返金：注文の VibeFox Flutterwave Payment タブから、全額返金と一部返金ができます。返金額と通貨は Flutterwave が請求した内容に従い、決済が行われたモードのキーを使用します。
テストと本番：テストと本番では別々のシークレットキーを使用します。本番モードでテストキーを使う、またはテストモードで本番キーを使うと、決済方法は非表示になり、警告が表示されます。
OpenCart の設定：独自の注文ステータス、任意の自動完了、ジオゾーン、最低注文金額、並び順。キーや購入者データを含まない任意のログ。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。両方のバージョン用のパッケージが 1 つのダウンロードに含まれています。シークレットキーと、シークレットハッシュを持つ Webhook を設定した Flutterwave アカウント。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。