VibeFox Iugu for OpenCart — ヘルプ

要件

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

PHP: 8.0 以降。

通貨: ブラジル・レアル（BRL）。Iugu は BRL でのみ請求するため、ストアの System > Localisation > Currencies に BRL 通貨が必要です。お客様のチェックアウト通貨が別の通貨の場合、または合計金額が R$ 1,00（Iugu の最低金額）未満の場合、この支払い方法は表示されません。

Iugu アカウント: Iugu ダッシュボードから API トークンを 2 つ用意する必要があります。1 つは "Test" タイプ、もう 1 つは "Live" タイプです（Configuration を参照）。Iugu は両方に同じ API アドレスを使用し、トークンによって請求書がテスト用か本番用かが決まります。Iugu で Webhook を設定する必要はありません。

CPF/CNPJ（任意）: OpenCart には独自の CPF フィールドがありません。名前に CPF または CNPJ を含む顧客またはアドレスのカスタムフィールドを追加すると（Customers > Custom Fields）、その値が Iugu に渡されます。

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

インストール

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

OpenCart 3

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

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

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

4. テスト用と本番用の API トークンを入力し（Configuration を参照）、Test mode はオンのまま、Enable / Disable をオンにして Save をクリックします。

5. BRL でテスト注文を行い、Iugu のテスト決済で Iugu のページから支払います。準備ができたら Test mode をオフにします。

OpenCart 4

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

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

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

4. ライセンスキーと API トークンを、OpenCart 3 の手順 3 から 5 と同じように入力します。設定ページとそのフィールドは両方のバージョンで同じです。異なるのは通知 URL だけです（支払い通知を参照）。

新規インストールでは、支払い方法はオフ、テストモードはオンの状態で始まります。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit。セクションは左側に一覧表示され、一覧の下にある Save ボタンでページ全体が保存されます。設定の上には、ページに TEST MODE（請求書はテスト用 API トークンで作成され、実際の請求は行われません）または LIVE が表示されます。有効なモードのトークンが未入力の場合（この場合、チェックアウトで支払い方法が非表示になります）や、ストアの既定の通貨が BRL でない場合（この場合、他の通貨では Iugu が提供されません）には警告が表示されます。拡張機能を変更する権限がない場合、ページは設定を表示しますが保存はできません。

保存時には、Title は空にできず、128 文字を超えてはならず、Sort Order は整数である必要があり、Total は 0 以上の数値である必要があり、選択した Geo Zone と注文ステータスが存在している必要があります。条件を満たさない場合は何も保存されず、エラーに該当する項目が表示されます。

Iugu

Enable / Disable: Enable Iugu payments で支払い方法のオン／オフを切り替えます。既定値：オフ。

Title: チェックアウト時にお客様に表示される支払い方法の名前です。注文に保存される支払い方法名にもなります。既定値：Iugu。必須、最大 128 文字。

Description: Confirm Order ステップで、確認ボタンの上にお客様に表示されるテキストです。既定値：Iugu で安全にお支払いいただけます。お支払いを完了するために移動します。

Sort Order: チェックアウトの支払い方法の中で Iugu が表示される位置です。空欄のままにするか、整数を入力してください。

Geo Zone: 選択した Geo Zone の支払い先住所に対してのみ Iugu を提供します。既定値：All zones。Geo Zone は System > Localisation > Geo Zones で設定します。

Total: Iugu を提供するために注文が達している必要がある、ストアの既定通貨でのチェックアウト合計金額です。空欄にすると、どの金額でも Iugu を提供します。Iugu 自体は最低 R$ 1,00 を必要とします。

API 認証情報

Iugu Alia で API トークンを作成します（このセクションからそこへのリンクがあります）：Settings > API integration > New。"Test" タイプのトークンと "Live" タイプのトークンをそれぞれ 1 つずつ作成してください。

Test mode: テスト用 API トークンを使用するため、実際の請求は行われません。既定値：オン。テストモードがオンの間、お客様には Confirm Order ステップの説明の上に SANDBOX — Test mode enabled. No real charges. と表示されます。注文のステータス確認と返金は、常にその請求書が作成されたモードのトークンを使用するため、モードを切り替えても古い注文には影響しません。

Test API token: "Test" タイプの Iugu API トークンです。テストモードがオンの間に使用されます。

Live API token: "Live" タイプ（本番用）の Iugu API トークンです。テストモードがオフのときに使用されます。機密情報として管理してください。

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

