VibeFox Netopia for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降がインストールされ、有効になっていること。

PHP: 8.0 以降で、OpenSSL と DOM の拡張機能が有効であること。

通貨: ストアまたは注文の通貨は 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. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_netopia_gateway フォルダを /wp-content/plugins/ にアップロードすることもできます。

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

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

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

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

6. Enable/Disable を有効にします。サンドボックスモードでテスト決済を行い、その後、実際の決済を受け付けるために Test mode のチェックを外します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Netopia Payments。フィールドの上部では、有効な環境のアカウント署名、証明書、秘密鍵が不足している場合に警告が表示されます（その場合、決済方法はチェックアウトで非表示になります）。テストモードが有効な間は Test mode is on: payments go to the Netopia sandbox and no real money is charged. が表示されます。決済方法の一覧では、有効な環境の設定が完了するまで Netopia に設定が必要と表示されます。保存時、無効な証明書または秘密鍵はエラーとともに拒否され、以前の値が保持されます。

IPN (confirm) URL

設定の上部に読み取り専用で表示されます。形式は https://your-site/wc-api/netopia_payment_callback/ のようになります。決済リクエストごとに確認 URL として送信されるため、Netopia の管理画面に入力する必要はありません。Netopia は IPN をこの URL に送信します。プラグインは有効な環境の秘密鍵で復号し、アカウント署名と決済リクエストを検証します。Netopia は次の操作を報告します：

Netopia のエラーコード（カードの拒否など）を含む通知は、未払いの注文を Failed としてマークします。復号できない通知、別のアカウント署名を持つ通知、またはその注文の決済リクエストに対応しない通知は拒否され、何も変更されません。

チェックアウト

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

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: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys。決済ページと鍵のペアを切り替えます。デフォルト: オン。本番の鍵で実際の決済を受け付けるには、オフにします。

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

Sandbox private key (.key): サンドボックスの秘密鍵ファイルの内容。IPN の復号に使用されます。保存後は再表示されず、フィールドには A private key is saved. と表示されます。保存済みの鍵を維持する場合は空欄のままにし、置き換える場合は新しい鍵を貼り付けます。

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

Live private key (.key): 本番環境の秘密鍵ファイルの内容。保存後は再表示されません。保存済みの鍵を維持する場合は空欄のままにします。

注文

Order status after payment: 発送が必要な支払い済み注文のステータス。仮想商品またはダウンロード商品のみの注文は、いずれにしても WooCommerce が完了させます。ステータスは 1 回の変更で設定され、顧客へのメールは 1 通です。

詳細設定

Debug log: Log requests and IPN processing は、WooCommerce > Status > Logs に、ソース wcp_netopia_gateway として書き込みます。カード情報、鍵、顧客の詳細はログに記録されません。拒否された IPN などのエラーは、このオプションがオフでも常に記録されます。デフォルト: オフ。

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept)。デフォルト: オフ。

チェックアウト

顧客は決済方法（デフォルトは Card Payment (Netopia)）を選択して注文します。次のページには Redirecting you to Netopia for secure payment… が表示され、顧客は自動的に Netopia の決済ページに移動します。代替として Proceed to payment と Cancel order のボタンがあります。決済リクエストは貴店の Netopia 証明書で暗号化され、注文通貨での注文合計、Order # と注文番号、請求先および配送先の連絡先情報を含みます。サンドボックスモードでは、リクエストは Netopia のサンドボックスに送信されます。

顧客は Netopia のページでカード決済を行い、貴店の注文受付ページに戻ります。戻っただけでは注文は支払い済みになりません。注文は、Netopia が IPN で確認した後にのみ支払い済みとしてマークされます。それまでは、注文受付ページに Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. と表示されます。On hold の注文の場合は 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. と表示されます。

カードが拒否された場合、注文は Failed としてマークされ、顧客は注文ページから再度支払うことができます。プラグインが正しく設定されていない場合、決済ページには Netopia gateway is not configured properly. Please contact the store administrator. と表示されます。

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

プラグインは Netopia v1 カードプロトコルを通じてのみカード決済を受け付けます。WooCommerce からの返金や売上確定には対応しておらず、保存済みカードやワンクリック決済、サブスクリプション、分割払い、SMS、銀行振込、暗号資産決済にも対応していません。また、Netopia API v2 にも対応していません。

注文と返金

注文ステータス

Pending payment: 顧客は Netopia に移動しましたが、まだ支払っていないか、Netopia がまだ IPN を送信していません。

