VibeFox Netopia for PrestaShop — ヘルプ

要件

PrestaShop: 8.0 から 9.x。

PHP: 8.0 以降で、OpenSSL、DOM、SimpleXML の拡張機能を備えていること。これらがない場合、モジュールはインストールを拒否します。

通貨: カートの通貨は RON、EUR、USD、GBP のいずれかである必要があります。EUR、USD、GBP は Netopia アカウントで有効になっている必要があります。それ以外の通貨の場合、チェックアウトで決済方法は表示されません。

Netopia アカウント: 販売ポイントを持つ Netopia Payments の販売者アカウントが必要です。その技術設定から、アカウント署名と、使用する環境（サンドボックスと本番）ごとの公開証明書（.cer）および秘密鍵（.key）を取得してください。Netopia 側で設定する必要はありません。IPN のアドレスは決済リクエストごとに送信されます。

公開ショップ: IPN（確認）URL はインターネットから到達可能である必要があり、ログインや基本認証の背後にあってはなりません。注文は Netopia の IPN によってのみ作成されます。

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

インストール

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

2. アップロードが完了したら Configure をクリックします。後でモジュール一覧から VibeFox Netopia Gateway を探し、Configure をクリックすることもできます。

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

4. Netopia の管理画面で販売ポイントを開き、アカウント署名をコピーして、サンドボックスと本番の証明書および秘密鍵をダウンロードします。署名とファイルの内容全体を設定に貼り付けてください（「設定」を参照）。

5. Enable/Disable を有効にして Save をクリックします。サンドボックスモードで決済をテストしてから、実際の決済を受け付けるために Test mode を無効にしてください。

インストール時に、モジュールは Awaiting Netopia payment と Netopia payment on hold の 2 つの注文ステータスを作成します。PrestaShop は、すべての通貨、国、顧客グループに対して新しい決済モジュールを提供します。これらは Payment > Preferences で制限できます。

設定

すべての設定はモジュールのページにあります: Modules > Module Manager > VibeFox Netopia Gateway > Configure。各セクションには独自の Save ボタンがあり、ページ全体を保存します。項目の上部では、有効な環境のアカウント署名、証明書、秘密鍵が欠けている場合にページが警告し（その場合、チェックアウトで決済方法は表示されません）、テストモードが有効な間は Test mode is on: payments go to the Netopia sandbox and no real money is charged. と表示します。保存時に、無効な証明書や秘密鍵はエラーとともに拒否され、以前の値が保持されます。その他の項目は保存されます。

IPN (confirm) URL

ページ上部に読み取り専用で表示されます。フレンドリー URL が有効な場合、https://your-shop/module/wcp_netopia_gateway/notify のような形式になり、/en/ のような言語コードが付くこともあります。この URL は、すべての決済リクエストで確認 URL として送信されるため、Netopia の管理画面に入力する必要はありません。Netopia はこの URL に IPN を送信します。モジュールは、決済を開始した環境の秘密鍵で IPN を復号し、アカウント署名と決済リクエストを確認します。Netopia は次の操作を報告します。

confirmed: 決済が完了し、請求が確定しました。注文は支払い済みとして作成されるか、保留中の注文が支払い済みとしてマークされます。

paid: 決済が承認されました（事前承認）。Netopia の管理画面で売上確定するまで、注文は Awaiting Netopia payment のままになります。

confirmed_pending, paid_pending: 決済は Netopia で審査中です。注文は Awaiting Netopia payment のままになります。

canceled: 決済はキャンセルされました。保留中の注文はキャンセルされます。注文がない場合、購入者は再度支払うことができます。

credit: Netopia の管理画面で返金が行われました。注文に記録されます。

Netopia のエラーコード（例: カードの拒否）を伴う通知は、保留中の注文を Payment error に設定します。注文がない場合、購入者は再度支払うことができます。復号できない通知、別のアカウント署名を含む通知、またはそのカートの決済リクエストに対応しない通知は拒否され、何も変更されません。

チェックアウト

Enable/Disable: Enable Netopia Payments は、決済方法を有効または無効にします。デフォルト: off。

