概要
VibeFox Flutterwave Payment は、Flutterwave がホストするチェックアウトページ（Flutterwave Standard、API v3）を通じて、PrestaShop に Flutterwave 決済を追加します。支払いの段階で購入者は Flutterwave を選択し、Flutterwave のページに移動して、貴ショップの Flutterwave アカウントで有効な方法（カード、銀行振込、USSD、モバイルマネーなど）で支払い、貴ショップに戻ります。注文は Flutterwave が支払いを確認した後にのみ作成されるため、途中で放棄された決済によって未払いの注文が残ることはありません。
ナイジェリア、ガーナ、ケニア、南アフリカ、東アフリカ、フランス語圏アフリカのショップや、海外のカードを受け付けるショップに適しています。請求は常にカートの通貨で行われます。本モジュールは都度払いのみに対応しています。貴サイト内の埋め込み型やモーダル型のチェックアウト、保存済みカード、定期購入、分割決済、支払いプランには対応しておらず、Flutterwave ダッシュボードで行った返金は PrestaShop に同期されません。
主な機能
ホスト型チェックアウト: カートの通貨でカート合計額の決済を作成し、その通貨の精度に合わせて丸めます（XOF、XAF、UGX、RWF などは小数桁がありません）。Flutterwave ページに表示する支払い方法を制限できます。
Flutterwave の確認後のみ支払い済みに: 戻り先 URL もウェブフック本文も、そのまま信用しません。各決済は貴ショップのサーバーから Flutterwave に再照会し、参照情報がカートに属し、ステータスが成功を示し、金額と通貨が一致した場合にのみ注文を支払い済みにします。
署名付きウェブフック: 設定した秘密ハッシュを持つウェブフックのみ受け付けます。購入者がブラウザーを閉じても決済を確認できます。
二重処理を防止: ウェブフックや戻り処理が繰り返されても、2 つ目の注文が作成されたり、決済が二重に記録されたりすることはありません。後から支払われた古い決済リンクも受け付け、支払い済み注文への二度目の支払いは返金対象として示されます。
保留中の支払い方法に対応: 銀行振込、USSD、モバイルマネーの決済が保留中の間、注文は Flutterwave の確認まで Awaiting Flutterwave payment のままになります。
注文ページからの返金: 注文の Flutterwave payment ブロックで、Flutterwave が請求した金額と通貨により、全額返金と一部返金ができます。決済時のモードのキーを使用します。
テストと本番: 秘密キーを個別に設定します。本番モードでテストキー、またはテストモードで本番キーを入力すると、支払い方法を非表示にして警告を表示します。
注文ページの Flutterwave ブロック: 参照情報、取引、モード、返金履歴、注文の Flutterwave メモを表示します。キーや購入者データを含まない任意のログを利用できます。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。秘密キーを持つ Flutterwave アカウントと、秘密ハッシュを設定したウェブフック。vibefox.net の VibeFox ライセンスキー（ドメインごとに一つのキー）。