概要
VibeFox Przelewy24 Payment は、Przelewy24（P24）による決済を OpenCart 3 および OpenCart 4 に追加します。Przelewy24 REST API に接続します。チェックアウトの最後のステップで購入者が Confirm Order をクリックすると、Przelewy24 の決済ページに移動し、BLIK、オンラインバンク振込、カード、または P24 アカウントで有効になっているその他の方法で支払います。カード情報や銀行情報がストアのサイトを経由することはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが設定されるのは、Przelewy24 が決済を確認し、拡張機能がそれを検証した後です。そのため、未払いの試行は欠落注文のままになります。
ポーランドのストア、および PLN、EUR、GBP、CZK でポーランドの購入者に販売し、Przelewy24 の加盟店アカウントを持つストアに適しています。本拡張機能は、保存済みカードやワンクリック決済、サブスクリプションや定期払い、チェックアウトページでの P24 決済方法の選択（BLIK コード入力欄など）、分割払いのウィジェット、通貨換算には対応していません。
主な機能
Przelewy24 が確認した場合のみ支払い済み:注文にステータスが設定されるのは、署名付きの Przelewy24 通知（CRC キーを使用した SHA-384）または認証済みのステータス確認を受けた後、かつ拡張機能が Przelewy24 で取引を検証した後だけです。その後、OpenCart は通常どおり注文メールを送信します。
金額と通貨の確認:支払われた金額と通貨を、決済の試行と注文と照合します。一致しない場合、注文はレビュー用のステータスになり、支払いは確認されません。
P24 の管理画面での設定は不要:通知 URL は支払いごとに送信されます。通知が届かなかった場合でも、購入者がストアに戻った時点でサーバー側のステータス確認により支払いが確認されます。
二重処理なし:同じ通知が繰り返し届いても、支払いが二重に記録されることはありません。すでに支払い済みの注文またはカートに対する 2 回目の支払いは確認されないため、Przelewy24 はそれを入金しません。
サンドボックスと本番:モードごとに個別のキーがあり、既定はサンドボックスです。支払いは、行われたモードで検証され、返金されます。
注文画面からの返金:注文の VibeFox Przelewy24 Payment タブから、全額返金と一部返金ができます。Przelewy24 から報告された結果は、返金履歴とメモに追加されます。
独自の注文ステータス:支払い済みの注文、レビュー中の支払い、キャンセルされた注文、全額返金のそれぞれについて、OpenCart のステータスを選択できます。
OpenCart の条件とログ:ジオゾーン、最低注文金額、並べ替え順。ログには、キーや個人データは記録されません。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認）、PHP 8.0 以降。1 つのダウンロードに両方のバージョンのパッケージが含まれています。Merchant ID、API キー（report key）、CRC キーを持つ Przelewy24 加盟店アカウント。POS ID が Merchant ID と異なる場合は POS ID も必要です。テスト用に別途サンドボックスアカウントを用意してください。支払い通知を受け取るため、ストアがインターネットから到達可能である必要があります。注文通貨: PLN、EUR、GBP、CZK。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つのキー）。