Processing or Completed: Netopia が決済を確認しました。ステータスは Order status after payment に従います。注文メモには、金額、マスクされたカード番号、Netopia の取引が表示されます。サンドボックスの決済には [sandbox] が付きます。取引 ID は Netopia の取引 ID です。

On hold: 決済は Netopia の管理画面で売上確定を待つ事前承認であるか、Netopia で審査中です。Netopia が確認すると、注文は支払い済みとしてマークされます。請求金額または通貨が注文と異なる場合、決済の一部のみが売上確定された場合、またはキャンセル済みの注文に対する決済を Netopia が確認した場合にも、注文は On hold になります。注文メモに理由が記載されています。Netopia の管理画面で取引を確認し、注文を手動で完了するか返金してください。

Failed: Netopia がカードの拒否などのエラーを報告しました。顧客は再度支払うことができます。

Cancelled: Netopia が決済をキャンセルしたか、顧客が Netopia に移動する前に Cancel order をクリックしました。

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

返金

返金は WooCommerce からは行えません。Netopia v1 カードプロトコルには返金の呼び出しがないため、Refund via ボタンは存在しません。Netopia の管理画面で取引を返金してください。その後、Netopia から貸方の IPN が送信され、プラグインは理由 Refund initiated by Netopia. とともに注文に返金を自動的に記録します。部分返金では注文ステータスは変わりません。返金できる金額がなくなると、WooCommerce は注文を Refunded としてマークします。EUR、USD、GBP の注文では、Netopia が RON で報告する返金額を注文通貨に換算し直します。返金が二重に記録されたり、残額を超えて記録されたりすることはありません。在庫は自動的に戻されません。

ライセンスキー

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

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

有効なキーがない場合、Netopia はチェックアウトで顧客に表示されません。それでも決済が開始された場合、顧客には This payment method is not available. Please choose another one. と表示されます。ログイン中のストア管理者には、決済方法が (unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグイン画面と WooCommerce の画面には通知が表示されます。既存の注文は影響を受けません。開始済みの決済は引き続き確認され、Netopia の管理画面で行われた返金も引き続き記録されます。

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

トラブルシューティング

チェックアウトに Netopia が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択中のモードの環境が完了していること（テストモードではサンドボックスの Account signature と証明書および秘密鍵、本番モードでは本番環境のもの）、そして店舗または注文の通貨が RON、EUR、USD、GBP のいずれかであることを確認してください。設定ページでは、不足しているものがあると警告が表示されます。

決済は完了したが、注文が Pending payment のまま: IPN が貴店に届かなかったか、拒否されました。設定の IPN（確認）URL がインターネットから到達可能であることを確認してください（メンテナンスモード、ベーシック認証、ファイアウォールがないこと）。Debug log をオンにし、WooCommerce > Status > Logs でソース wcp_netopia_gateway の IPN の行を探してください。顧客が戻っただけでは、注文が支払い済みになることはありません。

Log shows failed decrypting data: 秘密鍵が、Netopia が使用した環境の証明書と一致しません。IPN は有効な環境の鍵で復号されます。テストモードが切り替わる前に開始された決済の場合は、もう一方の環境の鍵で復号されます。Netopia が再試行します。

Log shows signature mismatch: Account signature が、IPN を送信した販売ポイントと一致しません。Netopia の管理画面から再度コピーしてください。

Log shows unknown payment request: この IPN は、貴店がその環境（サンドボックスまたは本番）でその注文について行った決済リクエストに対応していません。何も変更されません。

Log shows gateway not configured: 秘密鍵またはアカウント署名がありません。Netopia が IPN を再試行し、設定が完了すると決済が 1 回記録されます。

Error on save about the certificate or private key: 貼り付けたテキストは有効な証明書または鍵ではありません。BEGIN/END の行を含め、ファイルの内容全体を貼り付けてください。以前の値は保持されています。

Order is On hold after payment: 注文メモを確認してください。決済は事前承認である可能性や、審査中である可能性があります。金額または通貨が異なっていた、一部のみ売上確定された、注文がキャンセルされていた、または店舗が本番モードの間にサンドボックスの決済が確認された可能性があります（実際の入金はありません）。Netopia の管理画面で取引を確認してください。

A refund made in Netopia does not appear on the order: 貸方の IPN が店舗に届かなかったか、拒否されました。ログを確認してください。必要に応じて、WooCommerce で手動返金を作成してください。

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

アンインストール

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

Netopia Payments と mobilPay は、それぞれの所有者の商標です。本プラグインは Netopia Payments と提携しておらず、同社による承認もありません。