概要
VibeFox Pagar.me Gateway は、ブラジルのストア向けに OpenCart 3 および OpenCart 4 を Pagar.me（Stone）Core API v5 に接続します。チェックアウトの最後のステップで、購入者は Confirm Order をクリックし、Pagar.me の決済ページに移動して、クレジットカード、PIX、boleto、またはデビットカードで支払います。決済はブラジル レアル（BRL）のみで受け付けます。OpenCart は決済の前に注文を作成しますが、注文はPagar.me が決済を確認するか、PIX または boleto を発行した後にのみステータスを取得します。そのため、未払いの試行は欠落注文のままになります。
この拡張機能は、主要なローカル決済方法を 1 つのホスト型ページで提供し、OpenCart の注文ページから返金を行いたいブラジルのストアに適しています。チェックアウト内にカードフォームはなく、カードの保存、サブスクリプションや定期決済、分割払いのルール、分割決済、オーソリのみのカード決済にも対応していません。
主な機能
Pagar.me の決済ページ: クレジットカード、PIX、boleto、デビットカード。提供する決済方法と、boleto の有効日数（1～30 日）を選べます。
Pagar.me が確認した場合のみ支払い済み: ウェブフックと購入者の戻りは、どの Pagar.me 注文を確認すべきかをストアに伝えるだけです。注文は、お客様の秘密キーを使って Pagar.me API から読み取られます。
金額と通貨の確認: 支払われた請求額は注文合計と照合されます。差異、支払い不足の boleto、またはキャンセル後の支払いがあった場合は、注文にメモ付きのレビューステータスが設定されます。
PIX と boleto: PIX または boleto が発行されると、Pagar.me が支払いを確認するまで注文は保留ステータスになります。期限切れの場合は失敗ステータスに設定されます。
1 つのカート、1 回の支払い: 購入者が再度支払う場合、開いている決済ページは再利用されるか、先に Pagar.me 上で閉じられます。同じカートに対する 2 回目の支払いは、返金対象としてマークされます。
注文ページからの返金: 注文の VibeFox Pagar.me Gateway タブで、カードおよび PIX 決済の全額返金と一部返金ができます。上限は Pagar.me が実際に受け取った金額です。Pagar.me で行われた返金やチャージバックは、注文にメモとして記録されます。
テストと本番: テスト用と本番用の秘密キーは別々です。ステータスの確認と返金は、常に決済が作成されたモードのキーを使用します。
独自の注文ステータス: 支払い済みの注文、保留中の PIX または boleto、レビュー中の決済、失敗した決済、返金のそれぞれについて、OpenCart のステータスを選べます。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。ダウンロードファイル 1 つに、両方のバージョン用パッケージが含まれます。ストアで通貨ブラジル レアル（BRL）を使用すること。テスト用と本番用の秘密キーおよびウェブフックを備えた Pagar.me アカウント。VibeFox ライセンスキー（vibefox.net で購入。1 つのキーは 1 つのドメインで使用可能）。