VibeFox Moneris for PrestaShop — ヘルプ

要件

PrestaShop: 8.0 から 9.x。

PHP: SimpleXML 拡張機能を備えた 8.0 以降。古い PHP バージョンや SimpleXML がない環境では、モジュールはインストールされません。

ショップ通貨: カナダの Moneris アカウントには CAD、旧 Moneris USA アカウントには USD。支払い方法は、カートの通貨がアカウントの通貨と一致する場合にのみ表示されます。

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

Moneris アカウント: Moneris Gateway ストアの Store ID と API Token が必要です。これらは Moneris Merchant Resource Center > Admin > Store Settings にあります。テスト用には、Moneris の公開テストストアがあらかじめ入力されています。テスト用の認証情報とテストカードは Moneris の開発者ポータルにあります。

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

インストール

1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択してください。

2. アップロードが完了したら Configure をクリックするか、後でモジュール一覧から VibeFox Moneris Gateway を見つけて Configure をクリックしてください。

3. Configure ページ上部のライセンスブロックにある License key 欄に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。

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

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

6. Moneris のテストカードでテスト注文を行い、その後 Test mode をオフにします。

インストール時に、モジュールは 2 つの注文ステータス Moneris payment authorized と Moneris payment on hold を作成します。PrestaShop は、新しい支払いモジュールをすべての通貨、国、顧客グループで初期設定で有効にします。Payment > Preferences で制限できます。

設定

すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Moneris Gateway > Configure。各セクションには個別の Save ボタンがあり、ページ全体が保存されます。テストモードがオンの間、ページは入力欄の上に Moneris gateway is in TEST MODE. No real charges will be made. を表示します。本番モードでは、本番用の欄に Moneris のテスト認証情報が入っている場合（この場合、支払い方法はチェックアウトで非表示になります）や、ショップで SSL が有効になっていない場合に警告します。ショップの既定の通貨が Moneris アカウントの通貨と異なる場合も警告します。その場合、支払い方法は他の通貨のチェックアウトでは非表示になります。

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 アカウントの国: カナダのアカウントは CAD、米国のアカウントは USD で請求されます。支払い方法は、カートの通貨が一致する場合にのみ表示されます。初期値：Canada (CAD)。

Test mode: Moneris の QA ゲートウェイとテスト用の認証情報を使用します。実際の請求は行われません。キャプチャ、取り消し、返金は、常に決済が行われた環境に送信されます。購入者には、カード欄の上に 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。

保存済みの API トークンは二度と表示されません。欄は空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。

Clear saved tokens: トークンにチェックを入れて Save をクリックすると削除されます。欄が空のままなら、保存済みの値は保持されます。

支払い

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

Card logos: チェックアウトで支払い方法と一緒に表示されるカードブランド：Visa、Mastercard、Discover、American Express、JCB。受け付けられるブランドは Moneris アカウントによって異なります。初期値：Visa と Mastercard。

詳細設定

Debug log: API のリクエストとレスポンスを、モジュールフォルダ内の logs/wc_mng_debug.log.php に記録します。このファイルはウェブから開くことはできません。カード番号、CVV、有効期限、API token はマスクされます。エラーはオフのときも常に記録されます。初期値：オフ。

Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。

Delete data on uninstall: オンにすると、モジュールをアンインストールしたときにゲートウェイの設定とログが削除されます。注文の Moneris データ（返金に必要）と注文ステータスは常に残ります。初期値：オフ。

チェックアウト

支払いステップで、購入者は支払い方法を選択し（初期値は Credit card (Moneris)）、その下のカードフォームに Card number、Expiry (MM/YY)、Card code (CVC) を入力します。3 つの欄はすべて必須です。注文が行われると、貴店のサーバーがカートの合計金額で Moneris にカードを送信し、結果をすぐに受け取ります。リダイレクトも webhook もありません。カード情報はこの 1 回のリクエストにのみ使用され、保存されることはありません。ログには下 4 桁のみが表示されます。

注文は、承認された Moneris の応答からのみ作成されます。その後、購入者には標準の注文確認ページが表示されます。Pre-Authorization の場合、注文は資金をキャプチャするまで Moneris payment authorized で待機します。Moneris が処理した金額がカート合計と異なる場合、または支払い中にカートが変更された場合、注文はメモ付きで Moneris payment on hold に作成されます。

