VibeFox Moneris for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 8.0 以降、インストールされて有効になっていること。WooCommerce がない場合、プラグインは有効化できません。

PHP: 8.0 以降。

ストア通貨: カナダの Moneris アカウントには CAD、旧 Moneris USA アカウントには USD。注文の通貨がアカウントの通貨と一致する場合にのみ、この決済ゲートウェイが表示されます。

HTTPS と PCI DSS: カード番号はお客様のチェックアウトページで入力され、お客様のサーバーを経由します。本番決済には HTTPS と PCI DSS SAQ D への準拠が必要です。これを満たせない場合は、代わりにホスト型の決済ページのソリューションをご利用ください。

Moneris アカウント: Moneris Merchant Resource Center > Admin > Store Settings で確認できる、Moneris Gateway ストアの Store ID と API Token が必要です。テスト用には、Moneris の公開テストストアが初期値として入力されています。テスト用の認証情報とテストカードは、Moneris デベロッパーポータルにあります。

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

インストール

1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_moneris_gateway フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます：WooCommerce > Settings > Payments > Moneris > Manage。または、プラグインのページでプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. アカウントの国を選択し、Live Store ID と Live API Token を入力します。テストモードは初期状態でオンになっており、公開テストストアを使用します（カナダは store5 / yesguy、米国は monusqa002 / qatoken）。

6. Purchase または Pre-Authorization とカードのロゴを選択し、Enable / Disable をオンにします。

7. Moneris のテストカードでテスト注文を行い、その後 Test mode のチェックを外します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Moneris。テストモードがオンの間、ページには項目の上に Moneris gateway is in TEST MODE. No real charges will be made. と表示されます。本番モードでは、本番用の項目に Moneris のテスト用認証情報が含まれている場合（その場合、決済ゲートウェイはチェックアウトで非表示になります）や、サイトが HTTPS を使用していない場合に警告します。また、ストア通貨が Moneris アカウントの通貨と異なる場合にも警告します。この場合も、決済ゲートウェイはチェックアウトで非表示になります。

一般

Enable / Disable: Enable Moneris Gateway で、決済方法のオン／オフを切り替えます。初期値: オフ。

Title: 購入者に表示される決済方法の名前。初期値: Credit card (Moneris)。テストモードでは、チェックアウト時にタイトルに (Test Mode) が追加されます。

Description: チェックアウト時にカード入力欄の上に表示されるテキスト。初期値: Pay securely with your credit card.

Moneris アカウント

Store ID と API Token は、Moneris Merchant Resource Center の Admin > Store Settings にあります。テスト用の認証情報とテストカードは、Moneris デベロッパーポータルにあります。このセクションには両方へのリンクがあります。

Moneris account country: カナダのアカウントは CAD、米国のアカウントは USD で請求します。決済ゲートウェイは、注文の通貨が一致する場合にのみ表示されます。初期値: Canada (CAD)。

Canada (CAD): Moneris Canada のアカウント。

United States (USD, legacy Moneris USA accounts): Moneris USA のアカウント。

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges)。返金、キャプチャ、取り消しは、常に決済が行われた環境に送信されます。購入者には、カード入力欄の上に TEST MODE: use a Moneris test card, no real charges are made. と表示されます。初期値: オン。

Live Store ID: 本番用の Store ID（例: monca01234）。

Live API Token: 本番用の API Token。

Test Store ID: Moneris の公開テストストア: store5（カナダ）または monusqa002（米国）。初期値: store5。

Test API Token: 公開テスト用トークン: yesguy（カナダ）または qatoken（米国）。初期値: yesguy。

決済

Transaction type: カードへの請求方法。初期値: Purchase。

Purchase (charge immediately): 注文時にカードへすぐに請求されます。

Pre-Authorization (capture later): 資金は確保されるだけで、注文は保留中になります。注文を処理中または完了に変更するか、注文アクション Capture Moneris pre-authorization を使ってキャプチャします。注文をキャンセルすると解放されます。

