VibeFox Vindi for OpenCart — ヘルプ

動作要件

OpenCart：3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。

PHP：8.0 以降。

通貨：ブラジル・レアル（BRL）を System > Localisation > Currencies で設定しておく必要があります。Vindi は BRL でのみ請求するため、決済方法は購入者が BRL で支払う場合にのみ表示されます。

Vindi アカウント：Vindi アカウントの API キーが必要です。Vindi サンドボックスは、独自のキーを持つ別個の Vindi テストアカウントです。boleto、PIX、BolePix を提供する場合は、これらも Vindi アカウントで有効にしておく必要があります。

VibeFox ライセンスキー：vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

ダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。コンピューターで展開してください。README.txt、OpenCart 3 用のパッケージ wcp_vindi_gateway-oc3-(version).ocmod.zip、OpenCart 4 用のパッケージ wcp_vindi_gateway.ocmod.zip が含まれています。お使いの OpenCart のバージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_vindi_gateway-oc3-(version).ocmod.zip を選択します。この拡張機能には OCMOD の変更がないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。

2. Extensions > Extensions に移動し、タイプ Payments を選択します。VibeFox Vindi Gateway を見つけて、Install（緑色の + ボタン）をクリックします。管理者ユーザーには、決済拡張機能の一覧を変更する権限が必要です。

3. Edit（鉛筆ボタン）をクリックして設定ページを開きます。ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。

4. Sandbox API key を貼り付け、準備ができたら Live API key を貼り付けます。Offered methods を選択します。

5. 設定に表示された Webhook URL を Vindi にコピーします（設定を参照）。

6. Enable / Disable をオンにして Save をクリックします。サンドボックスモードで決済をテストし、その後 Sandbox mode をオフにして実際の決済を受け付けます。

OpenCart 4

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_vindi_gateway.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から取得するため、名前を変更したパッケージは動作しません。

2. パッケージは、同じページのインストール済み拡張機能の一覧に表示されます。その横の Install（緑色の + ボタン）をクリックします。

3. Extensions > Extensions に移動し、タイプ Payments を選択します。VibeFox Vindi Gateway を見つけて、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆ボタン）をクリックします。

4. OpenCart 3 の手順 3 から 6 と同じように、ライセンスキー、API キー、決済方法、Webhook を入力します。設定ページとそのフィールドは両方のバージョンで同じです。Webhook URL のみが異なります（Webhook を参照）。

新規インストール時は、決済方法がオフ、サンドボックスモードがオンの状態で始まります。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit。セクションは左側に一覧表示されます。一覧の下にある Save ボタンで、ページ全体を保存します。設定の上部には現在のモードが TEST MODE または LIVE として表示され、現在のモードの API キーが空の場合（この場合、決済方法はチェックアウトで表示されません）や、ストアの既定通貨が BRL でない場合（この場合、決済方法は購入者が BRL で支払う場合にのみ表示されます）に警告が表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時、キーは入力したとおりに保存され、先頭と末尾の空白は除かれます。決済方法が 1 つも選択されていない場合は、クレジットカードが保存され、ページには Choose at least one payment method — credit card was selected. と表示されます。空の Title や 128 文字を超えるタイトル、整数ではない Sort Order（負の値は使用可能）、0 以上の数値ではない Total、存在しないジオゾーンや注文ステータスは受け付けられません。その場合は何も保存されず、ページにたとえば Enter a title for the payment method (1 to 128 characters). のようなメッセージが表示されます。

Vindi

Enable / Disable：Enable Vindi payments は、この決済方法のオン／オフを切り替えます。既定値：オフ。

Title：チェックアウトで表示される決済方法の名称です。注文にも、この決済方法名として保存されます。既定値：Vindi。必須、最大 128 文字。

Description：顧客が Confirm Order の手順で、決済欄の上に見る説明文です。既定値：Pay by credit card on the secure Vindi page, or by boleto / PIX。

Sort Order：チェックアウトの決済方法の中での Vindi の表示順です。空欄のままにするか、整数を入力します（負の値も使用可能）。

