概要
VibeFox PayPal Gateway は、OpenCart 3 および OpenCart 4 のチェックアウトに PayPal スマート決済ボタン（PayPal Smart Payment Buttons）を追加します。Confirm Order の段階で購入者が PayPal ボタンをクリックし、PayPal のウィンドウで PayPal アカウントまたは PayPal が提供するその他の決済元を使って支払いを承認すると、注文がお店で完了します。サーバーは PayPal の注文を読み取り、そのステータス、金額、通貨を確認してから、初めて支払いをキャプチャまたは承認します。OpenCart は支払いの前に注文を作成しますが、注文に状態が付与されるのは PayPal が応答した後だけです。そのため、未払いの試行は欠落注文のまま残ります。
PayPal の REST API アプリを使って PayPal での決済を受け付けたいストアに適しています。テストはサンドボックス、実際の支払いは本番モードで行えます。この拡張機能には PayPal の Webhook がないため、PayPal アカウントで行われた紛争や返金は OpenCart に同期されません。Pay Later のメッセージ、カード入力欄、Venmo、Apple Pay、Google Pay、保存された支払い方法、サブスクリプションはなく、商品ページやカートページに PayPal ボタンは表示されません。
主な機能
サーバー側での検証:支払いを受け付ける前に、PayPal 注文のステータス、金額、通貨、所有者を確認します。金額は常にサーバーで計算されます。承認後に注文合計が変わった場合は、何も捕捉されず、購入者が新しい合計を承認する必要があります。
キャプチャまたはオーソリ:購入者にすぐ請求するか、資金を確保するだけにして、後で注文タブからキャプチャまたは取り消すかを選べます。
二重請求なし:1 回の支払いは 1 つのカートにのみ対応し、キャプチャのリクエストは冪等です。応答が失われた後に PayPal が完了させた以前の試行があれば、新しい試行の代わりにそれを使用します。カートのロックにより、二重送信も防止されます。
保留中のキャプチャ:PayPal が審査中のキャプチャには、お使いの支払い保留ステータスが付与されます。Check PayPal payment status で再読み込みできます。
注文ページからの返金:注文の VibeFox PayPal Gateway タブで全額返金と一部返金ができます。返金額は PayPal が実際に請求した金額までで、支払いが行われた PayPal 環境（サンドボックスまたは本番）に送信されます。
PayPal の 24 通貨:HUF、JPY、TWD の金額は、PayPal の要件に従って小数点なしで送信されます。非対応の通貨では支払い方法は表示されません。
独自の注文ステータス:支払い済み、保留中、承認済み、保留（審査）、取り消し、返金済み、失敗した支払いのそれぞれについて、OpenCart のステータスを選択できます。
OpenCart の条件:地域ゾーン、最低注文金額、並び順。認証情報や購入者データを含まないログ。
要件
OpenCart 3.0.x（3.0.5.0 でテスト済み）または OpenCart 4.0.2 以降（4.1.0.3 でテスト済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。サンドボックスまたは本番用の REST API アプリ（Client ID と Secret）を持つ PayPal Business アカウント。PayPal が対応しているストア通貨。vibefox.net で購入した VibeFox ライセンスキー（ドメインごとに 1 つ）。