カードが拒否された場合、購入者は Your card was declined と Moneris からの理由が表示された状態でチェックアウトに留まり、カード情報を確認するか、別のカードを使用できます。注文は作成されません。Moneris がリクエストを処理できない場合（たとえば Store ID や API Token が誤っている場合）、購入者には The payment could not be processed. Please try again or use another payment method. と表示されます。理由はログに記録されます。カード情報の入力ミスの場合は、Invalid card number. や Invalid card expiry date. などの短いメッセージが表示され、Moneris には何も送信されません。

支払い処理中に 2 回目のクリックや別のブラウザタブを開くと、A payment for this order is already being processed. Please wait a moment and check your order status before trying again. と表示されます。すでに注文があるカートに対して再度請求されることはなく、購入者は既存の注文に誘導されます。

Moneris から応答がない場合（ネットワークエラーまたはタイムアウト）、モジュールは同じ Moneris の注文 ID を使って Moneris に Status Check を送信し、取引が成立したかどうかを確認します。Moneris にそのような取引がない場合、購入者は再度支払うことができます。Status Check にも応答がない場合、注文は Moneris の注文 ID とともに Moneris payment on hold で作成され、購入者に 2 回目の支払いは求められません。

本モジュールには、保存済みカードや Moneris Vault、サブスクリプション、Apple Pay、Google Pay、Interac Online、Moneris Checkout、Hosted Tokenization、3-D Secure、AVS、Kount、複数通貨の価格設定はありません。

注文と返金

注文ステータス

No order yet: カードが拒否されたか、処理されませんでした。カートとログ上の試行のみが存在します。購入者は再度支払うことができます。

Payment accepted: 購入が承認されました。支払いは、Moneris の取引番号を取引 ID として記録されます。

Moneris payment authorized: 事前承認が承認され、キャプチャを待っています。まだ支払いは記録されていません。

Moneris payment on hold: 処理された金額がカート合計と異なった、支払い中にカートが変更された、Moneris が結果を確認できなかった、またはキャプチャが失敗したにもかかわらず PrestaShop が支払い済みのステータスを書き込んだ。メモに説明があります。金額が異なる購入の場合、支払いは Moneris が処理した金額で記録されます。

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

Refunded: モジュールを通じて支払いが全額返金されました。

Moneris payment ブロック

注文ページには Moneris payment ブロックが表示されます。内容は、Moneris 注文 ID、アカウントの国とモード、テスト支払い用の Test mode バッジ、Trans ID（キャプチャ後は事前承認の Trans ID も）、取引の種類とその状態（未キャプチャ、キャプチャ済み、解放済み）、領収書とカードの種類、処理金額、注文合計と返金済み金額、返金履歴、そして注文の Moneris notes です。未確認の支払いの場合、ブロックは Merchant Resource Center で Moneris 注文 ID を検索するよう求めます。ブロック内のすべての操作には、注文を編集する権限だけが必要です。

キャプチャと取り消し

事前承認をキャプチャするには、ブロックの Capture payment をクリックして確認するか、注文を Payment accepted、発送済み、配達済みなどの支払い済みのステータスに変更します。返金を差し引いた注文合計がキャプチャされます。承認された金額を超えることはできません。ボタンでキャプチャした後、注文は Payment accepted になり、支払いはキャプチャの Trans ID とともに記録されます。Moneris がキャプチャを拒否した場合、ステータスは変わらず、支払い済みのメールは送信されず、理由とともに次のメモが表示されます：Status not changed: the Moneris pre-authorization could not be captured。Moneris の事前承認は数日で期限切れになるため、早めにキャプチャしてください。

資金を解放するには、Void pre-authorization (cancel order) をクリックするか、注文を Canceled に設定します。注文を Refunded に設定しても、未完了の事前承認は解放されます。解放に失敗した場合、メモが Merchant Resource Center での解放を求めます。

返金

Moneris payment ブロックで金額を入力し（まだ返金されていない金額が自動入力されます）、必要に応じて理由を入力して、Refund via Moneris をクリックします。確認画面 Refund this amount through Moneris? This cannot be undone. で承認してください。全額返金と一部返金に対応しています。返金は、Moneris が実際に請求した金額が上限です。そのため、金額の不一致があった場合は注文合計ではなく、購入者が支払った金額まで返金できます。事前承認はキャプチャ後にのみ返金できます。それ以前に資金を解放するには、注文をキャンセルしてください。返金は、支払いが行われた環境とアカウントに送信されるため、そのモードの認証情報が入力されている必要があります。Moneris が返金を受け付けない場合、ブロックには理由とともに Refund failed が表示され、返金は記録されません。返金に成功すると、返金履歴とメモに Moneris の Trans ID とともに追加されます。全額返金すると注文は Refunded になります。一部返金ではステータスは変わりません。

