概要
VibeFox PagSeguro Gateway は、ブラジルのストア向けに OpenCart 3 と OpenCart 4 を PagBank（PagSeguro）Checkout API に接続します。チェックアウトの最後のステップで、購入者は Confirm Order をクリックし、PagBank の決済ページに移動して、お客様の PagBank アカウントで有効になっている決済方法（クレジットカード、PIX、boleto など）で支払います。決済はブラジル レアル（BRL）のみで受け付けます。OpenCart は決済の前に注文を作成しますが、注文はPagBank が決済を報告した後にのみステータスを取得します。そのため、未払いの試行は欠落注文のままになります。
この拡張機能は、PagBank のホスト型決済ページを使い、OpenCart の注文ページから返金を行いたいブラジルのストア向けです。ストア内にカードフォームはなく、カードの保存、サブスクリプションや定期決済、分割決済にも対応していません。決済方法と分割払いは、お客様の PagBank アカウントで設定されたものが使われます。
主な機能
PagBank の決済ページ: 注文合計を BRL で支払う 1 回のチェックアウト。決済ページは 120 分後に期限切れになります。
PagBank が確認した場合のみ支払い済み: 通知と購入者の戻りは、確認を開始するだけです。チェックアウト、PagBank の注文、およびその請求は、決済が作成された環境のトークンを使って、常に PagBank API から読み取られます。
署名付きの通知: PagBank が x-authenticity-token ヘッダーを送信する場合、お客様のトークンで検証されます。無効な署名は拒否されます。
金額と通貨の確認: 請求された金額（PagBank の分割払い手数料を除く）と通貨が注文と照合されます。差異や、キャンセル後の決済があった場合は、注文にメモ付きのレビューステータスが設定されます。
boleto、PIX、審査: 生成された boleto や PIX、または審査中の決済があると、PagBank が支払い済みと報告するまで注文は保留ステータスになります。
1 つのカート、1 回の支払い: 購入者が再度支払う場合、開いている PagBank のチェックアウトは再利用されるか、先に無効化されます。以前のページでの支払いも有効なままで、2 回目の支払いは返金対象としてマークされます。
注文ページからの返金: 注文の VibeFox PagSeguro Gateway タブで、全額返金と一部返金ができます。上限は PagBank が実際に請求した金額です。PagBank のダッシュボードで行われた返金は、注文にメモとして記録されます。
サンドボックスと本番: トークンは別々です。ステータスの確認と返金は、常に決済の環境を使用します。各ケースに対応する独自の OpenCart 注文ステータスを設定できます。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。ダウンロードには両方のバージョン用のパッケージが含まれています。ストアで通貨ブラジル レアル（BRL）を使用すること。本番トークンとテスト用のサンドボックストークンを備えた PagBank アカウント。VibeFox ライセンスキー（vibefox.net で購入。1 つのキーは 1 つのドメインで使用可能）。