VibeFox MultiSafepay for WooCommerce — ヘルプ
要件
WordPress: 6.0 以降。
WooCommerce: 7.0 以降。インストールされ、有効になっている必要があります。WooCommerce がなければ、プラグインは有効化されません。
PHP: 8.0 以降。
通貨: ストアまたは注文の通貨は、MultiSafepay が受け付ける通貨（例：EUR、USD、GBP、PLN、CHF、SEK、DKK、NOK）である必要があります。その他の通貨の場合、チェックアウトで決済方法は表示されません。
MultiSafepay アカウント: MultiSafepay Control で、貴サイトの API キーが必要です。テスト用アカウントと本番用アカウントでは、キーが異なります。MultiSafepay 側でそれ以外に設定する必要はありません。通知先アドレスはすべての決済に含まれます。
公開サイト: 通知を送信するために、MultiSafepay が貴サイトにアクセスできる必要があります。アクセスできない場合でも、購入者が MultiSafepay から戻ったときに注文は更新されます。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_multisafepay_gateway フォルダを /wp-content/plugins/ にアップロードすることもできます。
2. Activate をクリックします。
3. 設定を開きます：WooCommerce > Settings > Payments > MultiSafepay > Manage。または、プラグインの一覧ページでプラグイン名の下にある Settings をクリックします。
4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。
5. MultiSafepay Control から、テスト用および／または本番用の API キーを貼り付けます（設定の項を参照）。
6. Enable/Disable をオンにして保存します。Test mode をオンにした状態で決済をテストし、その後チェックを外して実際の支払いを受け付けます。
設定
すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > MultiSafepay。テストモードが有効な間、ページタイトルには Test mode のバッジが表示されます。フィールドの上には、現在のモードに API キーがない場合（その場合、チェックアウトで決済方法は表示されません）や、MultiSafepay がストアの通貨を受け付けない場合に警告が表示されます。決済方法の一覧では、現在のモードに API キーが設定されるまで、MultiSafepay は設定が必要な状態として表示されます。
チェックアウト
Enable/Disable: Enable MultiSafepay で決済方法のオン／オフを切り替えます。既定値：オフ。
Title: チェックアウトで購入者に表示される決済方法の名前です。既定値：MultiSafepay。
Description: チェックアウトで決済方法の下に表示されるテキストです。既定値：Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay。
API キー
API キーは MultiSafepay Control > Manage settings > Website settings にあります。テスト用アカウント（testmerchant.multisafepay.com）と本番用アカウント（merchant.multisafepay.com）では、キーが異なります。テストモードではテスト用キーのみを、本番モードでは本番用キーのみを使用します。
Test mode: Use the MultiSafepay test environment (no real payments)。API アドレスと API キーの両方が切り替わります。すでに行われた決済は、ステータス確認と返金のために、支払い時の環境を引き続き使用します。既定値：オン。
Test API key: MultiSafepay のテスト用アカウントの API キーです。
Live API key: MultiSafepay の本番用アカウントの API キーです。
通知
設定は不要です。このセクションには、すべての決済とともに MultiSafepay に送信される通知 URL が表示されます。形式は次のようになります：https://your-site/?wc-api=mspg_webhook。MultiSafepay が貴サイトにアクセスできる必要があります。通知は、どの決済が変更されたかをプラグインに伝えるだけです。注文を変更する前に、ステータス、金額、通貨は必ず貴店の API キーを使って MultiSafepay API から読み取られます。貴店の注文に属さない決済の通知は無視されます。
注文
Order status after payment: 支払い済み注文のステータスです。ステータスは直ちに設定され、ステータス変更は 1 回、購入者へのメールも 1 通だけ送信されます。
詳細設定
Debug log: Log API calls and notifications は詳細を WooCommerce > Status > Logs に、ソース wcp_multisafepay_gateway として書き込みます。エラーは常に記録されます。API キーと購入者データは記録されません。既定値：オフ。
Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted。プラグインを無効化しても、何も削除されることはありません。既定値：オフ。
チェックアウト
購入者は決済方法（既定では MultiSafepay）を選択して注文します。プラグインは、注文金額を注文通貨で MultiSafepay の決済として作成し、購入者を MultiSafepay の決済ページに誘導します。購入者はそこで、貴店の MultiSafepay アカウントで有効になっている任意の決済方法を選び、支払います。購入者の請求先情報とストアの言語は MultiSafepay に渡され、決済には Order #、注文番号、貴店のサイト名が表示されます。テストモードでは、チェックアウトに Test mode: no real payment will be made. と表示されます。
購入者が支払いを行っている間は在庫が確保され、カートは注文受付ページまで保持されます。支払い後、購入者は貴店の注文受付ページに戻ります。注文は、MultiSafepay が確認した後にのみ支払い済みとなります。通知によって確認されるか、購入者がそのページに到達したときに MultiSafepay API で確認されます。
購入者がチェックアウト中に MultiSafepay のページでキャンセルした場合、注文は WooCommerce の標準的な方法でキャンセルされ、在庫は解放され、商品はカートに残ります。購入者が Pay for order ページから支払っていた場合は、そのページに戻り、何が起きたかを説明するメッセージが表示されます：The MultiSafepay payment was cancelled. You can try again or choose another payment method.、The payment was declined. Please try again or choose another payment method.、または The payment session has expired. Please try again.
購入者は、未払いの注文を再度支払うことができます。新しい支払いを作成する前に、プラグインは前回の支払いを MultiSafepay で確認します。すでに支払い済みであれば、注文が確認されます。同じ金額で開いたままであれば、同じ決済ページが再利用されます。金額が変更された場合は、古い支払いが MultiSafepay でキャンセルされるため、もう支払うことはできません。
MultiSafepay が支払いを開始できない場合、購入者には Could not connect to MultiSafepay. Please try again in a moment. や MultiSafepay cannot accept this order amount or currency. Please choose another payment method. などの短いメッセージが表示され、別の決済方法を選ぶことができます。MultiSafepay のエラーは注文メモに追加されます。
この決済方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。
本プラグインは、MultiSafepay の決済ページへ誘導する決済方法を 1 つ提供します。MultiSafepay の決済方法ごとに別々の WooCommerce 決済方法はなく、カード入力欄の埋め込み、Apple Pay や Google Pay のエクスプレスボタン、サブスクリプション、定期支払い、保存済みカードはありません。WooCommerce からオーソリとキャプチャ、取消を行うこともできません。カート情報は送信されないため、MultiSafepay はこれらの注文について、それを必要とする後払い方法（例：Klarna、in3、Riverty）を提供しません。
注文と返金
注文ステータス
Pending payment: 購入者は MultiSafepay に移動されましたが、まだ支払っていません。
Processing または Completed: MultiSafepay が支払いを確認しました（完了または発送済み）。ステータスは Order status after payment に従います。注文メモには、MultiSafepay の支払い ID、決済方法、環境が表示されます。トランザクション ID は、その支払いの MultiSafepay 注文 ID です。
On hold before payment: 支払いが未清算（MultiSafepay が審査中）、または承認済み（オーソリ済み）です。お金を受け取るには、MultiSafepay Control で承認済みの支払いをキャプチャしてください。MultiSafepay が支払い済みと報告すると、注文は自動的に完了します。
On hold after payment: MultiSafepay が、注文の合計と異なる金額または通貨を確認した。ストアが本番モードの間にテスト支払いが完了した（実際のお金は受け取っていません）。または、注文がキャンセルされた後に支払いが完了した。注文メモに理由が記載されています。MultiSafepay Control でトランザクションを確認し、注文を手動で処理するか返金してください。
On hold after a chargeback: 支払い済みの注文に対して、MultiSafepay からチャージバックが報告されました。お金は貴社のアカウントから引き戻されています。
Failed: 未払い注文の最新の支払いが拒否、キャンセル、期限切れ、または無効化されました。保留中の在庫は解放されます。購入者は再度試すことができます。
支払い済み、返金済み、またはキャンセル済みの注文は、遅れて届いた通知によって再び開かれることはありません。すでに支払い済みの注文に対して 2 回目の支払いが完了した場合、注文は再び変更されません。メモで、重複分を MultiSafepay Control で返金するよう通知されます。
返金
注文を開き、Refund をクリックして金額を入力し、Refund via MultiSafepay をクリックします。MultiSafepay で支払われた注文には、全額返金と一部返金に対応しています。返金は、支払いが行われた環境（テストまたは本番）に送信されるため、その環境の API キーが設定されている必要があります。MultiSafepay が返金を受け付けない場合、WooCommerce に MultiSafepay のエラーが表示され、返金は記録されません。成功したリクエストは、MultiSafepay の返金 ID とともに注文メモに追加されます。
MultiSafepay Control で行われた返金は、MultiSafepay から報告されたときに注文メモに追加されます。これらは WooCommerce の返金として自動的に記録されることはありません。必要に応じて、Refund via MultiSafepay を使わずに、WooCommerce で手動返金を作成してください。
ライセンスキー
このプラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Payments > MultiSafepay のページ上部にあります。License key にキーを貼り付け、Activate をクリックします。ブロックには、ライセンスの有効期限日や貴店のドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。
1 つのキーは 1 つのドメインでのみ使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで購入者に MultiSafepay は表示されません。それでも支払いが開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログインしたストア管理者には、(unlicensed — visible to admins only) と表示された状態で決済方法が引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインページと WooCommerce のページには通知が表示されます。既存の注文には影響ありません。すでに開始された支払いは引き続き確認され、返金も行えます。
ライセンスの有効期限が切れてもプラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。
トラブルシューティング
チェックアウトに MultiSafepay が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに API キーがあること（テストモードでは Test API key、本番モードでは Live API key）、そして MultiSafepay がストアまたは注文の通貨を受け付けていることを確認してください。キーがない場合や通貨が受け付けられない場合、設定ページに警告が表示されます。
支払いは完了したが、注文が Pending payment のまま: 通知が貴店に届いていません。サイトがインターネットから到達可能であること、また、プラグインは API からステータスを読み取るため、支払いの環境の API キーが設定されていることを確認してください。API に到達できない場合、通知は ERROR で応答し、MultiSafepay は再試行します。購入者が注文受付ページに戻ったとき、または同じ注文を再度支払おうとしたときにも、注文は更新されます。
注文時に購入者にエラーが表示される: 注文メモを開くか、Debug log をオンにして WooCommerce > Status > Logs をソース wcp_multisafepay_gateway で確認してください。This payment method is temporarily unavailable. Please choose another payment method. は、通常、API キーが誤っているか未設定であることを意味します。MultiSafepay cannot accept this order amount or currency. Please choose another payment method. は、MultiSafepay が金額または通貨を拒否したことを意味します。
注文が On hold after payment になっている: 注文メモを確認してください。支払いが未清算または承認済みである、支払われた金額または通貨が注文と異なる、テスト支払いが本番モードで届いた、注文がキャンセルされた後に支払いが完了した、あるいはチャージバックが発生した、といった理由が考えられます。MultiSafepay Control でトランザクションを確認してください。
テスト支払いでは本番の注文は確定されない: ストアが本番モードの間、テスト支払いが注文を支払い済みにすることはありません。代わりに注文は保留になります。本番モードに切り替えた後も、以前のテスト支払いはテスト用キーで引き続き確認され、返金されます。
環境に関するメッセージで返金が失敗する: 支払いはテスト環境または本番環境で行われており、その環境の API キーが設定されていません。キーを入力して、もう一度お試しください。
ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインですでに使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。
アンインストール
プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定、注文に保存された MultiSafepay のデータ、ログは、Delete data on uninstall がオンになっていた場合にのみ削除されます。そうでない場合は、後日の再インストールのために保持されます。既存の注文は、支払いメモとトランザクション ID を保持します。
MultiSafepay は、それぞれの所有者の商標です。本プラグインは MultiSafepay と提携しておらず、MultiSafepay による推奨もされていません。