支払い通知

Notification URL: すべての請求書で、ステータスの変更をこのストアの URL に報告するよう Iugu に指示します。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook、OpenCart 4 では https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook のような形式です。インターネットから到達可能である必要があります。Iugu 側で設定する必要はありません。同じ URL を指すアカウント全体の追加トリガーがあっても問題ありません。通知にはストアが信頼する支払いデータは含まれていません。注文が変更される前に、請求書は必ず Iugu API から（ステータス、金額、通貨を）読み直されます。

拡張機能は、このセクションに記載されている Iugu イベントに反応します：invoice.status_changed、invoice.refund、invoice.released、invoice.dunning_action、invoices。それぞれについて請求書を読み取り、そのステータスに応じて処理します：

paid: 金額と通貨の確認後、注文に Order Status After Payment が設定されます。

authorized または in_analysis: カード決済はキャプチャを待っているか、審査中です。注文には Iugu Payment On Hold Status が設定されます。

partially_paid: 請求書は一部のみ支払われています。注文には Iugu Payment On Hold Status が設定されます。

pending: 通知では注文は変更されません。お客様が発行済みの boleto または PIX を持って戻ってきた場合にのみ、注文に Awaiting Iugu Payment Status が設定されます。

expired: 請求書は支払われずに期限切れになりました。支払い待ちの注文には Invoice Expired Status が設定されます。

canceled: 請求書はキャンセルされました。支払い待ちの注文には Invoice Canceled Status が設定されます。

refunded: 請求書は Iugu で返金されました。注文には Refunded Status が設定されます。

chargeback: カード保有者が支払いに異議を申し立てました。支払い済みの注文には Iugu Payment On Hold Status が設定されます。

まだステータスのない注文の請求書が期限切れまたはキャンセルされた場合、その注文はステータスなしのままになり、お客様は再度支払うことができます。その他のイベントや、ストアが作成していない請求書には HTTP 200 で応答し、Iugu へのリクエストは行わずに無視されます。通知がない場合、請求書はお客様が Iugu のページからストアに戻ったときにのみ確認されます。

注文

OpenCart は Confirm Order ステップで注文を作成しますが、この時点ではステータスはありません（欠落注文）。注文がステータスを受け取るのは、Iugu が通知によって、またはお客様の戻り時に請求書を報告した後だけです。請求書は常に Iugu から読み取られます。以下の各フィールドには、お使いの OpenCart 注文ステータスが一覧表示されます。

Order Status After Payment: Iugu で検証された支払い後に設定されます。既定値：処理中。

Awaiting Iugu Payment Status: お客様は発行済みの boleto または PIX を持って Iugu のページから戻りました。Iugu は後で入金を確認します。既定値：保留中。

Iugu Payment On Hold Status: カード決済が承認済みだがキャプチャされていない、支払いが審査中、一部のみ支払われた、チャージバック、注文と金額または通貨が異なる、または注文のキャンセル後に支払いが届いた場合です。メモに理由が記載されます。手動で確認してください。既定値：OpenCart には「保留」ステータスがないため、保留中。独自のステータスは System > Localisation > Order Statuses で作成し、ここで選択できます。

Invoice Expired Status: 支払い待ちの注文の請求書が、支払われずに期限切れになりました。その後 Iugu が支払い済みと報告した場合、注文は支払い後のステータスを受け取ります。既定値：失敗。

Invoice Canceled Status: 支払い待ちの注文の請求書が Iugu でキャンセルされました。既定値：キャンセル済み。

Refunded Status: 注文ページまたは Iugu ダッシュボードから支払いが全額返金された後に設定されます。既定値：返金済み。

詳細設定

Debug log: API リクエストと通知を、OpenCart のログフォルダ（storage/logs）にある wc_igu_debug.log.php に書き込みます。このファイルは Web から開くことはできません。トークンとお客様のデータ（メール、電話番号、CPF）は一切記録されません。エラーと警告は、スイッチがオフでも常に書き込まれます。既定値：オフ。

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

Delete data on uninstall: オンにすると、拡張機能をアンインストールしたときにゲートウェイの設定とログが削除されます。注文、Iugu の請求書参照、返金は常に保持されるため、再インストール後も古い注文は引き続き機能します。既定値：オフ。

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

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

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

チェックアウト

