概要
VibeFox PagSeguro Gateway は、PagBank Checkout API を使って PrestaShop を PagBank（旧 PagSeguro）に接続します。支払いの段階で購入者が PagBank を選ぶと、モジュールはカートの合計金額と同額の PagBank 決済を作成し、購入者を PagBank の決済ページへ移動させます。購入者はそこで、PagBank アカウントで有効になっている支払い方法（クレジットカード、PIX、boleto など）で支払い、ストアに戻ります。決済はブラジル・レアル（BRL）でのみ受け付けます。注文は PagBank が決済を確認した後にのみ作成されるため、支払いが中断されても未払いの注文は残りません。
PagBank のホスト型決済ページを利用し、PrestaShop の注文ページから返金を行いたいブラジルのストアに適しています。本モジュールには、ストア内のカード入力フォーム、カードの保存、サブスクリプションや定期決済、分割決済はありません。支払い方法と分割払いは PagBank アカウントで設定したものが使われ、モジュール内では選択しません。
主な機能
PagBank のホスト型決済ページ：カード情報がお客様のサーバーに保存されることはありません。ストアにお客様の氏名、メールアドレス、ブラジルの電話番号、CPF/CNPJ があれば、PagBank のページに自動入力されます。
PagBank が確認した場合にのみ支払い済みに：通知とお客様の戻りは、API からチェックアウトと PagBank の注文（ステータス、センタボ単位の金額、通貨）を読み取って確認します。署名が無効な通知は拒否されます。
PagBank 側での設定は不要：通知 URL は、すべての支払いに含めて送信されます。
金額の確認：金額または通貨がカートと一致しない支払いは、メモ付きで PagBank payment on hold になります。お客様が支払った分割払いの利息も考慮されます。
わかりやすいステータス：支払い済みの注文は Payment accepted に、発行された PIX や boleto、審査中の支払いは Awaiting PagBank payment になります。後に拒否された支払いは Payment error、キャンセルされた支払いは Canceled になります。
二重払いの防止：再度支払う場合は、未完了の PagBank 決済を再利用するか、前の決済を無効にします。通知や戻りが繰り返されても、2 つ目の注文が作成されたり、支払いが 2 回記録されたりすることはありません。
サンドボックスと本番：トークンは別々です。注文のステータス確認と返金は、常にその支払いが行われた環境を使用します。
注文ページからの返金：PagBank payment ブロックで全額および一部返金を行えます。上限は PagBank が請求した金額で、PagBank が確認した場合にのみ記録されます。全額返金を行うと、注文は Refunded になります。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。カート通貨はブラジル・レアル（BRL）。インターネットから HTTPS でアクセスできるストア。本番用トークンを持つ PagBank アカウントと、テスト用のサンドボックストークン。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。