VibeFox Comgate for WooCommerce — ヘルプ
要件
WordPress: 6.0 以降。
WooCommerce: 7.0 以降がインストールされ、有効になっていること。これがないと、プラグインは有効化できません。
PHP: 8.0 以降。
HTTPS: Comgate がバックグラウンド通知を送信できるよう、サイトはインターネットから HTTPS でアクセスできる必要があります。
通貨: CZK、EUR、PLN、HUF、USD、GBP、RON、HRK、NOK、SEK。それ以外の通貨、および Comgate の最低額を下回る合計額では、この支払い方法は非表示になります。HUF の支払いは、Comgate の要件どおり、整数のフォリントに丸められます。
Comgate アカウント: Comgate クライアントポータルで、ショップ接続の加盟店 ID とシークレット（バックグラウンド通信用のパスワード）が必要です。また、そこで通知 URL を設定する必要があります（「設定」の項を参照）。Comgate は、テストと本番の支払いで同じ加盟店 ID とシークレットを使用します。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_comgate_gateway フォルダーを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます: WooCommerce > Settings > Payments > Comgate > Manage。または、プラグインページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンス欄に VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Comgate クライアントポータルから Merchant ID と Secret を入力し、そこで通知 URL を設定します（「設定」の項を参照）。
6. Enable / Disable をオンにします。試し払いのために Test Mode をオンのままにし、その後オフにします。
設定
すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Comgate。フィールドの上には、Comgate が有効なのに加盟店 ID またはシークレットが欠けている場合（その場合、両方が入力されるまで支払い方法はチェックアウトに表示されません）と、ストアの通貨がサポートされていない場合に警告が表示されます。テストモードがオンの間は、Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live. と表示されます。
一般
Enable / Disable: Enable Comgate Payment Gateway で支払い方法をオンまたはオフにします。既定値はオフです。
Title: チェックアウトで購入者に表示される支払い方法の名前。既定値: Comgate。
Description: チェックアウトで支払い方法の下に表示される説明文。既定値: Pay securely via Comgate — cards, bank transfers, wallets and more. テストモードでは、説明文に TEST MODE: no real money is charged. が追加されます。説明文が空の場合は、これだけが表示されます。
Comgate 接続
加盟店 ID（ショップの識別子）とパスワード（シークレット）は、Comgate クライアントポータルの Integration > shop connection settings から取得します。同じ場所で、URL for passing the payment result（バックグラウンド通知）に、このセクションに表示される URL を設定します。URL は https://your-site/wc-api/comgate_payment_callback/ のような形式です。Comgate は各支払いの後にこれを呼び出します。プラグインは、注文を変更する前に Comgate のステータス API で支払いを再確認します。購入者向けの戻り URL は、各支払いとともに送信されます。ポータルで（支払い済み、キャンセル、保留中の）戻り URL も要求される場合は、このセクションに表示される 2 つ目の URL を使用してください。URL は https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId} のような形式です。
Merchant ID: Comgate の e-shop 識別子（加盟店）。
Secret: このショップ接続のバックグラウンド通信用パスワード（シークレット）。
Test Mode: Create test payments (no money is charged)。Comgate は、テストと本番の支払いで同じ加盟店 ID とシークレットを使用します。テストの支払いには test=true が付きます。返金は、常に元の支払いのモードで送信されます。既定値はオンです。
決済ページ
Payment Methods: 購入者が選べる Comgate の支払い方法。Comgate でストアに対して有効になっている方法のみが表示されます。
Language: Comgate の決済ページの言語。Automatic (site language, English as fallback)（既定値）、または 26 言語のいずれか。
注文
Order Status After Payment: Comgate が支払いを確認したときに設定される注文ステータス。ステータスは一度に設定され、2 回目のステータス変更は行われません。
詳細設定
Debug Log: Log API requests and notifications を、WooCommerce > Status > Logs のソース wcp_comgate_gateway に記録します。シークレットと個人データは決して記録されません。エラーは常に記録されます。既定値はオフです。
Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted。注文とその Comgate の取引 ID は常に残ります。既定値はオフです。
チェックアウト
購入者は支払い方法（既定では Comgate）を選び、注文を確定します。プラグインは、注文通貨で注文合計額について Comgate で支払いを作成し、購入者を Comgate の決済ページにリダイレクトします。請求先のメールアドレスと氏名は Comgate に渡され、支払いには注文番号が付けられます。有効な請求先メールアドレスが必要です。Comgate のページでは、購入者は許可された方法のいずれかで支払います。
支払い後、購入者は貴店に戻ります。注文が支払い済みになるのは、Comgate が確認した後だけです。プラグインは、バックグラウンド通知が届いたときと、購入者が戻ったときの両方で、Comgate のステータス API から支払いを取得します。たとえば銀行振込が処理中で、まだ支払いが確認されていない場合、注文受付ページには Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. と表示されます。注文が保留にされた場合、ページには Your payment is being reviewed. We will contact you if anything else is needed. と表示されます。
支払いがキャンセルされたか期限切れになった場合、購入者は The Comgate payment was cancelled or has expired. You can try again or choose another payment method. と表示されて、チェックアウト（またはカート）に戻ります。購入者は未払いの注文を再度支払うことができます（例: Pay for order ページから）。前の試行が最初に確認されるため、すでに完了した支払いに二重に請求されることはありません。また、まだ開いている場合は Comgate でキャンセルされます。古い試行の遅れた支払いでも、未払いの注文は支払い済みになります。
Comgate が支払いを開始できない場合、購入者には短いメッセージが表示されます。例: The Comgate payment could not be started. Please try again or choose another payment method.、Comgate がこの金額または通貨を受け付けられないというメッセージ、または選択した Comgate の支払い方法が利用できないというメッセージです。技術的な理由はログに書き込まれます。
この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。
本プラグインは、Comgate のページでの 1 回限りの支払いのみに対応しています。定期払い、定期購読、保存済みカードはありません。埋め込みの Comgate チェックアウト、貴店のサイト上の Apple Pay や Google Pay のボタンもありません（これらは Comgate のページで利用できます）。また、WooCommerce から事前承認をキャプチャしたりキャンセルしたりすることもできません。通知がない場合、支払いのステータスは自動では問い合わせられません。購入者が戻ったときにのみ確認されます。
注文と返金
注文ステータス
Pending payment: 購入者は Comgate に移動されましたが、まだ支払っていないか、Comgate が支払いを保留中と報告しています。注文メモには、作成された Comgate の支払いが表示されます。
Processing or Completed: Comgate が、同じ金額と通貨の支払いを PAID と報告しました。ステータスは Order Status After Payment に従います。注文の取引 ID は Comgate の取引 ID です。すべての試行は注文とともに保存されます。テストの支払いには、Comgate test payment — no money was charged. というメモが付きます。
On hold: 支払われた金額または通貨が注文と異なる場合、本番モードのストアでテストの支払いが確認された場合（お金は受け取られていません）、または支払いが事前承認されただけの場合（Comgate アカウントの事前承認）に、注文は保留になります。承認済みの支払いは、Comgate ポータルでキャプチャされると自動的に支払い済みになります。注文メモに理由が書かれています。
Cancelled: 現在の Comgate の支払いがキャンセルされたか、期限切れになりました。WooCommerce が未払いの注文をキャンセルした後に Comgate が支払いを確認した場合（例: 遅い銀行振込）、注文は支払い済みとして再度開かれ、発送前に在庫を確認するよう求めるメモが付きます。
すでに支払い済みの注文に対して、Comgate が別の PAID の支払いを報告した場合、その注文は再び変更されません。メモで、Comgate ポータルで確認し、重複分を返金するよう求められます。再送された確認によって、返金済みの注文や、支払い後にキャンセルされた注文が再び開かれることは決してありません。
返金
注文を開き、Refund をクリックして金額を入力し、Refund via Comgate をクリックします（ボタンには支払い方法のタイトルが表示されます）。全額返金と一部返金に対応しています。返金は支払い済みの Comgate の取引に対して行われ、元の支払いのモード（テストまたは本番）で送信されます。Comgate は PAID の支払いのみを、支払われた金額を上限として返金します。HUF の返金は整数のフォリントである必要があります。Comgate が返金を受け付けない場合、WooCommerce にエラーが表示され、返金は記録されません。返金が成功すると、金額、Comgate の取引、理由とともに注文メモに追加されます。
Comgate ポータルで行われた返金は、貴店に報告されません。必要な場合は、Refund via のゲートウェイ経由ではなく、WooCommerce で手動の返金を作成してください。
ライセンスキー
このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンス欄は WooCommerce > Settings > Payments > Comgate の上部にあります。キーを License key に貼り付け、Activate をクリックします。ライセンス欄には、ステータス（例: ライセンスが有効な期限の日付）とドメインが表示されます。Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのサイトからキーを削除できます。リンク Manage licenses and domains in your account から vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで Comgate は購入者に表示されません。それでも支払いが開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログインしているストア管理者には、(unlicensed — visible to admins only) と表記された支払い方法が引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。すでに開始された支払いは引き続き確認され、返金も動作します。
ライセンスの期限が切れてもプラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Comgate が表示されない: ライセンスが有効であること、Enable / Disable がオンであること、Merchant ID と Secret が入力されていること、注文通貨がサポートされていること、注文合計が Comgate の最低額（例: 1 CZK、0.10 EUR、100 HUF）を下回っていないことを確認してください。認証情報が欠けている場合、または通貨がサポートされていない場合、設定ページに警告が表示されます。
決済は完了したが、注文が Pending payment のまま: Comgate からのバックグラウンド通知が届いていません。Comgate ポータルの URL for passing the payment result を確認し、サイトがインターネットから HTTPS でアクセスできること（メンテナンスモードやパスワード保護がないこと）を確認してください。また、ログも確認してください（Debug Log をオンにします）。Comgate は届かなかった通知を再送します。プラグインは処理できなかった通知にはエラーで応答するため、再送されます。購入者が貴店に戻ったときにも、注文は確認されます。
通知の応答 Invalid merchant or secret: 設定の加盟店 ID またはシークレットが、Comgate ポータルのショップ接続と一致しません。
通知の応答 Gateway not configured: 設定の加盟店 ID またはシークレットが空です。入力されると、Comgate は再送します。
通知の応答 Order not found、Unknown transaction または Reference mismatch: その通知は、その注文のためにこのストアが作成したものではない支払いに属しています。注文は変更されません。
通知の応答 Status verification failed、Status verification rejected または Busy, retry later: Comgate のステータス API に到達できなかったか、リクエストを拒否したか、同じ時刻に別のリクエストによって注文が処理されていました。Comgate は通知を再送します。
購入者に We could not verify the Comgate payment と表示される: 戻りリンクが注文と一致しませんでした。お金が請求されていた場合でも、通知によって注文は確認されます。購入者が再度支払う前に、Comgate ポータルで支払いを確認してください。
購入者に The order total is below the minimum amount accepted by Comgate または A valid billing e-mail address is required for Comgate payments と表示される: この状態では、注文を Comgate で支払うことができません。
支払い後に注文が On hold になっている: 注文メモを読んでください。支払われた金額または通貨が異なっていた、テストの支払いが本番モードで届いた、または支払いが事前承認されただけでした。Comgate ポータルで支払いを確認し、注文を手動で完了するか返金してください。
返金が失敗する: メッセージを読んでください。Comgate rejected the refund: the amount exceeds the refundable amount. は、金額が返金可能な残額を超えていることを意味します。PAID 以外のステータスの支払いは返金できません。Comgate could not be reached. The refund was not made — please try again later. は、接続の問題を意味します。
ライセンス欄にエラーが表示される: ライセンス欄のメッセージに従ってください。例えば、キーが別のドメインですでに使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスを変更した場合は、Check now をクリックして新しいドメインでキーを有効化します。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作し続けます。
アンインストール
プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは常に削除されます。ゲートウェイの設定とログファイルは、Delete Data on Uninstall がオンだった場合にのみ削除されます。それ以外の場合は、再インストールのために残ります。注文とその Comgate のデータは常に残ります。既存の注文は、支払いメモと取引 ID を保持します。
Comgate は、それぞれの所有者の商標です。このプラグインは Comgate と提携しておらず、Comgate による推奨も受けていません。