VibeFox KOMOJU for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 でテスト済み）または 4.0.2 以降（4.1.0.3 でテスト済み）。

PHP: 8.0 以降。

KOMOJU アカウント: KOMOJU ダッシュボードで作成した Webhook のシークレットキー（本番用は sk_live_...、テストモード用は sk_test_...）と、その Webhook のシークレットトークンが必要です（設定を参照）。公開キーは不要です。KOMOJU からストアの Webhook URL に到達できる必要があります。

注文通貨: JPY、USD、EUR、TWD、KRW、PLN、GBP、HKD、SGD、NZD、AUD、IDR、MYR、PHP、THB、CNY、BRL、CHF、CAD、VND のいずれか。それ以外の通貨の注文では、支払い方法は非表示になります。

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

インストール

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

OpenCart 3

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

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

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

4. KOMOJU ダッシュボードで、Webhook URL セクションに表示されている URL とイベントを指定して Webhook を追加し、そのシークレットトークンをコピーします（設定を参照）。

5. ライブ用のシークレットキーとライブ用 Webhook シークレットトークン、およびサンドボックスモード用のテストキーを入力します。Enable/Disable をオンにして、Save をクリックします。

OpenCart 4

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

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

3. Extensions > Extensions を開き、種類で Payments を選択します。VibeFox KOMOJU Payment を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆ボタン）をクリックします。

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

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

設定

すべての設定は拡張機能のページにあります: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit。セクションは左側に一覧表示されます。一覧の下にある Save ボタンで、ページ全体を保存します。テストモードがオンの間、設定の上部には KOMOJU Sandbox Mode is enabled. が表示されます。現在のモードにシークレットキーがない場合（その場合、チェックアウトで支払い方法は非表示になります）や、Webhook シークレットトークンがない場合（その場合、KOMOJU の通知は拒否され、コンビニ払いと銀行振込は決して確認されません）には警告が表示されます。また、KOMOJU がストアの既定通貨に対応していない場合（その場合、その通貨の注文では支払い方法が非表示になります）にも警告が表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時には、Title は 128 文字以内、Sort Order は整数（負の数も可）、Total は 0 以上の数値、ジオゾーンと注文ステータスは存在するものである必要があります。これらを満たさない場合は何も保存されず、ページに該当する項目が表示されます。キーが未入力でも保存はできます。

KOMOJU 支払い

Enable/Disable: Enable KOMOJU Payment Gateway で支払い方法をオンまたはオフにします。既定値: オフ。

Title: 購入者がチェックアウトで見る支払い方法の名前です。注文にも、この名前が支払い方法として保存されます。既定値: KOMOJU Payment。空欄にすると、既定の名前が使われます。128 文字以内。

Description: Confirm Order のステップで、確認ボタンの上に購入者に表示されるテキストです。既定値: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

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

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

Total: KOMOJU を提供するために注文が達している必要がある、ストアの既定通貨でのチェックアウト合計金額です。空欄にすると、どの金額でも KOMOJU を提供します。

本番用 API キー

キーは KOMOJU ダッシュボードで確認できます（そこには各セクションへのリンクがあります）。シークレットキーは Settings > API keys に、Webhook シークレットトークンは Settings > Webhooks にあります（そこで、先に Webhook URL セクションに表示されている Webhook URL を追加してください）。

Live Secret Key: KOMOJU の本番用シークレットキーです。sk_live_ で始まります。

Live Webhook Secret Token: 本番用 Webhook のシークレットトークンです。すべての通知の署名を検証するために使われます。

テストモード

KOMOJU は、テスト決済と本番決済に同じ API アドレスを使用します。どのモードかはキーによって決まります。決済は行われたモードを保持するため、注文の返金と状態確認は、常にそのモードのキーを使用します。

Sandbox Mode: Enable test mode (use the test keys below, no real payments)。既定値: オフ。オンの間、Confirm Order のステップでは説明文の上に Test mode が表示されます。

Sandbox Secret Key: KOMOJU のテスト用シークレットキーです。sk_test_ で始まります。