Title: チェックアウトに表示される決済方法のタイトルです。注文に保存される決済方法の名称にもなります。デフォルト: Card Payment (Netopia)。

Description: チェックアウトに表示される決済方法の説明です。デフォルト: Pay securely with your credit or debit card via Netopia.

Netopia アカウント

Netopia の管理画面で Seller accounts > your point of sale > Technical settings に移動し、アカウント署名をコピーして、各環境の公開証明書（.cer）と秘密鍵（.key）をダウンロードします。ファイルをテキストエディタで開き、BEGIN/END の行を含む内容全体を貼り付けます。

Account signature: 販売者アカウントの署名（形式は XXXX-XXXX-XXXX-XXXX-XXXX）です。サンドボックスと本番で同じものを使用します。

Test mode: Netopia のサンドボックス（sandboxsecure.mobilpay.ro）とサンドボックスのキーを使用します。デフォルト: on。本番のキーで実際の決済を受け付けるには、無効にします。

Sandbox public certificate (.cer): サンドボックスの公開証明書ファイルの内容です。決済リクエストの暗号化に使用されます。

Sandbox private key (.key): サンドボックスの秘密鍵ファイルの内容です。IPN の復号に使用されます。

Live public certificate (.cer): 本番の公開証明書ファイルの内容です。

Live private key (.key): 本番の秘密鍵ファイルの内容です。

保存された秘密鍵は、二度と表示されません。このフィールドは空のままになり、そのヘルプテキストは A private key is saved. で始まります。保存済みのキーを残すには空のままにし、置き換えるには新しいキーを貼り付けます。証明書のフィールドを空にすると、証明書が削除されます。

Clear saved private keys: キーにチェックを入れて Save をクリックすると削除されます。フィールドが空の場合、保存済みのキーは保持されます。

注文

Order status after payment: 支払い済み注文のステータスです。

Processing (Payment accepted): 支払い済み注文に対する PrestaShop の標準ステータスです（デフォルト）。

Completed (Delivered): 支払い済みの注文はすべて配達済みになります。

詳細設定

Debug log: リクエストと IPN の処理を、モジュールフォルダ内の logs/netopia_p_debug.log.php に書き込みます。このファイルはウェブから開くことができません。カード情報、キー、顧客データは記録されません。エラー（拒否された IPN など）は、このオプションがオフの場合でも常に記録されます。デフォルト: off。

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

Delete data on uninstall: モジュールをアンインストールすると、ゲートウェイの設定、モジュールの Netopia 決済記録、ログを削除します。注文は残ります。デフォルト: off。

チェックアウト

支払い手順で、購入者は決済方法（デフォルトは Card Payment (Netopia)）を選択して確定します。次のページには Redirecting you to Netopia for secure payment… と表示され、購入者は自動的に Netopia の決済ページに移動します。代替として Proceed to payment と Cancel（チェックアウトに戻る）のボタンが表示されます。決済リクエストは貴店の Netopia 証明書で暗号化され、カートの通貨によるカート合計、Cart # とカート番号、請求先と配送先の連絡先情報を含みます。サンドボックスモードでは、リクエストは Netopia のサンドボックスに送信されます。この時点ではまだ注文は存在しません。

購入者は Netopia のページでカード決済を行い、貴店に戻ります。戻る操作そのものでは、注文が作成されたり支払われたりすることはありません。注文は、Netopia が IPN で確認した後にのみ支払い済みとしてマークされます。注文が存在する場合、購入者は通常の注文確認ページを見ます。保留中の注文の場合は Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. と表示されます。保留状態の注文の場合は Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. と表示されます。キャンセルされた注文の場合は The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. と表示されます。決済エラーのある注文の場合は The payment was declined by Netopia. と表示されます。

購入者が戻った時点で IPN がまだ届いていない場合、Payment confirmation ページに「まだ確認されていません」と同じ文言が表示され、Check again と Back to checkout のボタンが表示されます。IPN が届き次第、注文が作成されます。