Payment Method ステップで、お客様は支払い方法を選択します（既定では Iugu）。Confirm Order ステップでは、お客様にあなたの説明と、You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. という注記が表示されます。OpenCart はこのステップで、まだステータスのない注文を作成します。お客様が Confirm Order をクリックすると、拡張機能は注文合計額に対して BRL で、支払期限 3 日の Iugu 請求書を作成し、お客様を Iugu の請求書ページに移動させます。有効なメールアドレスが必要です。請求書には Order # と注文番号が表示されます。そこでお客様は、Iugu アカウントで有効になっている方法（クレジットカード、boleto、PIX）で支払います。お客様の名前とメールアドレスは Iugu に渡されます。また、名前に CPF または CNPJ を含むカスタムフィールドの値が 11 桁または 14 桁の場合は、その CPF/CNPJ も渡されます。電話番号と住所は Iugu が受け付ける形式でのみ送信されます（ブラジルの電話番号、8 桁の CEP を含むブラジルの住所。番地は s/n として送信されます）。

OpenCart 4 では、お客様は支払い方法ブロックの Choose ボタンで、Payment method options ウィンドウから支払い方法を選択し、チェックアウトページ下部の Confirm Order をクリックします。既定では、OpenCart 4 は支払い先住所を尋ねません。その場合、拡張機能は配送先住所と CPF/CNPJ のカスタムフィールドを使用します。

支払いが完了すると、お客様はストアに戻ります。注文は、Iugu が確認した後にのみ支払い済みとしてマークされます。請求書は、お客様が戻ったときと、Iugu が通知を送ったときに Iugu API から読み取られます。その後、注文は OpenCart の標準的な方法でステータスを受け取り、通常の注文メールと在庫の更新が行われ、お客様には OpenCart の注文完了ページが表示されます。

お客様が boleto または PIX のコードを生成し、支払う前に戻ってきた場合、注文には Awaiting Iugu Payment Status が設定され、完了ページには Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. と表示されます。Iugu が入金を報告すると（通知によるか、お客様が戻りリンクを再度開いたとき）、注文は支払い済みのステータスに移ります。保留中の注文の場合、完了ページには We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. と表示されます。お客様が戻ったときに Iugu に接続できなかった場合、または Iugu がまだ支払いを報告していない場合は、同じ文言が表示された Payment confirmation ページが開き、Check again と Back to checkout のボタンが表示されます。

請求書がキャンセルされた、または期限切れになった場合、お客様は The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. というメッセージとともにチェックアウトに戻ります。注文が Iugu の請求書のキャンセルにより取り消された場合、メッセージは Your order was cancelled because its Iugu invoice was canceled. です。カートがすでに空の場合（boleto または PIX の注文が、請求書の期限切れの前に完了ページに到達していた場合）、お客様には代わりに Payment confirmation ページが表示され、The Iugu invoice of order #... was not paid (it was canceled or has expired), so the order will not be shipped. To buy these items, please place a new order.（またはキャンセルのメッセージ）と Continue ボタンが表示されます。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。OpenCart 3 は Confirm Order ステップが表示されるたびに新しい注文を作成します。OpenCart 4 はチェックアウトの注文を更新するため、期限切れまたはキャンセルされた請求書の後、お客様は同じ注文を新しい請求書で支払います。1 つのカートに対する支払いは 1 回だけです。新しい請求書を作成する前に、拡張機能はカートの以前の請求書を確認します。いずれかが支払い済みであれば、その支払いが適用され、お客様は完了ページに進みます。同じ注文で、同じ金額とモードの未払い請求書がまだある場合は、お客様はその請求書に戻されます。その他の未払い請求書は Iugu でキャンセルされます。古い請求書が支払われた場合でも支払いは照合され、支払い済みカートへの二重支払いはメモでフラグが立てられます。カートの変更（数量の変更を含む）は、独自の支払いを必要とする新しいカートとして扱われます。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その注文がその間に閉じられていた場合（たとえば boleto の期限切れや、ストアによるキャンセル）、お客様は The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. と表示されるチェックアウトに戻されます。支払い済みの後に閉じられていた場合は、This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. と表示されます。注文がすでに確定していて、カートに新しい購入が含まれている場合、Confirm Order はチェックアウトページを再読み込みします。どの場合も、次の Confirm Order でカートの新しい注文が支払われます。

Iugu が請求書を作成できない場合、お客様は Confirm Order ステップに留まり、Iugu could not create the invoice: に続けて理由と請求先情報の確認を促す文言、または Could not connect to Iugu. Please try again in a moment. などの短いメッセージが表示されます。技術的な理由はログに記録されます。