Card logos: 決済方法のタイトルの横に表示されるカードブランドのロゴ: Visa、Mastercard、Discover、American Express、JCB。受け付けるブランドは Moneris アカウントの設定によって異なります。初期値: Visa and Mastercard。

詳細設定

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked)。エラーは常に記録されます。ログは WooCommerce > Status > Logs で、ソース wcp_moneris_gateway を選択すると確認できます。初期値: オフ。

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted。初期値: オフ。

チェックアウト

購入者は決済方法（初期値は Credit card (Moneris)）を選択し、チェックアウトページの WooCommerce カードフォームにカード番号、有効期限、セキュリティコードを入力します。注文が確定すると、お客様のサーバーが注文合計金額でカードを Moneris に送信し、結果をすぐに受け取ります。リダイレクトや webhook はありません。セキュリティコード（CVD）は常に送信されるため、Moneris ストアの eFraud ルールは引き続き適用されます。

承認された決済は、Moneris がトランザクションの完了を報告し、処理された金額が注文合計と一致した場合にのみ支払い済みとしてマークされます。その後、購入者は注文受付ページに進みます。Pre-Authorization の場合、キャプチャするまで注文は保留中のままです。

カードが拒否された場合、購入者には Moneris から示された理由とともに Your card was declined が表示され、カード情報を確認するか、別のカードを使用できます。Moneris がリクエストを処理できなかった場合（例: Store ID や API Token の誤り）、購入者には The payment could not be processed. Please try again or use another payment method. が表示されます。その理由は注文メモとログに追加されます。決済処理中にもう一度クリックすると、A payment for this order is already being processed. Please wait a moment and check your order status before trying again. が表示されます。支払い済みまたは事前承認済みの注文に対して、再度請求されることはありません。

Moneris から応答がない場合（ネットワークエラーまたはタイムアウト）、プラグインは Moneris に Status Check を送信して、トランザクションが成功したかどうかを確認します。それも不可能な場合、注文は Moneris の注文 ID とともに保留中になり、購入者に 2 回目の支払いが求められることはありません。

この決済方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

本プラグインは、保存済みカードや Moneris Vault、WooCommerce Subscriptions、Apple Pay、Google Pay、Interac Online、Moneris Checkout、Hosted Tokenization、3-D Secure、AVS、Kount、複数通貨の価格設定には対応していません。

注文と返金

注文ステータス

支払い待ち: 注文は作成されましたが、カードにはまだ請求されていません。たとえば、拒否された試行の後などです。注文メモには Moneris のコードとメッセージが表示されます。購入者は再度支払うことができます。

処理中: 購入が承認されました。ダウンロード可能な仮想商品のみの注文は、WooCommerce の既定値である完了に変わります。注文メモには、金額、Moneris のトランザクション ID、領収書が表示されます。トランザクション ID は Moneris のトランザクション番号です。

保留中: 事前承認が承認され、キャプチャを待っている、処理された金額が注文合計と異なった、または Moneris が結果を確認しなかった、のいずれかです。注文メモに理由が記載されます。

キャンセル済み: 事前承認された注文の場合、キャンセルすると確保された資金が解放されます（取り消し）。

キャプチャと取り消し

事前承認をキャプチャするには、注文ステータスを処理中または完了に変更するか、注文アクションで Capture Moneris pre-authorization を選択します。現在の注文合計から返金額を差し引いた金額がキャプチャされます。承認された金額を超えることはできません。Moneris がキャプチャを拒否した場合、ステータスはメモとともに保留中に戻り、処理中や完了のメールは送信されません。Moneris の事前承認は数日で期限切れになるため、期限内にキャプチャしてください。