本モジュールは返金伝票を作成しません。注文ページの PrestaShop 標準の返金ボタンは、Moneris を通じて返金しません。

ライセンスキー

本モジュールは、vibefox.net で入手した VibeFox ライセンスキーで動作します。License — VibeFox Moneris Gateway ライセンスブロックは、Modules > Module Manager > VibeFox Moneris Gateway > Configure ページで設定より上にある最初のブロックです。License key にキーを入力し、Activate をクリックします。その後、ブロックにはキーがマスク表示され、ステータス（ライセンスの有効期限日やお使いのドメインなど）と、次のボタンが表示されます：Check now でステータスを再確認、Change key で別のキーを入力、Remove key でこのショップからキーを削除します。その下には Product: presta-payment-moneris の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントを開きます。キーを変更できるのは、このモジュールの Configure 権限を持つ従業員のみです。ブロックのテキストはバックオフィスの言語に従います（英語とロシア語が含まれます）。

キーが受け付けられない場合、ブロックには理由が表示されます。例：Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ショップのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認できた状態で動作を続けます。

1 つのキーは 1 つのドメインで使用できます。メインショップのドメインで、マルチストア構成の場合も同様です。ショップからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで購入者に Moneris は表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。PrestaShop のフロントエンドは、管理画面にログインしていることを認識しないため、お客様にも決済方法は非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでのテストはできません。Modules > Module Manager の Alerts タブに通知が表示されます。既存の注文には影響しません。以前の決済のキャプチャ、取り消し、返金は引き続き機能します。

ライセンスの有効期限が切れてもモジュールは動作を続けますが、アップデートとサポートには更新が必要です。管理画面で作業している間、ステータスは自動的に再確認されます：キーを入力してから最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。モジュールのアンインストールまたはリセットでは、常にライセンスキーとライセンスステータスが削除されます。

トラブルシューティング

チェックアウトに Moneris が表示されない: ライセンスが有効であること、Enable / Disable がオンであること、現在のモードに Store ID と API Token が入力されていることを確認してください。本番モードでは、本番用の欄に Moneris のテスト認証情報ではなく本番用の認証情報を入力する必要があります。カートの通貨がアカウントの通貨（カナダは CAD、米国アカウントは USD）であることを確認してください。Payment > Preferences で、そのモジュールがその通貨、購入者の国、顧客グループに対して許可されていることを確認してください。

支払いは完了したが、注文が Moneris payment on hold になっている: モジュールには webhook がありません。結果は Moneris の応答からのみ得られます。ブロックの Moneris notes を確認してください。Moneris が結果を確認していない場合、Moneris が応答せず、Status Check も失敗しています。Merchant Resource Center で Moneris 注文 ID を検索してください。取引が存在すれば注文を発送し（必要に応じてそこで返金し）、存在しなければ注文をキャンセルするか、購入者に再度支払いを依頼してください。金額が異なっていた場合は、注文を確認して処理するか、支払いを返金してください。

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

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

購入者が支払い時にエラーを見る: モジュールページの Log 欄を確認してください。エラーは常に記録されます。リクエストとレスポンスの全体を確認するには Debug log をオンにしてください。

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

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

カードテスト攻撃: 直接のカードフォームはカードテストの標的になりやすいです。Moneris アカウントの eFraud または velocity ルールと、ショップ用の CAPTCHA またはレート制限モジュールを使用してください。

アンインストール

Modules > Module Manager に移動し、VibeFox Moneris Gateway の横のメニューを開いて Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは常に削除されます。Delete data on uninstall がオンの場合、ゲートウェイの設定とログが削除されます。オフの場合、後で再インストールするためにすべての設定が保持されます。Moneris の取引と返金、および注文ステータス Moneris payment authorized と Moneris payment on hold は常に保持されるため、以前に支払われた注文は再インストール後もキャプチャや返金が可能です。既存の注文は、支払いメモと取引 ID を保持します。

Moneris は、その所有者の商標です。本モジュールは Moneris と提携しておらず、Moneris による推奨もありません。