ストアがメンテナンスモードの間も、通知 URL は機能します。OpenCart 3 は支払い拡張機能のリクエストを通過させ、OpenCart 4 では、拡張機能が通知とお客様の戻りを通過させるスタートアップアクションを追加します。

この拡張機能は一括払いのみに対応しています。サイト内のカードフォーム、保存済みカード、サブスクリプションや定期請求、carnê（分割払い手帳）、分割払い、分割払いの設定はありません。分割払いには Iugu ページの設定を使用してください。Iugu ページで提供される支払い方法は、拡張機能の設定では選択できません。Iugu アカウントで有効なすべての方法が提供されます。

注文と返金

注文ステータス

ステータスなし（欠落注文）: お客様は Iugu に移動しましたが、まだ支払っていない、請求書が期限切れまたはキャンセルされた、あるいは Iugu がまだ支払いを確認していない状態です。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。

Order Status After Payment（既定値処理中）: Iugu が支払いを確認しました。メモには請求書 ID と支払い方法（クレジットカード、boleto、PIX）が表示されます。

Awaiting Iugu Payment Status（既定値保留中）: お客様は発行済みの boleto または PIX を持って戻ってきました。Iugu が支払いを報告すると、注文は支払い済みのステータスに移ります。

Iugu Payment On Hold Status（既定値保留中）: カード決済は承認済みですがまだキャプチャされていません（Iugu でキャプチャしてください。Iugu が請求書の支払い済みを報告すると注文は完了します）。支払いは審査中です、請求書は一部のみ支払われました、チャージバックが申し立てられました、Iugu が注文と異なる金額または通貨を報告しました、または注文のキャンセル後に支払いが届きました。メモにその理由が記載されます。注文を確認し、対応するか、支払いを返金してください。

Invoice Expired Status（既定値失敗）: 支払い待ちの注文の請求書が、支払われずに期限切れになりました。その後 Iugu が請求書を支払い済みと報告した場合、注文は支払い済みのステータスに移ります。

Invoice Canceled Status（既定値キャンセル済み）: 支払い待ちの注文の請求書が Iugu でキャンセルされました。

Refunded Status（既定値返金済み）: 支払いが、拡張機能を通じて、または Iugu ダッシュボードで全額返金されました。

同じ注文またはカートの別の請求書も支払い済みの場合、注文は変更されません。メモは、重複した支払いを Iugu で返金するよう求めます。メモは注文の History に記録される項目で、お客様には表示されません。支払い待ちの注文が後で支払い済みになった場合、期限切れになった場合、またはキャンセルされた場合、OpenCart は新しいステータスをお客様に通知します。

VibeFox Iugu Gateway タブ

Sales > Orders で、Iugu で支払われた注文を開きます。注文ページの下部、History と Additional の隣に表示される VibeFox Iugu Gateway タブには、Iugu invoice の ID（Iugu の請求書へのリンク付き）、テスト用請求書であることを示す Test mode ラベル、Payment method、Status、Paid / refunded の金額、返金フォーム、返金履歴、そして注文の Iugu notes が表示されます。このタブは、拡張機能へのアクセス権を持つユーザーに表示されます。

返金

VibeFox Iugu Gateway タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて Reason (optional) を入力し、Refund via Iugu をクリックします。Refund this amount through Iugu? This cannot be undone. の確認に応じてください。拡張機能を変更する権限（System > Users > User Groups で設定）が必要です。返金は請求書が作成されたモードのトークンで送信されるため、そのトークンが設定されている必要があります。

クレジットカード: 全額または一部の返金が可能です。

PIX: 全額返金のみ可能です。

Boleto: Iugu を通じて返金することはできません。銀行振込でお客様に返金し、その後で返金を手動で記録してください。

返金は、Iugu が請求書について実際に受け取った金額を基準に計算されます。そのため、金額の不一致の後は注文合計ではなく、お客様が支払った金額まで返金できます。返金できるのは支払い済みの請求書のみで、Iugu で返金可能な残額を超えることはできません。返金は、Iugu が確認して初めて完了とみなされます。Iugu が返金を拒否した場合、または確認しなかった場合、タブにエラーが表示され、返金は記録されません。返金に成功すると、請求書 ID と理由とともに返金履歴とメモに追加されます。全額返金を行うと、注文は手動によるステータス変更と同様に、お客様への通知や商品の在庫への戻しを行わずに Refunded Status に設定されます。一部返金ではステータスは変わりません。返金は、Iugu が請求書の支払い済みを報告した後に利用できます。