Sandbox Webhook Secret Token: テストモード用 Webhook のシークレットトークンです。

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

Webhook URL

Webhook は、遅延して完了するコンビニ払いや銀行振込を含め、支払いの情報をストアに伝えます。KOMOJU ダッシュボードの Settings > Webhooks で、このセクションに表示されている URL を、本番モードとテストモードのそれぞれについて追加してください。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook、OpenCart 4 では https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook のような形式で、OpenCart のストアのフロントエンドアドレスから作られます。URL は設定に表示されたとおりに正確にコピーしてください。そのうえで、各 Webhook のシークレットトークンを Live Webhook Secret Token または Sandbox Webhook Secret Token にコピーします。

次のイベントを選択します（このセクションにも一覧があります）:

期限切れ、キャンセル、失敗のイベントは、注文の現在の支払いに対してのみ注文を変更します。そのため、以前の試行の支払いが、別の方法で支払われている注文をキャンセルすることはありません。有効な署名のない Webhook は拒否されます。どちらかのシークレットトークンで署名された Webhook は受け付けられますが、同じモードの支払いに限られます。Webhook がない場合、クレジットカード決済は購入者がストアに戻ったときに引き続き確認されますが、コンビニ払いと銀行振込は決して確認されません。

注文

OpenCart は Confirm Order のステップで、ステータスのない注文（欠落注文）を作成します。注文は、KOMOJU が支払いを確認した後にのみステータスを取得します。以下の各項目には、お使いの OpenCart 注文ステータスが一覧表示されます。

Order Status After Payment: 支払いがキャプチャされ、金額と通貨が検証されました。既定値: Processing。

Awaiting KOMOJU Payment Status: 支払いが承認されています。コンビニ払いの票または銀行振込の票が発行されたか、支払いが KOMOJU ダッシュボードでのキャプチャを待っています。既定値: Pending。

KOMOJU Payment On Hold Status: 支払われた金額または通貨が注文と異なるか、注文がキャンセルされた後に支払いが届きました。メモに理由が記されます。既定値: Pending（OpenCart には On hold ステータスがないため）。

Cancelled Payment Status: 支払い待ちの注文の支払いが期限切れになったか、キャンセルされました（例: コンビニ払いの票が期限内に支払われなかった）。既定値: Canceled。

Failed Payment Status: 支払い待ちの注文の支払いが失敗しました。既定値: Failed。

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

独自のステータス（例: Awaiting KOMOJU payment、On hold）は、System > Localisation > Order Statuses で作成し、ここで選択できます。

詳細設定

Invoice Prefix: KOMOJU に送信される注文番号の接頭辞です。KOMOJU 側の番号は、接頭辞、OpenCart の注文番号、短いランダムなサフィックスで構成されます（例: OC-123-A1B2C3）。同じ KOMOJU アカウントで複数のストアを使う場合は、ストアごとに一意の接頭辞にしてください。既定値: OC-。

Enable Logging: KOMOJU のイベントと API 呼び出しを、OpenCart のログフォルダー（storage/logs）にある komoju_p_debug.log.php に書き込みます。ファイルはウェブから開くことはできません。キーと購入者データは記録されません。エラーと警告は常に書き込まれます。既定値: オフ。

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

Delete data on uninstall: オンにすると、拡張機能のアンインストール時に、ゲートウェイ設定とログが削除されます。注文と、KOMOJU の取引および返金は常に保持されるため、再インストール後も古い注文を確認および返金できます。既定値: オフ。

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

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

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

チェックアウト

Payment Method のステップで、購入者は支払い方法を選択します（既定では KOMOJU Payment）。Confirm Order のステップでは、購入者にご自身の説明文と、You will be redirected to the KOMOJU payment page to complete the payment. という注記が表示されます。OpenCart はこのステップで注文を作成しますが、まだステータスはありません。購入者が Confirm Order をクリックすると、拡張機能は注文通貨での注文合計に対する KOMOJU の支払いセッションを作成し、購入者を KOMOJU の支払いページに移動させます。メールアドレス、氏名、支払い先住所と配送先住所、注文商品が KOMOJU に渡されます。ページは購入者の言語に応じて、日本語、英語、韓国語で表示されます（その他の言語では英語）。そこで購入者は支払い方法を選択します。提供される方法は、KOMOJU アカウントと注文通貨によって異なります。