Geo Zone：選択したジオゾーン内の支払い住所の顧客にのみ、Vindi を提示します。既定値：All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。

Total：Vindi が提示されるために注文が達している必要がある、ストアの既定通貨でのチェックアウト合計金額です。どの金額でも Vindi を提示する場合は空欄にします。

API キー

Vindi のダッシュボードで Settings > API keys からキーを作成します：本番環境は app.vindi.com.br、サンドボックスは sandbox-app.vindi.com.br です。本番環境とサンドボックスでは、ホストとキーが別々です。各決済は請求書が作成された環境を記録するため、確認、キャンセル、返金は常にその環境を使用します。

Sandbox mode：Vindi サンドボックスで新しい決済を作成します。sandbox-app.vindi.com.br とサンドボックスの API キーを使用します。顧客はチェックアウトで TEST MODE の注記を見ます：Vindi sandbox: no real charges. 既定値：オン。実際の決済を受け付けるには、オフにします。

Live API key：本番の Vindi アカウントの秘密鍵です。Vindi API にのみ送信されます。

Sandbox API key：Vindi サンドボックスアカウントの秘密鍵です。

保存済みのキーは再度表示されることはありません。フィールドは空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。保存済みのキーを削除するには、フィールドの下にある Clear the saved key on save にチェックを入れて Save をクリックします。

決済方法

Offered methods：顧客が選択できる決済方法です。既定値：クレジットカード。これらの方法は、Vindi アカウントでも有効にしておく必要があります。

Boleto、PIX、BolePix には、チェックアウトで入力を求められる顧客の CPF または CNPJ が必要です。

決済通知（Webhook）

Webhook は、請求書が支払い済み、キャンセル、拒否、または返金されたことをストアに通知します。このセクションの Webhook URL フィールドに URL が表示されます。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=... のような形式で、OpenCart 4 では https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=... のような形式です。URL は、OpenCart をインストールしたストアのアドレスから作成され、拡張機能が生成した秘密トークンを含みます。設定に表示されたとおりに、そのままコピーしてください。Vindi で、本番アカウントとサンドボックスアカウントの両方について Settings > Webhooks に移動し、この URL を追加して、次のイベントを選択します：

Vindi は通知に署名しないため、トークンが欠けているか誤っているリクエストは拒否されます。また、各通知は、注文が変更される前に、拡張機能が Vindi API を通じて請求書を再読み込みするきっかけになるだけです。この URL は、ストアがメンテナンスモードの間も機能します（OpenCart 4 では、拡張機能のスタートアップアクションにより、Webhook と決済ステータスページがメンテナンスモード中も通過できます）。Vindi の請求書には戻り先の URL がないため、Webhook がない場合、カード決済は、顧客が同じカートで注文を再確認したときにのみ検出されます（その時点で支払い済みの請求書が見つかります）。boleto や PIX の決済は、顧客がアカウントで注文を再度開いたときに検出されます（My Account > Order History）。

注文

OpenCart は、Confirm Order の手順で、ステータスのない注文（欠落注文）を作成します。注文にステータスが付くのは、Vindi が請求書を報告した後だけです。請求書は常に Vindi から再読み込みされます。boleto、PIX、BolePix の注文は、請求書が発行された時点で待機ステータスになります。以下の各フィールドには、OpenCart の注文ステータスが一覧表示されます。OpenCart には保留（On Hold）ステータスがないため、待機ステータスと保留ステータスは既定では Pending を使用します。注文のメモで両者を区別できます。独自のステータスは System > Localisation > Order Statuses で作成し、ここで選択できます。

Order Status After Payment：検証済みの Vindi 決済の後に設定されます。既定値：処理中。

Awaiting Vindi Payment Status：チェックアウトで boleto、PIX、または BolePix が発行されました。Vindi が後で入金を確認します。決済データは、顧客に表示される履歴コメントに追加されます。既定値：Pending。