資金を解放するには、注文をキャンセルするか、注文アクションで Void Moneris pre-authorization (cancel order) を選択します。注文ステータスを返金済みに変更しても、未処理の事前承認は解放されます。解放に失敗した場合、メモで Merchant Resource Center での解放を求められます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Credit card (Moneris) をクリックします（ボタンにはお客様の Title が表示されます）。全額返金と一部返金に対応しています。事前承認は、キャプチャされた後にのみ返金できます。それより前の場合は、注文をキャンセルして資金を解放してください。返金は決済が行われた環境とアカウントに送信されるため、そのモードの認証情報が入力されている必要があります。Moneris が返金を受け付けない場合、WooCommerce には理由とともに Refund failed が表示され、返金は記録されません。返金が成功すると、Moneris のトランザクション ID とともに注文メモに追加されます。

ライセンスキー

このプラグインは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Payments > Moneris の上部にあります。License key にキーを貼り付け、Activate をクリックします。ブロックにはステータス（たとえばライセンスの有効期限日）とドメインが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。

1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、Moneris はチェックアウトで購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. が表示されます。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された決済方法が引き続き表示されるため、キーを購入する前にプラグインの設定とテストを行うことができます。プラグインのページと WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。キャプチャ、取り消し、返金は引き続き動作します。

ライセンスの期限が切れた後も、プラグインは動作を続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。

トラブルシューティング

チェックアウトに Moneris が表示されない: ライセンスが有効であること、Enable / Disable がオンであること、現在のモードに Store ID と API Token があることを確認してください。本番モードでは、本番用の項目に Moneris のテスト用認証情報ではなく本番用の認証情報を入力する必要があります。ストア通貨（または Pay for order ページの注文通貨）がアカウントの通貨であることを確認してください。カナダは CAD、米国アカウントは USD です。通貨が一致しない場合、設定ページに警告が表示されます。

決済は完了したのに、注文が支払い待ちまたは保留中のまま: プラグインには webhook がなく、結果は Moneris からの応答のみで得られます。注文が保留中で、Moneris が結果を確認しなかったというメモがある場合、Moneris は応答せず、Status Check も失敗しています。メモに記載された Moneris の注文 ID を Merchant Resource Center で検索してください。トランザクションが存在する場合は注文を発送し（必要に応じてそこで返金）、存在しない場合は注文をキャンセルするか、購入者に再度支払いを依頼してください。

購入者に Payment gateway is misconfigured. Please contact the store administrator. と表示される: 現在のモードの認証情報が不足しているか、本番モードがオンなのに本番用の項目に Moneris のテスト用認証情報が入力されています。本番用の Store ID と API Token を入力してください。

購入者に This payment method does not support the order currency. と表示される: 注文の通貨が Moneris アカウントの通貨ではありません。

購入者に決済時のエラーが表示される: 注文メモを開くか、Debug log をオンにして、WooCommerce > Status > Logs をソース wcp_moneris_gateway で確認してください。

キャプチャに失敗する: 注文にキャプチャを待っている事前承認がない、注文合計がゼロである、または金額が承認された金額を超えています。また、Moneris の事前承認は数日で期限切れになります。

返金、キャプチャ、取り消しがモードまたはアカウントに関するメッセージで失敗する: 決済がテストモードまたは本番モードで行われ、そのモードの認証情報が未設定であるか、決済が別の国の Moneris アカウントで行われています。認証情報を入力するか、Merchant Resource Center で処理してください。

カードテスト攻撃: 直接のカードフォームは、カードテストの標的になりやすいです。WooCommerce チェックアウトのレート制限、CAPTCHA プラグイン、Moneris アカウントの eFraud または velocity ルールを有効にしてください。

ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。たとえば、キーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変更された場合は、Check now をクリックして、新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページでプラグインを無効化してから削除します。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。決済ゲートウェイの設定とログは、Delete data on uninstall がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。既存の注文は、決済メモとトランザクション ID を保持します。

Moneris は、その所有者の商標です。このプラグインは Moneris と提携しておらず、Moneris による推奨も受けていません。