OpenCart 4 では、購入者は支払い方法ブロックの Choose ボタンで、Payment method options ウィンドウから支払い方法を選択し、チェックアウトページ下部の Confirm Order をクリックします。既定では、OpenCart 4 は支払い先住所を尋ねません。その場合、拡張機能は配送先住所を支払い先住所として渡します。

支払い後、購入者はストアに戻ります。拡張機能は、支払いのモードのキーを使用して KOMOJU API から支払いセッションを読み取ります。注文は、KOMOJU が（署名付き Webhook により、または購入者が戻ったときのセッション読み取りによって）確認した後にのみ支払い済みとしてマークされます。その後、注文は通常の OpenCart の方法でステータスを取得し、通常の注文メールが送信され、在庫が更新されます。購入者には、Your payment with KOMOJU has been received. と表示された OpenCart の注文完了ページが表示されます。その時点で KOMOJU に接続できない場合や、支払いは確認されたがまだ反映されていない場合は、Payment confirmation ページに We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. と表示され、Check again ボタンが表示されます。

コンビニ払いと銀行振込の場合、購入者は支払い票を受け取ります。注文は Awaiting KOMOJU Payment Status を取得し、完了ページには、支払いが承認されており、KOMOJU の指示に従って（たとえばコンビニや銀行振込で）完了する必要があることが表示されます。購入者が支払い、KOMOJU が Webhook を送信すると、注文は Order Status After Payment に移ります。票の期限が切れた場合、注文は Cancelled Payment Status に移ります。

支払いが完了しなかった場合、購入者は The payment was not completed. You can try again or choose another payment method. と表示されたチェックアウトに戻ります。注文がすでにキャンセルされていた場合、メッセージは The KOMOJU payment was not completed and the order has been cancelled. です。カートは保持されます。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。新しい試行ごとに（OpenCart 3 は Confirm Order のステップが表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を更新して同じ注文を再び支払います）、この注文と同じカートの他の注文の未完了の KOMOJU セッションを確認します。この注文の合計が変わっていない未完了セッションは再利用され、他の未完了セッションは KOMOJU でキャンセルされます。その間に支払い済みになったセッションは、新しい支払いを作成する代わりに、その注文を確認します。カートの変更（数量の変更を含む）は、独自の支払いを必要とする新しいカートとして扱われます。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その注文がその間に閉じられていた場合（たとえばコンビニ払いの票が期限切れになった、支払いが失敗した、またはストアがキャンセルした場合）、購入者は Your previous order was cancelled or its payment failed. Please confirm the order again. と表示されるチェックアウトに戻されます。注文がすでに確定していて、カートに別の商品が入っている場合、メッセージは Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. です。どちらの場合も、次の Confirm Order でカートの新しい注文が支払われます。

KOMOJU が支払いを開始できない場合、購入者はボタンの上に短いメッセージが表示された Confirm Order のステップにとどまります。例: KOMOJU could not accept this payment: に続いて理由、KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us.、または Payment error: Could not connect to KOMOJU. Please try again in a moment. です。技術的な理由はログに記録されます。

ストアがメンテナンスモードにあっても Webhook は機能します。OpenCart 3 は支払い拡張機能のリクエストを通過させ、OpenCart 4 では、拡張機能が Webhook と購入者の戻りを通過させるスタートアップアクションを追加します。

この拡張機能には、ストア上のカードフォーム、保存済みカード、定期購入はありません。支払い方法を制限することもありません。支払い方法は KOMOJU のページで選択されます。手動キャプチャの操作はありません。手動キャプチャ用に承認された支払いは、KOMOJU ダッシュボードでキャプチャする必要があり、それまで注文は Awaiting KOMOJU Payment Status のままになります。