Vindi Payment On Hold Status：請求書が Vindi で確認中、支払われた請求書が注文と一致しない（通貨、金額、請求書コード、Vindi の顧客）、または注文がキャンセルされた後に支払われた場合です。メモに理由が表示されます。既定値：Pending。

Payment Error Status：Vindi が、待機中の注文の決済の試行を拒否しました。顧客は同じ請求書を引き続き支払えます。後の決済では、支払い後のステータスが設定されます。既定値：Failed。

Canceled Status：待機中の注文の請求書が Vindi でキャンセルされました。この拡張機能の注文をこのステータスに設定すると、保留中の Vindi 請求書もキャンセルされます。既定値：Canceled。

Refunded Status：注文ページから決済を全額返金した後に設定されます。既定値：Refunded。

詳細設定

Debug log：API 呼び出しと通知を、OpenCart のログフォルダ（storage/logs、OpenCart 4 では system/storage/logs）にある wc_vdi_debug.log.php に記録します。このファイルはウェブから開くことはできません。この設定がオフでも、エラーと警告は常に記録されます。キー、Webhook トークン、顧客データは記録されません。既定値：オフ。

Log：ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にできます。

Delete data on uninstall：オンにすると、拡張機能をアンインストールした際に、設定、Webhook トークン、商品キャッシュ、ログが削除されます。注文と、注文の Vindi 請求書の参照情報は保持されます。既定値：オフ。

インポート / エクスポート

Export：Download JSON で、設定を JSON ファイルとして保存します。API キーはエクスポートされません。

Import：以前にエクスポートした JSON を貼り付け、Import をクリックして設定を復元します。保存済みの API キーは維持されます。

チェックアウト

Payment Method の手順で、顧客は決済方法を選択します（既定では Vindi）。Confirm Order の手順で、顧客にはあなたの説明文が表示されます。複数の方法が提示されている場合、決済ボックスには Pay with と、クレジットカード、boleto、PIX、BolePix からの選択肢が表示されます。boleto、PIX、または BolePix が提示されている場合、ボックスには CPF or CNPJ フィールドも表示されます。クレジットカードが提示されていない場合は必須で、それ以外の場合は Required for boleto and PIX. と表示されます。顧客のカスタムフィールド、または CPF もしくは CNPJ という名前の住所に有効な番号が入っている場合は、そこから自動入力されます。番号はチェックディジットで確認されます。不足している項目があると、顧客には Please choose how you want to pay with Vindi.、Please enter a valid CPF or CNPJ.、または Please enter your CPF or CNPJ — it is required for boleto and PIX. が表示されます。OpenCart 4 では、顧客は決済方法ブロックの Choose ボタンから、Payment method options のウィンドウで決済方法を選択します。これらのフィールドと Confirm Order ボタンを含む決済ボックスは、チェックアウトページの下部にあります。

顧客が Confirm Order をクリックすると、拡張機能は、支払い住所からこのカートの Vindi 顧客を作成し、注文合計に対する Vindi の請求書を 1 回分の支払いとして作成します。Vindi では、請求書は Order # と OpenCart の注文番号で呼ばれます。

クレジットカード：顧客は Vindi の請求書ページに移動し、そこで支払います。注文はステータスなしのままです。Vindi の請求書には戻り先 URL がないため、顧客は自動的にストアに戻されません。注文は、Vindi が Webhook で決済を確認したときにステータスを取得します。顧客が同じカートで注文を再確認し、請求書がすでに支払い済みである場合、支払い済みの注文が確認され、顧客には成功ページが表示されます。

boleto、PIX、BolePix：請求書は直ちに発行され、注文は待機ステータスになり、顧客は OpenCart の注文成功ページに移動します。そのページと、顧客アカウントの注文詳細には、Payment セクションが表示されます。このセクションには、PIX の QR コード、Copy code ボタン付きの PIX のコピー＆ペースト用コードとその有効期限、そして Open boleto ボタンが表示されます。注文メールと顧客の注文履歴には、PIX コードと boleto のリンクが含まれます。Vindi が boleto または PIX のデータを返さない場合、請求書はキャンセルされ、顧客にはエラーが表示されます。

