概要
VibeFox Iugu Gateway は、ブラジルのストア向けに OpenCart 3 および OpenCart 4 へ Iugu 決済を追加します。最後のチェックアウト手順で購入者が Confirm Order をクリックすると、拡張機能が Iugu の請求書を作成し、購入者を Iugu の請求書ページへ移動させます。購入者はそこでクレジットカード、boleto、PIX のいずれかで支払います。OpenCart は支払いの前に注文を作成しますが、注文にステータスが付くのは Iugu API から請求書を読み戻した後だけです。そのため、未払いの試行は欠番の注文のまま残ります。
ブラジルレアルで販売し、自社サイトに決済フォームを置かずにカード、boleto、PIX による支払いを受け付けたいストアに適しています。この拡張機能は一回限りの支払いのみに対応しています。サイト内のカードフォーム、保存済みカード、定期購入、分割払い用の carnê、分割決済には対応していません。
主な機能
Iugu の請求書ページ：注文合計に対する BRL の請求書を 1 件作成します。支払期限は 3 日後で、Iugu アカウントで有効になっている方法（クレジットカード、boleto、PIX）で支払えます。
Iugu が確認した場合にのみ支払い済みに：通知にはストアが信頼できる支払いデータは含まれません。請求書は常に Iugu API から読み戻され、金額と通貨が注文と照合されます。不一致があれば、注文はメモ付きの確認ステータスになります。その後、OpenCart は通常どおり注文メールを送信します。
Boleto と PIX：boleto または PIX のコードを発行した購入者には、入金待ちのステータスが付きます。Iugu から入金が報告されると、注文は支払い済みのステータスに移ります。
二重処理なし：繰り返される通知や戻りが、同じ支払いを二重に適用することはありません。1 つのカートは一度だけ支払われます。新しい請求書を作成する前に、そのカートの未処理の請求書は再利用されるか、Iugu でキャンセルされます。
テストとライブのトークン：モードごとに別々の API トークンを使用します。ステータス確認と返金は、請求書を作成したモードのトークンを常に使用します。
注文ページからの返金：注文の VibeFox Iugu Gateway タブから、クレジットカードの全額・一部返金と、PIX の全額返金を行えます。返金は Iugu が確認した場合にのみ計上されます。全額返金を行うと Refunded ステータスになります。
独自の注文ステータス：支払い済み、入金待ち、確認中、期限切れ、キャンセル、返金済みの請求書に対して、OpenCart のステータスを選択できます。
OpenCart の条件：地域（Geo Zone）、最低注文金額、並び順。CPF/CNPJ は、CPF または CNPJ という名前のカスタムフィールドから取得されます。トークンや購入者データを含まない、任意のログ機能があります。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。このダウンロードには両方のバージョン用のパッケージが含まれています。ストアの通貨としてブラジルレアル（BRL）が必要です。テスト用とライブ用の両方の API トークンを持つ Iugu アカウント。vibefox.net で購入した VibeFox ライセンスキー（ドメインごとに 1 つ）。