概要
VibeFox Iugu Gateway は、ブラジルのストア向けに Iugu による決済を PrestaShop に追加します。決済ステップで購入者が Iugu を選ぶと、モジュールがカートの合計金額に対する Iugu の請求書を作成し、購入者を Iugu の請求書ページへ案内します。請求書は、クレジットカード、boleto bancário、PIX で支払われます。カード情報が貴店のサイトを経由することはありません。注文は、Iugu が支払いを報告したとき、または購入者が発行済みの boleto や PIX を持って戻ったときにのみ作成されます。
ブラジルレアル（BRL）で販売し、Iugu アカウントをお持ちのブラジルのストアに適しています。モジュールが扱うのは 1 回限りの支払いだけです。PrestaShop 上にサイト内のカードフォーム、保存済みカード、サブスクリプションや定期請求、carnê（分割払い用の支払い票）、分割払い、割賦設定はありません。
主な機能
Iugu の請求書ページ: カートの合計金額に対する請求書が BRL で作成されます。購入者は、Iugu アカウントで有効になっている支払い方法（クレジットカード、boleto、PIX）から選んで支払います。
Iugu が確認した場合のみ支払い済みに: 通知と購入者の戻り操作は、確認すべき請求書をストアに伝えるだけです。請求書は必ず Iugu API から読み直され、そのステータス、金額、通貨がカートと照合されます。不一致の場合、注文は Iugu payment on hold になります。
Iugu での設定は不要: すべての請求書に、貴店の通知 URL が含まれます。
二重処理なし: 請求書のステータスは 1 回だけ適用されるため、繰り返される通知や戻り操作によって注文が二つ作られたり、支払いが二重に記録されたりすることはありません。新しい支払い試行では、未払いの請求書を再利用するか、先に Iugu でその請求書をキャンセルします。重複した支払いは返金対象としてマークされます。
boleto と PIX に対応: boleto または PIX のコードを持って戻った購入者には、Awaiting Iugu payment の注文が作成されます。Iugu が入金を報告すると、Payment accepted に変わります。
テストと本番のトークン: モードごとに別々の API トークンを使用します。ステータスの確認と返金は、請求書が作成されたモードのトークンを必ず使用します。
注文ページからの返金: 注文の Iugu payment ブロックから、クレジットカードは全額または一部、PIX は全額のみ返金できます。Iugu のダッシュボードで行った返金は、注文を Refunded にします。
注文ページの Iugu ブロック: Iugu へのリンク付きの請求書、支払い方法、支払い済み金額と返金済み金額、返金履歴、モジュールのメモを表示します。トークンや購入者のデータを含まない任意のログも利用できます。
要件
PrestaShop 8.0 から 9.x まで、PHP 8.0 以降。カートの通貨はブラジルレアル（BRL）。テスト用と本番用の API トークンを持つ Iugu アカウント。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。