注文が作成される前に Netopia がキャンセルまたは拒否を報告した場合、購入者は The payment was cancelled at Netopia. You can try again or choose another payment method. または The payment was declined by Netopia. You can try again or choose another payment method. と表示されたチェックアウトに戻ります。カートは保持されます。新しい試行ごとに新しい決済リクエストが作成されます。そのカートの以前のリクエストも有効なままのため、以前の試行の遅延した IPN も記録されます。

モジュールが正しく設定されていない場合、購入者は Netopia gateway is not configured properly. Please contact the store administrator. と表示されたチェックアウトに留まります。その他のメッセージは、通貨が続く Netopia cannot process payments in、This order has nothing to pay.、Payment encryption failed. Please try again or contact support. です。技術的な理由はログに記録されます。

IPN は、ショップがメンテナンスモードの間も機能し、ショップの国別制限によってブロックされることはありません。

モジュールは、Netopia v1 カードプロトコルによるカード決済のみを受け付けます。PrestaShop からの返金や売上確定、保存済みカードやワンクリック決済、サブスクリプション、分割払いその他の決済方法には対応しておらず、Netopia API v2 にも対応していません。

注文と返金

注文ステータス

まだ注文がありません: 購入者は Netopia に移動しましたが、まだ支払っていないか、Netopia がまだ IPN を送信していません。カートのみが存在します。

Payment accepted or Delivered: Netopia が決済を確認しました。ステータスは Order status after payment に従います。決済は Netopia の取引を取引 ID として記録され、プライベートメモには金額、マスクされたカード番号、Netopia の取引が表示されます。サンドボックスの決済には [sandbox] が付きます。

Awaiting Netopia payment: 決済は、Netopia の管理画面で売上確定を待っている事前承認であるか、Netopia で審査中です。まだ決済は記録されていません。Netopia が確認すると、注文は支払い済みのステータスに移ります。

Netopia payment on hold: 請求金額または通貨がカートまたは注文と異なる、決済の一部のみが売上確定された、キャンセル済みの注文または別の決済方法による注文の決済を Netopia が確認した、または店舗が本番モードの間にサンドボックス（テスト）の決済が確認された（実際の入金はないため、決済は記録されません）。メモに理由が説明されています。Netopia の管理画面で取引を確認してから、注文を処理するか、そこで決済を返金してください。

Payment error: 保留中の注文について、カードの拒否など、Netopia がエラーを報告しました。

Canceled: Netopia が保留中の注文の決済をキャンセルしました。

Refunded: 決済が Netopia の管理画面で全額返金されました。

遅延した通知によって、支払い済みまたは完了した注文の状態が下がることはありません。すでに支払い済みの注文について Netopia が別の決済を確認した場合、メモで重複分を Netopia の管理画面から返金するよう促されます。

Netopia ブロック

注文ページには Netopia Payments ブロックが表示され、Netopia の取引、環境（サンドボックスまたは本番）、決済リクエスト、最後の IPN アクション、マスクされたカード、支払い済み・返金済み・残りの金額、返金履歴が表示されます。このブロックは読み取り専用です。

返金

返金は PrestaShop からは行えません。Netopia v1 カードプロトコルには返金の呼び出しがないためです。Netopia の管理画面で取引を返金してください。その後 Netopia がクレジットの IPN を送信し、モジュールは Netopia refund processed: のメモと金額を付けて、返金を注文に自動的に記録します。部分返金では注文ステータスは維持されます。返金できる残額がなくなると、注文は Refunded に設定されます。EUR、USD、GBP の注文では、Netopia が RON で報告する返金額が注文の通貨に換算されます。返金が二重に記録されることはなく、残額を超えて記録されることもありません。Netopia が返金でエラーを報告した場合は、メモが追加されるだけです。

モジュールはクレジットメモを作成せず、商品の在庫を戻すこともしません。注文ページの PrestaShop 標準の返金ボタンは、Netopia を通じて資金を返金しません。

ライセンスキー