注文と返金

注文ステータス

No status (missing order): 購入者は KOMOJU に移動されたものの、まだ支払っていないか、KOMOJU がまだ支払いを確認していません。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。

Order Status After Payment (default Processing): KOMOJU が支払いを確認しました。メモには、KOMOJU の支払い ID、支払い方法、確認方法（Webhook またはリターン）が表示されます。

Awaiting KOMOJU Payment Status (default Pending): コンビニ払いまたは銀行振込の票が発行され、支払いを待っています。または、支払いが KOMOJU ダッシュボードでのキャプチャを待っています。

KOMOJU Payment On Hold Status (default Pending): KOMOJU が注文合計と異なる金額または通貨を報告したか、注文がキャンセルされた後に支払いがキャプチャされました。メモに理由が記されます。注文を確認し、対応するか支払いを返金してください。

Cancelled Payment Status (default Canceled): 支払い票の期限が切れたか、支払いがキャンセルされました。

Failed Payment Status (default Failed): 支払い待ちの注文の支払いが失敗しました。

Refunded Status (default Refunded): 支払いが全額返金されました（注文ページまたは KOMOJU ダッシュボードから）。

すでに支払い済みの注文、または支払い済みのカートの別の注文に対して 2 回目の支払いがキャプチャされた場合、その注文は変更されません。重複の場合は、KOMOJU ダッシュボードで返金するよう、メモで通知されます。返金済みの注文が再び開かれることはありません。

メモは、購入者には表示されない注文の History のエントリーです。

VibeFox KOMOJU Payment タブ

Sales > Orders で、KOMOJU で支払われた注文を開きます。注文ページの下部、History と Additional の横に、VibeFox KOMOJU Payment タブがあります。このタブには、KOMOJU の支払い ID（KOMOJU ダッシュボード内の支払いにリンク）、テスト支払い用の Test mode ラベル、支払い方法、セッション、KOMOJU 側の注文番号、ステータス、Paid / refunded の金額、返金フォーム、返金履歴（OpenCart または KOMOJU ダッシュボードから）、注文の KOMOJU notes が表示されます。このタブは、拡張機能にアクセス権があるユーザーに表示されます。

返金

VibeFox KOMOJU Payment タブで Amount（まだ返金されていない金額が自動入力されます）を入力し、必要に応じて Reason (optional) を入力して、Refund via KOMOJU をクリックします。確認の質問 Refund this amount through KOMOJU? This cannot be undone. に応答してください。全額返金と部分返金に対応しています。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。返金は KOMOJU が実際に請求した金額が上限となるため、金額の不一致が生じた後は、注文合計ではなく購入者が支払った金額まで返金できます。返金は、支払いが行われたモードのキーで送信されるため、そのモードのシークレットキーが設定されている必要があります。拡張機能はまず KOMOJU で支払いを確認し、返金可能な残額を超える返金は拒否します。KOMOJU が支払いを自動で返金できない場合（コンビニ払いなど一部の方法では購入者の銀行情報が必要です）、KOMOJU のエラーメッセージが表示され、何も記録されません。そのような返金は KOMOJU ダッシュボードで処理してください。返金は、KOMOJU が確認したときにのみ完了とみなされます。返金が成功すると、返金履歴とメモに追加されます。全額返金では、商品を在庫に戻すことなく、注文は Refunded Status に設定されます。これは手動でステータスを変更した場合と同じです。部分返金ではステータスは変わりません。KOMOJU が支払いをキャプチャした後に返金が利用可能になります。

KOMOJU が別の通貨に換算した支払い（例: EUR 注文に対する JPY でのコンビニ払い）の場合、OpenCart からは全額返金のみ可能です。部分返金は KOMOJU ダッシュボードで行ってください。

Sales > Returns での商品の返品では、KOMOJU を通じて返金されることはありません。

KOMOJU ダッシュボードで行われた返金は Webhook で届き、メモとともに返金履歴に追加されます。支払い全体が返金されると、注文は Refunded Status に設定されます。換算された支払いに対して、ダッシュボードから行われた部分返金は、注文にメモとして記録されるだけです。対応する金額を OpenCart で手動で記録してください。