注文は、Vindi が確認した後にのみ支払い済みとしてマークされます。拡張機能は Vindi API から請求書を読み込み、通貨、請求書が注文に属していること（請求書コードと Vindi の顧客）、そして支払われた金額が注文合計と等しいことを確認します。成功ページと顧客アカウントの注文ページは、待機中の注文を API で再確認します（最大でも 15 秒に 1 回）。決済を受け取ると、成功ページには Your payment with Vindi has been received. と表示されます。決済がまだ確認されていない間は、We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. と表示されます。キャンセルされた注文の場合は、This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid. と表示されます。

決済が確認されていない間は、成功ページと顧客アカウントの注文ページ（待機中または保留中の注文の場合）にも Check payment status ボタンが表示されます。このボタンは、注文の最新の Vindi 請求書を確認します。確認済みまたは待機中の注文は、決済データとともに成功ページに戻ります。請求書がまだ未払いの場合、Payment セクションには Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. と表示され、Pay at Vindi、Check again、Back to checkout のボタンが表示されます。

OpenCart 3 は Confirm Order の手順が表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を更新するため、拡張機能はカートごとに 1 回だけ決済します。同じカートの別の注文がすでに支払い済み、boleto や PIX の支払いを待っている、または保留中である場合、顧客は成功ページに移動し、新しい請求書は発行されません。同じ注文に対する新しい試行は、決済方法、金額、環境が同じであれば、保留中の Vindi 請求書を再利用します。そうでない場合は、新しい請求書が作成される前に、以前の請求書が Vindi でキャンセルされるため、顧客が同じカートを 2 回支払うことはありません。数量の変更を含め、カートを変更すると新しいカートとして扱われ、独自の決済が必要になります。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。カード決済が拒否された後や請求書がキャンセルされた後も、顧客は同じ注文を再度支払います。その間に決済なしで注文が閉じられた場合、顧客はチェックアウトに戻され、次の Confirm Order で新しい注文が支払われます。キャンセルされた注文には This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid. が、失敗した注文には Your Vindi payment attempt was rejected. You can try again below. が表示されます。OpenCart 4 では、チェックアウトに戻る Payment ステータスページのメッセージが、チェックアウトページの上部に表示されます。

Vindi が決済を開始できない場合、顧客は Confirm Order の手順にとどまり、ボタンの上に短いメッセージが表示されます。たとえば、CPF / CNPJ、請求先住所（boleto では番地、郵便番号、市区町村、都道府県が必須です）、メールアドレス、電話番号を確認するように、または Vindi が一時的に利用できないことを知らせるメッセージです。技術的な理由はログに書き込まれます。

この拡張機能は、1 回払いの単発決済のみに対応しています。サブスクリプションや定期請求、保存されたカード、分割払い、ストア上のカードフォームには対応していません。カードは常に Vindi のページで入力されます。番地と町名は OpenCart の住所の一部ではないため、Vindi には送信されません。

注文と返金

注文ステータス

ステータスなし（欠落注文）：カード決済が開始されましたが、Vindi はまだ確認していません。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合のみ表示されます。OpenCart 4.1 では、このような注文に Voided ステータスが付く場合もあります。これは、Confirm Order の手順が再度表示されたときに OpenCart が設定します。拡張機能はこれもステータスのない注文として扱います。

Awaiting Vindi Payment Status（既定値 Pending）：boleto、PIX、または BolePix の支払いを待っています。Vindi が請求書の支払い済みを報告すると、注文は Order Status After Payment に移ります。

Order Status After Payment（既定値 Processing）：決済が確認されました。注文は、通常の OpenCart の方法でステータスを取得し、通常の注文メールが送信され、在庫が更新されます。メモには、Vindi の請求書、金額、環境が表示されます。

Vindi Payment On Hold Status（既定値 Pending）：Vindi の請求書が確認中か、支払われた請求書が注文と一致しない（通貨、金額、請求書コード、Vindi の顧客）、または注文がキャンセルされた後に請求書が支払われました。メモに説明が表示されます。注文と在庫を確認してから、注文を完了するか、決済を返金してください。

