概要
VibeFox PayPal Gateway は、PrestaShop のチェックアウトに PayPal のスマート決済ボタンを追加します。決済ステップで購入者は PayPal を選び、PayPal ボタンをクリックして、PayPal のウィンドウで PayPal アカウントまたは PayPal が提供するその他の支払い元を使って支払いを承認すると、注文が貴店のショップで完了します。貴店のサーバーは PayPal の注文を読み取り、ステータス、金額、通貨を確認したうえで、初めて決済のキャプチャまたは承認を行います。注文は PayPal から応答を受け取った後にのみ作成されます。
自社の PayPal REST API アプリを使って PayPal 決済を受け付けたいショップに適しています。テストはサンドボックス、実際の支払いは本番モードで行います。本モジュールには PayPal のウェブフックがないため、PayPal アカウント内で行われた紛争や返金は PrestaShop と同期されません。Pay Later メッセージ、カード入力欄、Venmo、Apple Pay や Google Pay、保存済みの支払い方法やサブスクリプションには対応しておらず、商品ページやカートページに PayPal ボタンも表示されません。
主な機能
サーバー側での検証:決済金額を受け取る前に、PayPal 注文のステータス、金額、通貨、所有者が確認されます。1 回の PayPal 決済で支払えるのは 1 件のカートのみです。承認後にカート合計が変わった場合は何もキャプチャされず、購入者は新しい合計を承認し直します。
キャプチャまたは承認:購入者からすぐに請求するか、資金を確保しておき、後で注文画面の PayPal ブロックからキャプチャまたは取り消しできます。
二重請求なし:キャプチャのリクエストは冪等に処理されます。応答が失われた後に PayPal 側で完了していた前回の試行は、新たに作成する代わりに利用されます。カートごとのロックによって二重送信も防止されます。
保留中のキャプチャ:PayPal が審査中のキャプチャは、注文を Awaiting PayPal payment にします。Check PayPal payment status を実行すると、ステータスが再確認されます。
注文画面からの返金:PayPal ブロックから全額返金と一部返金ができ、PayPal が実際に請求した金額までとなります。返金は、支払いが行われた PayPal 環境（サンドボックスまたは本番）に送信されます。
PayPal の 24 通貨:HUF、JPY、TWD の金額は、PayPal の要件に従って小数点なしで送信されます。対応していない通貨の場合、この支払い方法は表示されません。
注文画面の PayPal ブロック:PayPal アカウントへのリンク付きのキャプチャ、返金履歴、モジュールのメモを表示します。従業員は注文を編集する権限のみ必要です。認証情報や顧客データを含まない任意のログを利用できます。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。サンドボックスまたは本番用の REST API アプリ（Client ID と Secret）を持つ PayPal Business アカウント。PayPal がサポートしているショップの通貨。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つ）。