VibeFox Montonio for PrestaShop — ヘルプ
要件
PrestaShop： 8.0 から 9.x。
PHP： 8.0 以降。モジュールは古い PHP バージョンへのインストールを拒否します。
通貨： カート通貨は EUR または PLN である必要があります。それ以外の通貨では、チェックアウトで決済方法が表示されません。
Montonio アカウント： Montonio Partner System で取得した、ショップのアクセスキーと秘密鍵が必要です。サンドボックスキーと本番キーは別々のため、使用する環境ごとにペアが必要です。Montonio 側で他に設定する必要はありません。通知アドレスは決済ごとに送信されます。
公開サイト： Montonio の通知を受け取るには、ショップがインターネットから到達可能である必要があります。そうでない場合でも、購入者がショップに戻ったときに注文は作成されます。
VibeFox ライセンスキー： vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager を開き、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。後でモジュール一覧から VibeFox Montonio Payment を探し、Configure をクリックすることもできます。
3. Configure ページ上部のライセンスブロックの License key に VibeFox ライセンスキーを入力し、Activate をクリックします（「ライセンスキー」を参照）。
4. Montonio Partner System で Stores > your store > API keys を開き、サンドボックスのアクセスキーと秘密鍵をコピーします。設定に貼り付け、Sandbox mode をオンのままにします。
5. Enable/Disable をオンにし、Save をクリックして、サンドボックスで決済をテストします。その後、本番キーを入力し、Sandbox mode をオフにします。
インストール時にモジュールは注文ステータス Montonio payment on hold を作成します。PrestaShop は、すべての通貨、国、顧客グループに対して新しい決済モジュールを提供します。これらは Payment > Preferences で制限できます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Montonio Payment > Configure。各セクションには個別の Save ボタンがあり、ページ全体が保存されます。フィールドの上には、現在の環境のキーが不足している場合（その場合、チェックアウトで決済方法は非表示になります）、ショップ通貨が EUR または PLN でない場合に警告が表示され、サンドボックスが有効な間は Sandbox mode is on: payments are simulated and no real money is charged. と表示されます。Title は空にできません。
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 で取得します。サンドボックスキーと本番キーは別々です。サンドボックスではサンドボックスキーのみを使用し、本番モードでは本番キーのみを使用します。
Sandbox mode： Montonio のサンドボックス（テスト決済、実際のお金は請求されません）を使用します。Montonio の API アドレスとキーペアの両方が切り替わります。デフォルト：オン。本番キーを入力した後にのみオフにしてください。もう一方の環境で行われた決済は、確認と返金にそれぞれの環境のキーを引き続き使用します。
Sandbox access key： Montonio サンドボックスにおけるショップのアクセスキー（UUID）です。
Sandbox secret key： Montonio サンドボックスにおけるショップの秘密鍵です。
Live access key： Montonio 本番環境におけるショップのアクセスキー（UUID）です。
Live secret key： Montonio 本番環境におけるショップの秘密鍵です。
保存された秘密鍵は再表示されません。フィールドは空のままで、Saved — leave empty to keep it. と表示されます。変更したい場合にのみ新しい値を入力してください。
Clear saved secret keys： キーにチェックを入れて Save をクリックすると削除されます。フィールドが空の場合は、保存された値が保持されます。
Notification URL： Montonio が決済通知を送信するアドレスです。フレンドリー URL の場合、次のような形式になります：https://your-shop/module/wcp_montonio_payment/webhook。どこかに入力する必要はありません。モジュールが決済ごとに Montonio へ送信します。
詳細設定
Debug log： 決済イベントをモジュールフォルダ内の logs/wc_mnt_debug.log.php に書き込みます。このファイルは Web から開くことはできません。このオプションがオフでも、エラーと警告は常に記録されます。キー、トークン、購入者データは決して記録されません。デフォルト：オフ。
Log： ログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。
Delete data： オンの場合、モジュールをアンインストールするとモジュールの設定とログが削除されます。モジュールを無効化しても何も削除されません。注文データ（Montonio UUID、メモ）は常に保持されます。デフォルト：オフ。
決済通知
Montonio は署名付きトークンで、決済ごとにショップへ通知します。トークンは 2 つの方法で届きます。通知 URL へのサーバー間通知と、購入者がショップに戻ったときです。どちらも検証されます。決済を作成した環境の秘密鍵による署名、有効期限、ショップのアクセスキー、そしてその決済がそのカートに対してショップによって作成されたものであるかどうかです。別の環境のキーで署名されたトークンは拒否されます。各ステータスは 1 回だけ適用されるため、繰り返される通知がメモ、メール、在庫の変更を追加することはありません。通知 URL はショップがメンテナンスモードの間も機能し、ショップの国別制限によってブロックされることはありません。
チェックアウト
決済ステップで購入者は決済方法（デフォルトは Bank payment (Montonio)）を選び、確定します。モジュールはカート通貨でカート合計額の Montonio 決済を作成し、購入者を Montonio の決済ページに移動させます。そこで購入者は銀行を選んで支払います。購入者の請求先国の銀行が先頭に表示されます（PLN のカートの場合はポーランド）。決済は Order とカート番号として表示されます。Montonio のページは、ショップの言語がドイツ語、英語、エストニア語、フィンランド語、リトアニア語、ラトビア語、ポーランド語、ロシア語の場合はその言語で開き、それ以外の場合は英語で開きます。サンドボックスモードでは、チェックアウトに説明文の下で SANDBOX MODE — test payment, no real money is charged. が表示されます。この時点ではまだ注文は存在しません。
注文は、Montonio が確認した後（通知または購入者の帰還時）にのみ支払い済みになります。その後注文が作成され、購入者には標準の注文確認ページが表示され、Your Montonio bank payment has been received. と表示されます。銀行がまだ決済を確認していない場合、または注文が保留中の場合、ページには We are confirming your payment with Montonio. The order will be updated automatically — please do not pay again. と表示されます。銀行が後に承認済みの決済を拒否した場合、ページには Your Montonio payment was not completed. Please contact us about this order. と表示されます。
購入者の帰還時に Montonio が決済はまだ保留中と報告した場合、Payment confirmation ページに同じテキストと Check again ボタンが表示されます。このボタンは Montonio に決済の現在のステータスを問い合わせます。通知が届き次第、注文が作成されます。
決済がキャンセルまたは拒否された場合、購入者は次のいずれかのメッセージとともにチェックアウトに戻ります：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. カートは保持されます。新しい決済を作成する前に、モジュールは前回の決済について Montonio に問い合わせます。既に支払い済みであれば、注文が作成され、2 回目の決済は行われません。
Montonio が決済を開始できない場合、購入者はチェックアウトに留まり、短いメッセージが表示されます。例：Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method. 技術的な理由はログに記録されます。
本モジュールは銀行振込決済（決済開始）のみに対応しています。カード決済、BLIK、Apple Pay、Google Pay、Pay Later や分割払い、Montonio の配送、サブスクリプション、保存済みの決済方法、貴サイト上での銀行選択には対応していません。
注文と返金
注文ステータス
No order yet： 購入者は Montonio に移動しましたが支払いを行っていないか、Montonio が決済を保留中と報告しています。カートだけが存在します。
Payment accepted： Montonio がカートの金額と通貨が正確に一致する決済（PAID）を確認しました。決済は Montonio 注文 UUID をトランザクション ID として記録され、メモには銀行、UUID、金額、環境が表示されます。
Montonio payment on hold： 銀行がまだ決済を確認していません（AUTHORIZED）。Montonio が PAID を報告すると、注文は Payment accepted になります。注文は次の場合にも保留になります：Montonio がカート合計額と異なる金額または通貨を報告した場合、ショップが本番モードの間にサンドボックス決済が届いた場合（お金を受け取っていないため、決済は記録されません）、または注文がキャンセルされた後に決済が届いた場合。メモで理由が説明されます。Montonio Partner System で決済を確認し、注文を処理するか、決済を返金してください。
Payment error： 銀行が承認済みの決済を拒否したか、購入者が決済を完了しませんでした。カートの最新の決済のみが注文を変更できます。
Refunded： 決済はモジュールを通じて全額返金されました。
支払い済み、キャンセル済み、返金済みの注文は、後の通知によって再度開かれることはありません。既に支払い済みの注文に 2 回目の決済が届いても、注文は変更されません。メモは、Montonio Partner System で 2 回目の決済を返金するよう求めます。
Montonio payment ブロック
注文ページには Montonio payment ブロックが表示され、Montonio 注文 UUID、環境（テスト決済には Sandbox バッジ付き）、銀行、決済ステータス、支払い済み金額と返金済み金額、返金履歴、注文の Montonio notes が含まれます。
返金
Montonio payment ブロックで金額を入力します（まだ返金されていない金額が自動入力されます）。任意で理由を入力できます（注文メモにのみ保存されます）。そして Refund via Montonio をクリックします。確認メッセージ Refund this amount through Montonio? This cannot be undone. を承認してください。全額返金と一部返金に対応しています。注文を編集する権限が必要です。モジュールページへのアクセスは不要です。返金は Montonio が請求した金額が上限です。そのため金額の不一致があった場合、注文合計額ではなく、購入者が実際に支払った金額まで返金できます。返金は決済が行われた環境（サンドボックスまたは本番）に送信されるため、その環境のキーが設定されている必要があります。Montonio が返金を受け付けない場合、ブロックにエラーが表示され、返金は記録されません。送信された返金は、そのステータスと Montonio の返金 ID とともに、返金履歴とメモに追加されます。全額返金を行うと注文は Refunded になります。一部返金ではステータスは変わりません。返金は、Montonio が決済を支払い済みと報告した後に利用できます。
Montonio は後から通知によって各返金を確定または拒否します。確定はメモに追加されます。Montonio が返金を拒否した場合、メモには購入者に返金されていないと記載されます。Montonio Partner System で確認し、PrestaShop で返金を修正してください。
モジュールはクレジット伝票を作成しません。注文ページの標準 PrestaShop 返金ボタンは、Montonio を通じて返金を行いません。Montonio Partner System で行われた返金は、Montonio が報告するとメモに追加されます。注文ステータスとクレジット伝票は自動的に変更されません。必要に応じて手動で更新してください。
ライセンスキー
モジュールは vibefox.net で入手した VibeFox ライセンスキーで動作します。License — VibeFox Montonio Payment のライセンスブロックは、Modules > Module Manager > VibeFox Montonio Payment > Configure ページで設定の上にある最初のブロックです。License key にキーを入力して Activate をクリックしてください。その後、ブロックにはキーがマスクされた状態、ステータス（ライセンスの有効期限日やお使いのドメインなど）、そして Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）のボタンが表示されます。その下には Product: presta-payment-montonio の行と、vibefox.net のアカウントを開くリンク Manage licenses and domains in your account があります。キーを変更できるのは、このモジュールの Configure 権限を持つ従業員のみです。ブロックの表示テキストは管理画面の言語に従います（英語とロシア語を含みます）。
キーが受け付けられない場合、ブロックは理由を表示します。例：Key not found、This key belongs to another product、Domain limit reached、または License expired on と日付。ショップのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認されたステータスで動作を続けます。
1 つのキーは 1 つのドメインで機能します。メインショップのドメインが対象で、マルチストア構成でも同様です。ショップからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで Montonio は購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。PrestaShop のフロントエンドは、管理画面にログインしていることを認識しないため、決済方法はあなたにも非表示になります。購入前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文は影響を受けません。既に開始された決済は引き続き確認され、返金も機能します。
ライセンスの有効期限が切れた後もモジュールは動作しますが、アップデートとサポートには更新が必要です。ステータスは、管理画面で作業している間に自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
チェックアウトに Montonio が表示されない： ライセンスが有効であること、Enable/Disable がオンであること、現在の環境の両方のキーが設定されていること（サンドボックスモードでは Sandbox access key と Sandbox secret key、本番モードでは Live access key と Live secret key）、そしてカート通貨が EUR または PLN であることを確認してください。キーが不足している場合やショップ通貨がサポートされていない場合、設定ページに警告が表示されます。Payment > Preferences で、カート通貨、購入者の国、購入者のグループに対してモジュールが許可されているか確認してください。
決済は完了したが注文が作成されない： 通知がショップに届いていません。ショップがインターネットから到達可能か、設定のキーが決済の環境に属しているかを確認してください。注文は、購入者が支払い後にショップに戻ったとき、購入者が Check again をクリックしたとき、そして購入者が同じカートを再度支払おうとしたときにも作成されます。
通知が Invalid token と応答する： トークンの署名、有効期限、またはアクセスキーが一致しませんでした。アクセスキーと秘密鍵が正しくコピーされていて、正しい環境に属しているか、そしてサーバーの時刻が正しいかを確認してください。別の環境のキーで署名されたトークンも拒否されます。
通知が Payment does not belong to this order と応答する： この決済は、このショップがこのカートのために作成したものではありません。2 つのショップが同じ Montonio アカウントと同じカート番号を使っている場合に発生します。
通知が Gateway not configured と応答する： Montonio のキーが設定されていないか、決済の環境のキーが不足しています。キーを入力してください。Montonio は通知を再試行します。
通知が Temporarily unavailable と応答する： カートが同時に別のリクエストによって確定されていたか、注文を作成できませんでした（例：モジュールが無効）。Montonio は通知を再試行します。理由は Log フィールドを確認してください。
購入者が Montonio を選択するとエラーが表示される： モジュールページの Log フィールドを確認してください。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 payment on hold になる： Montonio payment ブロックのメモを確認し（注文ステータスを参照）、注文を処理するか決済を返金してください。
サンドボックスの決済は本番の注文を確認しない： ショップが本番モードの間、サンドボックスの決済は注文を完了させません。代わりに注文は保留になります。Sandbox mode を希望する環境に切り替え、その環境のキーを使用してください。
返金が環境に関するメッセージで失敗する： 決済はサンドボックスまたは本番環境で行われ、その環境のキーが設定されていません。キーを入力して再試行してください。
開発者向けに、モジュールは対応通貨、決済データ、Montonio ページの言語を変更するためのフック actionWcpMontonioSupportedCurrencies、actionWcpMontonioOrderData、actionWcpMontonioLocale を提供しています。
アンインストール
Modules > Module Manager に移動し、VibeFox Montonio Payment の横にあるメニューを開いて Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは常に削除されます。Delete data がオンの場合、モジュールの設定とログは削除されます。オフの場合、後で再インストールするためにすべての設定が保持されます。Montonio の決済と返金の記録、および注文ステータス Montonio payment on hold は常に保持されるため、以前に支払い済みの注文は再インストール後も返金できます。既存の注文は、決済メモとトランザクション ID を保持します。
Montonio は各所有者の商標です。本モジュールは Montonio と提携しておらず、Montonio の承認も受けていません。