ライセンスキー

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

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

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

トラブルシューティング

KOMOJU がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードにシークレットキーがあることを確認してください。サンドボックスモードでは Sandbox Secret Key、ライブモードでは Live Secret Key です。購入者は KOMOJU が対応する通貨で支払う必要があります。設定ページでは、何かが不足していると警告が表示されます。また、支払い先住所が選択された Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。

支払いは完了したが、注文にステータスが付かない: Webhook が機能していません。KOMOJU ダッシュボードで、使用しているモードの Webhook が存在すること、その URL が Webhook URL セクションに表示されたものと正確に一致すること、イベントが選択されていることを確認してください。そのシークレットトークンが対応する欄（Live Webhook Secret Token または Sandbox Webhook Secret Token）に入力されているか確認し、拡張機能のページの Log 欄を確認してください。クレジットカード決済は、購入者がストアに戻ったときにも確認されますが、コンビニ払いと銀行振込は Webhook によってのみ確認されます。

Webhook の応答が Failed to verify KOMOJU webhook signature.: シークレットトークンがないか、別の Webhook のものです。KOMOJU は通知を再試行します。

Webhook の応答が Mode mismatch, ignored.: 支払いが行われたモードとは別のモードのシークレットトークンで、Webhook が署名されています。ライブモードとテストモードで Webhook とトークンを分け、取り違えていないか確認してください。

Webhook の応答が Order not found.: その支払いはこのストアの注文に属しません。たとえば、同じ KOMOJU アカウントを使う別のストアで行われた支払いです。そのイベントは無視されます。

Webhook の応答が Order is busy, retry later. または Temporary error, retry later.: 注文が別のリクエストによって更新中だったか、そのときに支払いを処理できませんでした。KOMOJU は通知を再試行します。理由はログにあります。

Webhook URL をブラウザーで開くとエラーが表示される: これは正常です。この URL は、KOMOJU からの署名付きリクエストのみを受け付けます。

注文が保留中または未確定のステータスにある: 注文タブの KOMOJU notes を確認してください。票が支払いを待っている、支払いが KOMOJU ダッシュボードでのキャプチャを待っている、金額または通貨が一致しなかった、または注文のキャンセル後に支払いが届いた、のいずれかです。

タブに返金フォームがない: タブに理由が表示されます。KOMOJU がまだ支払いをキャプチャしていない、全額返金済みである、ユーザーグループに拡張機能を変更する権限がない、または支払いモードのシークレットキーが設定されていない、のいずれかです。

返金に失敗する: メッセージを確認してください。支払いが行われたモードのシークレットキーがない、支払いを自動で返金できない（KOMOJU ダッシュボードで返金してください）、設定されたキーでは KOMOJU が支払いを認識しない、または換算された支払いには全額返金しか使えない、のいずれかの可能性があります。

開発者向け: 拡張機能は OpenCart イベント komoju_p_supported_currencies（通貨の一覧を変更するため）と komoju_p_session_params（支払いセッション、たとえば支払い方法を変更するため）を発生させます。

アンインストール

Extensions > Extensions を開き、種類で Payments を選択して、VibeFox KOMOJU Payment の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自体の設定を常に削除します。Enable/Disable、Sort Order、Geo Zone、Total、そして Orders セクションの注文ステータスです。これらは再インストール時に既定値に戻ります。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントと、メンテナンスモードで Webhook と購入者の戻りを通過させるスタートアップアクションも削除されます）。Delete data on uninstall がオンの場合は、その他のゲートウェイ設定（タイトル、説明、キー、Webhook トークン、サンドボックスモード、インボイス接頭辞、ログ記録）とログが削除されます。オフの場合は、後で再インストールできるように保持されます。KOMOJU の取引と返金は常に保持されるため、以前の注文も再インストール後に確認と返金が可能です。既存の注文は支払いメモを保持します。

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

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