概要
VibeFox Vindi Gateway は、ブラジル・レアル（BRL）で販売するブラジルのストア向けに、OpenCart 3 と OpenCart 4 を Vindi API に接続します。購入者は Vindi の請求書ページでクレジットカード決済を行うか、boleto、PIX、または BolePix（boleto + PIX）で支払うことができます。カード情報が貴店のサイトを経由することはありません。boleto と PIX の場合、注文は直ちに貴店の待機ステータスになり、購入者は成功ページ、アカウント、注文メールで boleto のリンクと PIX コードを受け取ります。
Vindi のアカウントを既にお持ちで、カードフォームを用意せずに 1 回限りの決済を受け付けたいブラジルのストアに適しています。カード決済では、決済の前に OpenCart が注文を作成しますが、注文にステータスが付くのは Vindi が決済を確認した後です。そのため、未払いの試行は欠落注文のままになります。この拡張機能は、1 回払いの単発決済のみに対応しています。サブスクリプションや定期請求、保存されたカード、分割払い（parcelamento）、貴店サイト上のカードフォームには対応しておらず、boleto 決済の返金もできません。
主な機能
4 つの決済方法：クレジットカード、boleto、PIX、BolePix。チェックアウトで提供する方法を選択できます。
CPF / CNPJ フィールド：boleto と PIX の場合にチェックアウトで入力を求められ、チェックディジットで検証されます。可能な場合は、購入者の CPF または CNPJ のカスタムフィールドから自動入力されます。
Vindi が確認した場合のみ支払い済み：拡張機能が Vindi API から請求書を再取得し、通貨、注文コード、Vindi の顧客、正確な金額を確認した後にのみ、支払いが受け付けられます。不一致の場合、注文はメモ付きで保留状態になります。
保護された Webhook：Webhook URL には秘密トークンが含まれ、各通知は Vindi API を通じた再確認を 1 回実行するだけです。
二重決済の防止：1 つのカートは 1 回だけ決済されます。新しい試行では、保留中の Vindi 請求書を再利用するか、先にそれをキャンセルします。OpenCart で未払いの注文をキャンセルすると、対応する Vindi 請求書もキャンセルされます。
本番環境とサンドボックス：API キーは別々です。各決済は請求書が作成された環境を記録するため、確認と返金は常にその環境を使用します。
注文ページからの返金：拡張機能の注文タブで、カードと PIX の決済に対する全額返金と一部返金ができます。返金額は、Vindi が実際に請求した金額までです。全額返金を行うと、注文は設定された返金済みステータスになります。
OpenCart の条件：ジオゾーン、最低注文金額、並び順、独自の注文ステータス。ログにはキーや顧客データは含まれません。
動作要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。ストアでブラジル・レアル（BRL）が使用されていること。API キーを持つ Vindi アカウント（テスト用に Vindi サンドボックスアカウント）。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。