VibeFox Montonio for WooCommerce — ヘルプ
要件
WordPress: 6.0 以降。
WooCommerce: 7.0 以降、インストールされて有効になっていること。WooCommerce がない場合、プラグインは有効化できません。
PHP: 8.0 以降。
通貨: ストアまたは注文の通貨は EUR または PLN である必要があります。それ以外の通貨の場合、決済方法はチェックアウトで非表示になります。
Montonio アカウント: Montonio Partner System で確認できる、ストアのアクセスキーと秘密鍵が必要です。サンドボックスと本番のキーは別々のため、使用する環境ごとにペアが必要です。Montonio 側で他に設定することはありません。通知アドレスは決済ごとに送信されます。
公開サイト: Montonio の通知を受け取るには、サイトがインターネットからアクセス可能である必要があります。アクセスできない場合でも、購入者がストアに戻ったときに注文は確認されます。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_montonio_payment フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Payments > Montonio > Manage。または、プラグインのページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. Montonio Partner System で Stores > your store > API keys を開き、サンドボックスのアクセスキーと秘密鍵をコピーします。設定に貼り付け、Sandbox mode はオンのままにします。
6. Enable/Disable をオンにして、サンドボックスで決済をテストします。その後、本番のキーを入力し、Sandbox mode のチェックを外します。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Montonio。項目の上では、現在の環境のキーがない場合（決済方法はチェックアウトで非表示になります）や、ストアの通貨が EUR または PLN ではない場合に警告します。サンドボックスがオンの間は Sandbox mode is on: payments are simulated and no real money is charged. と表示されます。決済方法の一覧では、現在の環境の両方のキーが入力されるまで、Montonio は設定が必要な状態として表示されます。
一般
Enable/Disable: Enable Montonio bank payments で、決済方法をオンまたはオフにします。初期値: オフ。
Title: チェックアウトで購入者に表示される決済方法の名前。初期値: Bank payment (Montonio)。
Description: チェックアウトで決済方法の下に表示されるテキスト。初期値: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.
API キー
キーは Montonio Partner System の Stores > your store > API keys で取得します。サンドボックスと本番のキーは別々です。サンドボックスではサンドボックスのキーのみを使用し、本番モードでは本番のキーのみを使用します。この設定セクションには通知 URL も表示されます。形式は https://your-site/wc-api/wc_mnt_payment/ です。どこにも入力する必要はありません。プラグインが決済ごとに Montonio へ送信します。
Sandbox mode: Use the Montonio sandbox (test payments, no real money)。Montonio の API アドレスとキーペアの両方が切り替わります。初期値: オン。本番のキーを入力してから、オフにしてください。
Sandbox access key: Montonio サンドボックスにおける、ストアのアクセスキー（UUID）。
Sandbox secret key: Montonio サンドボックスにおける、ストアの秘密鍵。
Live access key: Montonio の本番環境における、ストアのアクセスキー（UUID）。
Live secret key: Montonio の本番環境における、ストアの秘密鍵。
詳細設定
Debug log: Log payment events は、すべての決済イベントを WooCommerce > Status > Logs に書き込みます。ソースは wcp_montonio_payment です。この項目がオフの場合でも、エラーは常に記録されます。キー、トークン、購入者データは決して記録されません。初期値: オフ。
Delete data: Delete the gateway settings and logs when the plugin is deleted。プラグインを無効化しても、何も削除されません。注文データ（Montonio の UUID、メモ）は常に保持されます。初期値: オフ。
決済通知
Montonio は、署名付きトークンによって各決済をストアに通知します。トークンは 2 つの方法で届きます。通知アドレスへのサーバー間通知と、購入者がストアに戻る際のリダイレクトです。どちらも検証されます。秘密鍵による署名、有効期限、アクセスキー、そしてその決済が同じ環境でこの注文のためにストアが作成したものであるかどうかを確認します。検証に合格しなかったトークンは拒否されます。各ステータスは 1 回だけ適用されるため、繰り返し届く通知によってメモ、メール、在庫の変更が重複することはありません。
チェックアウト
購入者は決済方法（初期値は Bank payment (Montonio)）を選択して注文を確定します。プラグインは注文通貨で注文合計額の Montonio 決済を作成し、購入者を Montonio の決済ページに移動させます。そこで購入者は銀行を選んで支払います。購入者の請求先国の銀行が先頭に表示されます（PLN の注文の場合はポーランド）。決済には Order と注文番号が表示されます。Montonio のページは、ストアの言語がドイツ語、英語、エストニア語、フィンランド語、リトアニア語、ラトビア語、ポーランド語、ロシア語のいずれかの場合はその言語で開き、それ以外では英語で開きます。サンドボックスモードでは、チェックアウトの説明の下に SANDBOX MODE — test payment, no real money is charged. が表示されます。
注文は、Montonio がステータス PAID と、注文の正確な金額および通貨で確認した後にのみ支払い済みになります。支払い後、購入者はストアの注文受付ページに戻ります。Montonio が支払いをまだ確認していない間、そのページには Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. と表示されます。決済がキャンセルまたは拒否された場合、購入者は Pay for order ページに戻り、次のいずれかのメッセージが表示されます。The payment was cancelled or rejected by the bank. You can try again or choose another payment method.、The payment was not completed. You can try again or choose another payment method.、Montonio could not complete the payment. Please try again or choose another payment method.
購入者は、未払いの注文を Pay for order ページから再度支払うことができます。新しい決済を作成する前に、プラグインは前回の決済について Montonio に問い合わせます。既に支払い済みの場合は注文が確認され、2 回目の決済は作成されません。
Montonio が決済を開始できない場合、購入者には Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method. などの短いメッセージが表示され、別の決済方法を選ぶことができます。Montonio のエラーは注文メモとログに追加されます。
この決済方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。
本プラグインは銀行振込決済（決済開始）のみに対応しています。カード決済、BLIK、Apple Pay または Google Pay、Pay Later や分割払い、Montonio の配送、サブスクリプション、保存済みの決済方法、貴サイト上での銀行選択には対応していません。
注文と返金
注文ステータス
支払い待ち: 購入者は Montonio に移動しましたが、まだ支払っていません。Montonio が決済を保留と報告すると、メモが追加されます。
処理中または完了: Montonio が決済を確認しました（PAID）。注文は、支払い済みの注文に対する WooCommerce の標準ステータスに従います。注文メモには、銀行、Montonio の決済 UUID、金額、環境が表示されます。トランザクション ID は Montonio の決済 UUID です。
保留中: 銀行がまだ決済を確認していません（AUTHORIZED）。Montonio が PAID を報告すると、注文は支払い済みになります。Montonio が注文合計と異なる金額または通貨を報告した場合、ストアが本番モードの間にサンドボックスの決済が届いた場合、または注文がキャンセルされた後に決済が届いた場合にも、注文は保留中になります。注文メモに理由が説明されています。Montonio Partner System で決済を確認し、注文を発送するか、決済を返金してください。
失敗: 購入者が決済を完了しなかったか、銀行が決済を拒否しました。未払いの注文の最新の決済のみが、注文を失敗させることがあります。購入者は Pay for order ページから再試行できます。
支払い済み、キャンセル済み、または返金済みの注文は、後からの通知によって再度開かれることはありません。既に支払い済みの注文に 2 回目の決済が届いた場合、注文は変更されません。メモには、Montonio Partner System で 2 回目の決済を返金するよう記載されます。
返金
注文を開き、Refund をクリックして金額を入力し、Refund via Bank payment (Montonio) をクリックします（ボタンには決済方法の名前が使われます）。Montonio で支払われた注文について、全額返金と一部返金に対応しています。返金は決済が行われた環境（サンドボックスまたは本番）に送信されるため、その環境のキーが設定されている必要があります。Montonio が返金を受け付けない場合、WooCommerce はエラーを表示し、返金は記録されません。送信された返金は、そのステータスと Montonio の返金 ID とともに注文メモに追加されます。
Montonio は後から通知によって、各返金を承認または拒否します。承認は注文メモに追加されます。Montonio が返金を拒否した場合、メモには購入者に返金されていないことが記載されます。Montonio Partner System で確認し、WooCommerce の返金を修正してください。
Montonio Partner System で行われた返金は、Montonio が報告した時点で注文メモに追加されます。WooCommerce の返金として自動的に記録されることはありません。必要に応じて、WooCommerce で手動の返金を作成してください。
ライセンスキー
このプラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Payments > Montonio の上部にあります。License key にキーを貼り付け、Activate をクリックします。ブロックにはステータス（たとえばライセンスの有効期限日）とドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、Montonio はチェックアウトで購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. が表示されます。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された決済方法が引き続き表示されるため、キーを購入する前にプラグインの設定とテストを行うことができます。プラグインのページと WooCommerce のページにはリマインダーが表示されます。既存の注文は影響を受けません。既に開始された決済は引き続き確認され、返金も機能します。
ライセンスの期限が切れた後も、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに Montonio が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在の環境の両方のキー（サンドボックスモードでは Sandbox access key と Sandbox secret key、本番モードでは Live access key と Live secret key）が入力されていること、そしてストアまたは注文の通貨が EUR または PLN であることを確認してください。キーが不足している場合や通貨がサポートされていない場合、設定ページに警告が表示されます。
決済は完了したのに、注文が支払い待ちのまま: 通知がストアに届いていません。サイトがインターネットからアクセス可能であること、そして設定のキーが決済の環境に属していることを確認してください。注文は、購入者が支払い後にストアに戻ったとき、または同じ注文を再度支払おうとしたときにも確認されます。
通知の応答が Invalid token: トークンの署名、有効期限、またはアクセスキーが一致しませんでした。アクセスキーと秘密鍵が正しくコピーされていること、正しい環境のものであること、そしてサーバーの時計が正確であることを確認してください。
通知の応答が Payment does not belong to this order または Wrong environment: その決済は、このストアがこの注文のために作成したものではないか、別の環境（サンドボックスまたは本番）で作成されたものです。2 つのストアが同じ Montonio アカウントと同じ注文番号を使用している場合に起こります。
通知の応答が Gateway not configured: Montonio のキーが設定されていません。キーを入力してください。Montonio は通知を再試行します。
購入者が注文時にエラーを見る: 注文メモを開くか、Debug log をオンにして、WooCommerce > Status > Logs をソース wcp_montonio_payment で確認してください。This payment method is temporarily unavailable. Please choose another payment method. は、通常、キーの誤りまたは未入力を意味します。Montonio could not start the payment. Please check your order details or choose another payment method. は、Montonio が決済データを拒否したことを意味します。理由は注文メモに記載されています。
支払い後に注文が保留中になる: 注文メモを確認してください。銀行がまだ決済を確認していない、支払われた金額または通貨が注文と異なる、本番モードでサンドボックスの決済が届いた、または注文のキャンセル後に決済が届いた、のいずれかです。Montonio Partner System で決済を確認してください。
サンドボックスの決済では本番の注文が確認されない: ストアが本番モードの間は、サンドボックスの決済が注文を完了させることはありません。代わりに注文は保留になります。Sandbox mode を使用したい環境に切り替え、その環境のキーを使用してください。
環境に関するメッセージとともに返金が失敗する: 決済はサンドボックスまたは本番の環境で行われましたが、その環境のキーが設定されていません。キーを入力してから、もう一度お試しください。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変更された場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。決済ゲートウェイの設定とログは、Delete data がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、決済メモとトランザクション ID を保持します。
Montonio は、その所有者の商標です。このプラグインは Montonio と提携しておらず、Montonio による推奨も受けていません。