Payment Error Status（既定値 Failed）：Vindi が、待機中の注文の決済の試行を拒否しました。利用可能な場合、メモにはアクワイアラから届いた理由が表示されます。顧客は同じ請求書を引き続き支払えます。後の決済では、注文が Order Status After Payment に移ります。

Canceled Status（既定値 Canceled）：待機中の注文の請求書が Vindi でキャンセルされました。OpenCart で注文をこのステータスに設定すると、保留中の Vindi 請求書もキャンセルされるため、支払うことはできなくなります。それができない場合、Vindi のダッシュボードで請求書をキャンセルするようメモで求められます。

Refunded Status（既定値 Refunded）：この拡張機能を通じて決済が全額返金されました。

すでに支払い済みの注文、または支払い済みのカート内の別の注文に対して 2 つ目の請求書が支払われた場合、注文は変更されません。支払い済みの注文に付くメモでは、Vindi で 1 件の決済を返金するよう求められます。メモは、顧客に表示されない注文の History のエントリです。

VibeFox Vindi Gateway タブ

Sales > Orders で、Vindi で支払われた注文を開きます。注文ページの下部、History と Additional の横にある VibeFox Vindi Gateway タブには、Vindi bill、Charge、環境（サンドボックスの決済には Sandbox のバッジ付き）、Payment method、Status、Paid / refunded の金額、返金フォーム、返金履歴、Bills of this cart のすべて、そして注文の Vindi notes が表示されます。このタブは、拡張機能へのアクセス権を持つユーザーに表示されます。

返金

VibeFox Vindi Gateway タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて Reason (optional) を入力し、Refund via Vindi をクリックします。Refund this amount through Vindi? This cannot be undone. の確認に応答してください。カードと PIX の決済に対する全額返金と一部返金に対応しています。拡張機能を変更する権限が必要です（System > Users > User Groups で設定）。返金額は、Vindi が実際に請求した金額に制限されるため、金額に不一致があった場合は、注文合計ではなく、顧客が支払った金額まで返金できます。返金は決済の環境（本番またはサンドボックス）で送信されるため、その環境の API キーが設定されている必要があります。

全額返金を行うと、Vindi でも請求書がキャンセルされ、注文は Refunded Status に設定されます。その際、顧客に通知されず、商品も在庫に戻されません（手動でのステータス変更と同様）。一部返金ではステータスは変わりません。成功した返金は、Vindi の請求と、そのステータスとともに返金履歴とメモに追加されます。Vindi またはアクワイアラが返金を拒否した場合、タブにはエラーが表示され、返金は記録されません。返金は、Vindi が請求書の支払い済みを報告した後に利用可能になります。

Vindi では boleto の決済を返金できません。タブには Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually. と表示されます。

Sales > Returns での商品返品では、Vindi を通じて返金されることはありません。Vindi のダッシュボードで行われた返金は、charge_refunded の Webhook によって届き、メモに追加されます。注文ステータスは自動的には変わりません。必要に応じて手動で更新してください。

ライセンスキー

この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Vindi Gateway は、Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit ページで設定の上にある最初のブロックです。キーを License key に入力し、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（たとえばライセンスの有効期限日とドメイン）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: opencart-payment-vindi の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーだけです。ブロックのテキストは管理画面の言語に従います（英語とロシア語を含みます）。

キーが受け付けられない場合、ブロックにその理由が表示されます。たとえば Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on です。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後に、Check now をクリックします。ライセンスサーバーに接続できない場合、拡張機能は最後に確認されたステータスで動作を続けます。

1 つのキーは 1 つのドメインで使用できます：OpenCart の設定にあるストアのアドレスです。ストアからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで顧客に Vindi は表示されません。決済が開始された場合、顧客には This payment method is not available. Please choose another one. と表示されます。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアで決済方法が (unlicensed — visible to admins only) の印付きで引き続き表示されるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合、決済方法は全員に対して非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると 7 日間非表示になります。既存の注文には影響しません。作成済みの請求書は引き続き Vindi の Webhook によって確認され、返金も機能します。