Sales > Returns での商品返品では、Iugu を通じて返金は行われません。

Iugu ダッシュボードで行われた全額返金は、メモ付きで注文を Refunded Status に設定します。ダッシュボードで行われた一部返金は取り込まれません。

ライセンスキー

この拡張機能は、vibefox.net から取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Iugu Gateway は、Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit の最初のブロックで、設定の上にあります。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはキーがマスクされた状態で、ステータス（例：ライセンスの有効期限日とお使いのドメイン）と、Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には Product: opencart-payment-iugu の行と、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 のアカウントで枠を解放してください。

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

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

トラブルシューティング

チェックアウトに Iugu が表示されない: ライセンスが有効であること、Enable / Disable がオンであること、有効なモードのトークンが設定されていることを確認してください。テストモードでは Test API token、ライブモードでは Live API token です。お客様のチェックアウト通貨は BRL で、合計額は少なくとも R$ 1,00 である必要があります。支払い先住所が選択された Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。トークンまたは通貨が誤っている場合、設定ページに警告が表示されます。

支払いは完了したが、注文のステータスがない: Iugu からの通知がストアに届かなかったか、確認できませんでした。Debug log をオンにし、拡張機能ページの Log フィールドを確認してください。ストアが Notification URL でインターネットから到達可能であること、請求書が作成されたモードのトークンがまだ入力されていることを確認してください。お客様が支払い後にストアに戻ったときにも請求書は確認されます。

通知の応答が verification failed: そのときに請求書を Iugu API から読み取れませんでした。ネットワークエラー、トークンの誤り、請求書のモードのトークンの欠落などが原因として考えられます。Iugu は通知を再試行します。

通知の応答が busy: カートが同時に別のリクエストで処理されていたか、注文ステータスを設定できませんでした。Iugu は通知を再試行します。ログに理由が表示されます。

通知の応答が invalid invoice id: 通知に有効な請求書 ID がありませんでした。何も変更されません。

注文が Iugu Payment On Hold Status になっている: 注文のタブの Iugu notes を確認してください。カード決済がキャプチャを待っている、支払いが審査中、一部のみ支払われた、または異議申し立てがされている、支払われた金額が注文と一致しなかった、または注文のキャンセル後に支払いが届いた、といった理由が考えられます。

お客様に "Iugu payments are not available right now" と表示される: API トークンが欠落しているか誤っています。有効なモードのトークンを確認してください。

お客様に "A valid billing email is required for Iugu" と表示される: 注文に有効なメールアドレスがありません。

お客様に "This order already has an Iugu payment that the store has to review" と表示される: 注文の以前の請求書が承認済み、審査中、または一部支払い済みです。Iugu で請求書を確認し、ログを見てください。

お客様に This payment method is not available. と表示される: チェックアウトのセッションが注文と一致しなくなったか、その間に支払い方法がオフにされました。お客様はチェックアウトを再読み込みします。

返金に失敗する: タブのメッセージを確認してください。boleto の支払いは Iugu を通じて返金できず、PIX の支払いは全額のみ返金でき、支払い済みの請求書のみ返金できます。メッセージに、支払いがテストまたはライブモードで行われ、そのモードのトークンが設定されていないと書かれている場合は、そのモードのトークンを入力してください。Iugu が返金を確認しなかった場合は、再試行する前に Iugu で請求書を確認してください。

開発者向け：請求書が作成される前に、拡張機能は OpenCart イベント wc_igu_invoice_data を、請求書リクエストと注文とともに発行します。例えば payable_with で支払い方法を制限する場合などに利用できます。

アンインストール

Extensions > Extensions に進み、タイプ Payments を選択して、VibeFox Iugu Gateway の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自体の設定を常に削除します：Enable / Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータス（再インストール時に既定値に戻ります）。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントと、メンテナンスモードで通知とお客様の戻りを通過させるスタートアップアクションも削除されます）。Delete data on uninstall がオンの場合は、残りのゲートウェイ設定（タイトル、説明、テストモード、API トークン、デバッグログのスイッチ）とログも削除されます。オフの場合は、後で再インストールする際のために保持されます。Iugu の請求書参照と返金は常に保持されるため、以前に支払われた注文は引き続き返金でき、再インストール後も遅延した通知は引き続き照合されます。既存の注文は、支払いメモを保持します。

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

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