モジュールは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Netopia Gateway は、Modules > Module Manager > VibeFox Netopia Gateway > Configure の最初のブロックで、設定の上に表示されます。キーを License key に入力し、Activate をクリックしてください。その後、ブロックにはキーがマスクされた状態、ステータス（例: ライセンスの有効期限日と貴ドメイン）、ステータスを再確認するための Check now、別のキーを入力するための Change key、このストアからキーを削除するための Remove key のボタンが表示されます。その下には Product: presta-payment-netopia の行と、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 のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウト時に Netopia は購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、その決済方法は貴方にも非表示になります。キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文は影響を受けません。すでに開始された決済は引き続き確認され、Netopia の管理画面で行われた返金も引き続き記録されます。

ライセンスが期限切れになっても、モジュールは動作し続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日に 1 回、その後は週に 1 回です。cron ジョブは必要ありません。モジュールのアンインストールまたはリセットを行うと、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに Netopia が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、有効な環境が完全に設定されていること（テストモードではサンドボックスの Account signature と証明書および秘密鍵、本番モードでは本番の同じ項目）、カートの通貨が RON、EUR、USD、GBP のいずれかであることを確認してください。設定ページでは、不足している項目があると警告が表示されます。Payment > Preferences で、モジュールがカートの通貨、購入者の国、購入者のグループに対して許可されているかも確認してください。

決済は完了したが、注文が作成されていない: IPN がショップに届かなかったか、拒否されました。設定の IPN（確認）URL がインターネットから到達可能か（基本認証やファイアウォールがないか）を確認してください。モジュールページの Log 欄を確認してください。拒否された IPN は常に記録されます。すべての IPN を確認するには Debug log をオンにします。購入者が戻っただけでは、注文は作成されません。

ログに failed decrypting data と表示される: 秘密鍵が、Netopia が使用した証明書と一致しません。IPN は各環境の保存済み秘密鍵で復号されるため、もう一方の環境の決済がまだ未完了の間は、そのキーを保存したままにしておいてください。Netopia は IPN を再試行します。

ログに signature mismatch と表示される: Account signature が、IPN を送信した販売ポイントと異なります。Netopia の管理画面から再度コピーしてください。

ログに unknown payment request と表示される: IPN が、ショップがそのカートについてその環境（サンドボックスまたは本番）で行った決済リクエストに対応していません。何も変更されません。

ログに gateway not configured と表示される: 秘密鍵またはアカウント署名が保存されていません。Netopia は IPN を再試行し、設定が完了すると決済が記録されます。

ログに busy, retry later or processing failed と表示される: そのカートは同じ瞬間に別のリクエストで処理中だったか、注文を作成できませんでした（例: モジュールが無効になっている）。Netopia は IPN を自動的に再試行します。

証明書または秘密鍵の保存時のエラー: 貼り付けたテキストが有効な証明書やキーではありません。BEGIN/END の行を含め、ファイルの内容全体を貼り付けてください。以前の値は保持されています。

決済後に注文が Netopia payment on hold になる: 注文のプライベートメモを確認してください（「注文ステータス」を参照）。金額または通貨が異なった、一部のみが売上確定された、注文がキャンセルされていた、または店舗が本番モードの間にサンドボックスの決済が確認された、のいずれかです。Netopia の管理画面で取引を確認してください。

Netopia で行った返金が注文に表示されない: クレジットの IPN がショップに届かなかったか、拒否されました。ログを確認してください。

アンインストール

Modules > Module Manager に移動し、VibeFox Netopia Gateway の横にあるメニューを開いて、Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは常に削除されます。Delete data on uninstall がオンの場合、ゲートウェイの設定（保存されたキーを含む）、注文の Netopia ブロックに表示されるモジュールの Netopia 決済記録、ログが削除されます。オフの場合は、後で再インストールできるようにすべて保持されます。注文と、Awaiting Netopia payment および Netopia payment on hold の注文ステータスは削除されません。既存の注文は、決済メモと取引 ID を保持します。

Netopia Payments と mobilPay は、それぞれの所有者の商標です。本モジュールは Netopia Payments とは提携しておらず、同社の承認も受けていません。