ライセンスの有効期限が切れても、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスは自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは必ず削除されます。

トラブルシューティング

Vindi がチェックアウトに表示されない：ライセンスが有効であること、Enable / Disable がオンであること、顧客が BRL で支払っていること、Offered methods で少なくとも 1 つの方法が選択されていること、現在のモードに API キーがあることを確認してください。サンドボックスモードでは Sandbox API key、本番モードでは Live API key です。キーがない場合、またはストアの通貨が BRL でない場合、設定ページに警告が表示されます。また、支払い住所が選択した Geo Zone に含まれており、注文が設定の Total に達していることも確認してください。

決済は完了したが、注文がステータスなし、または待機ステータスのまま：Webhook が機能していません。Vindi で、使用しているアカウント（本番またはサンドボックス）に Webhook が存在すること、その URL が設定に表示されたもの（トークンを含む）と完全に一致すること、そして 4 つのイベントすべてが選択されていることを確認してください。

Webhook が Forbidden を返す：URL のトークンが欠けているか誤っています。設定から URL を再度コピーしてください。

Webhook が Verification failed, retry later を返す：API 経由で請求書を読み込めませんでした（たとえば、その環境の API キーが削除された）、同じ時刻に別のリクエストによってカートが更新されていた、または注文ステータスを設定できなかった、のいずれかです。Vindi は通知を再送します。ログに理由が表示されます。

ブラウザで Webhook URL に Method not allowed と表示される：これは正常です。この URL は Vindi からのリクエストのみを受け付けます。

顧客に This payment method is temporarily unavailable と表示される：Vindi が API キーを拒否しました。現在のモードのキーを確認してください。

顧客が Confirm Order の後にエラーを見る：拡張機能ページの Log フィールドを確認してください。Debug log がオフの場合でも、エラーは記録されます。boleto の場合、請求先住所には番地、郵便番号、市区町村、都道府県が必要です。

注文が保留ステータスになっている：VibeFox Vindi Gateway タブのメモを確認してください（注文ステータスを参照）。その後、注文を処理するか、決済を返金してください。

本番環境に切り替えた後の古いサンドボックス注文：各決済は、請求書の環境を保持します。サンドボックスの注文の確認、キャンセル、返金は、サンドボックスのキーが設定に残っている限り、そのキーを使用し続けます。

返金に失敗する：メッセージを確認してください。boleto の決済は Vindi を通じて返金できず、決済の環境の API キーが設定されている必要があります。拡張機能を変更する権限がない場合、タブには You do not have permission to refund orders (modify this extension). と表示されます。

開発者向け：Vindi の顧客と請求書が作成される前に、拡張機能は、リクエストデータと注文を伴う OpenCart イベント wc_vdi_customer_request と wc_vdi_bill_request を発行します。

アンインストール

Extensions > Extensions に移動し、タイプ Payments を選択して、VibeFox Vindi Gateway の横にある Uninstall（赤色の − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します：Enable / Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータス（再インストール時には既定値に戻ります）。拡張機能の OpenCart イベントも削除されます。Delete data on uninstall がオンの場合、その他の設定（タイトル、説明、サンドボックスモード、API キー、決済方法、ログ記録）、Webhook トークン、商品キャッシュ、ログが削除されます。オフの場合は、後で再インストールする際のために保持されます。注文の Vindi 請求書と返金は常に保持されるため、再インストール後も、以前に支払われた注文を返金できます。既存の注文は、決済のメモを保持します。

OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧にある VibeFox Vindi Gateway の横の Uninstall（オレンジ色の − ボタン）をクリックして、次にアップロードしたパッケージを削除するため Delete（赤いごみ箱ボタン）をクリックします。

Vindi は、その所有者の商標です。この拡張機能は、Vindi と提携しておらず、Vindi による推奨も受けていません。