VibeFox Nets Nexi for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降、インストールされ有効であること。WooCommerce がなければプラグインを有効化できません。

PHP: 8.0 以降。

Nets アカウント: Nets Easy アカウントの秘密鍵（テストと本番）が必要です。使用するのは秘密鍵のみです。購入者は Nets がホストする決済ページで支払うため、チェックアウト用のキーは必要ありません。

通貨と決済方法: プラグインは通貨や国を制限しません。Nets アカウントで有効になっている通貨を使用してください。サポートされていない通貨は、決済の作成時に Nets が報告します。購入者に表示される決済方法は、Nets との契約、国、通貨によって異なります。

Webhook 用の HTTPS: Nets が呼び出せるのは、256 文字以内で「&」を含まない公開 HTTPS アドレスだけです。そのため、Webhook を受信するには、サイトが HTTPS と分かりやすいパーマリンクを使用している必要があります。それ以外のサイトでは、購入者がストアに戻ったとき、または注文アクションによって決済が確認されます。

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

インストール

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

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

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

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

5. Nets Easy のテストポータルからテスト用の秘密鍵をコピーし、Test Secret Key に貼り付けます（設定の項を参照）。

6. Enable/Disable を有効にし、Test Mode はオンのままテスト注文を行います。その後、本番用の秘密鍵を入力し、Test Mode のチェックを外します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Nets Nexi (Nordics)。フィールドの上部では、選択したモードの秘密鍵がない場合に警告が表示されます（その場合、決済方法はチェックアウトで非表示になります）。テストモードが有効な間は Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. が表示されます。決済方法の一覧では、選択したモードに秘密鍵が設定されるまで、Nets Nexi に設定が必要と表示されます。

一般

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

Title: チェックアウト時に購入者に表示される決済方法のタイトル。デフォルト: Nets Easy。

Description: チェックアウト時に購入者に表示される決済方法の説明。デフォルト: Pay securely with Nets Easy。

API キー

Nets Easy ポータルの Company > Integration から秘密鍵をコピーします。テスト用の鍵はテストポータル（test.portal.dibspayment.eu）、本番用の鍵は本番ポータル（portal.dibspayment.eu）から取得します。チェックアウト用のキーは不要です。

Test Mode: Enable test mode。テストモードでは、テスト用の秘密鍵を使って test.api.dibspayment.eu に接続します。本番モードでは、本番用の秘密鍵を使って api.dibspayment.eu に接続します。注文の返金とキャプチャは、常に注文が支払われた環境を使用します。デフォルト: オン。

Test Secret Key: Nets テスト環境の秘密 API キーです。

Live Secret Key: Nets 本番環境の秘密 API キーです。

決済

Nets の通知（Webhook）は、決済のたびに自動的に登録されます。Nets ポータルで設定する項目はありません。このセクションには Webhook URL が表示されます。形式は https://your-site/wc-api/nng_nets_nexi/ のようになります。URL が公開された HTTPS アドレスでない場合、このセクションにはサイトが Webhook を受信できないという警告が表示されます。その場合、決済は購入者がストアに戻ったとき、または注文アクション Nets: check payment status and capture によって確認されます。次のイベントが登録されます：

各 Webhook には、プラグインが注文ごとに生成したランダムな秘密情報を含める必要があります。正しい秘密情報のない Webhook は拒否されます。Webhook はどの決済が変更されたかをプラグインに伝えるだけです。決済そのものは、常に秘密鍵を使って Nets API から読み取られます。

Order Status After Payment: Nets が決済を確認して請求した後の注文のステータス。ステータスは即座に設定されるため、購入者に届くメールは 1 通だけです。

詳細設定

Debug log: Enable debug logging は、API 呼び出しと決済ステータスの変更を WooCommerce > Status > Logs に記録します。ソースは wcp_nets_nexi_gateway です。エラーは常に記録されます。キーや顧客データは記録されません。デフォルト: オフ。

Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted。プラグインを無効化しても何も削除されません。注文に保存された決済データは常に残ります。デフォルト: オフ。

チェックアウト

購入者は決済方法（デフォルトは Nets Easy）を選択して注文します。プラグインは、注文明細、送料、手数料を注文通貨で含む Nets 決済を作成し、購入者を Nets のホスト型決済ページに移動させます。Nets が形式を受け入れた場合、購入者のメールアドレス、氏名、住所、電話番号が Nets に渡されます。利用規約のページは Nets のページにリンクされます。テストモードでは、チェックアウトに Test mode: no real money will be charged. と表示されます。

購入者は決済を行い、貴店の注文受付ページに戻ります。注文は Nets が確認した後にのみ支払い済みになります。プラグインは Nets API から決済を読み取り、予約された金額と通貨を注文と照合し、仮押さえを請求してから、注文を完了させます。これは Webhook、購入者が注文受付ページに戻ったとき、または注文アクション Nets: check payment status and capture によって行われます。

購入者が Nets のページでキャンセルすると、チェックアウトまたは Pay for order ページに戻り、The Nets payment was cancelled. You can try again or choose another payment method. と表示されます。購入者は未払いの注文を再度支払うことができます。プラグインはまず前回の決済を確認し、すでに支払い済みであれば注文を確認します。そうでなければ、新しいセッションを開始する前に、前回の Nets セッションを閉じます。注文の決済がストアによる確認のために保留されている場合、購入者には A payment for this order is already being reviewed by the shop. Please contact us instead of paying again. と表示されます。

Nets が決済を開始できない場合、購入者には短いメッセージが表示されます。例えば Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. や The payment service could not be reached. Please try again in a moment. などです。詳細はログに記録されます。

この決済方法は、クラシックチェックアウト、Checkout ブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）と互換性があります。

プラグインはホスト型決済ページのみを使用します。ページに組み込まれた Nets チェックアウト、サブスクリプションや定期決済、保存済みカード、請求書手数料、承認のみのモード、配送ごとの部分的なキャプチャには対応していません。

注文と返金

注文ステータス

Pending payment: 購入者は Nets に移動しましたが、まだ支払っていません。注文メモには Nets 決済 ID、金額、環境が表示されます。

Processing or Completed: Nets が決済を確認し、請求しました。ステータスは Order Status After Payment に従います。注文メモには決済 ID、請求 ID、決済方法が表示されます。取引 ID は Nets の決済 ID です。

On hold: Nets 側の金額または通貨が注文と異なる（キャプチャされていない）、キャプチャが拒否された、または注文のキャンセル後に購入者が支払った（予約済みでキャプチャされていない）場合です。注文メモに理由が説明されています。注文を確認した後、注文アクション Nets: check payment status and capture でキャプチャするか、Nets ポータルで予約をキャンセルしてください。

Cancelled: 注文の最新の決済の予約がキャンセルされました（例：Nets ポータルでのキャンセル）。

繰り返される Webhook や再読み込みによって、二重に請求されたり、重複したメモ、在庫の減算、メールが追加されたりすることはありません。支払い、返金、または支払い後にキャンセルされた注文が再び開かれることもありません。すでに支払い済みの注文に対して古い決済リンクが完了した場合、2 回目の予約は自動的に解放されます。すでに請求されていた場合は、メモで Nets ポータルから返金するよう求められます。

注文アクション

Nets の決済がある未払いの注文では、注文アクション一覧に Nets: check payment status and capture が表示されます。このアクションは Nets から決済を読み取り、一致する予約をキャプチャします。何も変わらない場合は、購入者がまだ決済を完了していないなど、理由がメモに表示されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Nets Easy をクリックします（ボタンには決済方法のタイトルが使われます）。決済が請求された後は、全額返金と部分返金に対応しています。予約のみの決済は Nets ポータルでキャンセルできます。返金は、注文が支払われた環境での請求に対して行われます。Nets が返金を受け付けない場合、WooCommerce はエラーを表示し、返金は記録されません。返金に成功すると、Nets の返金 ID とともに注文メモに追加されます。

Nets ポータルで直接行った返金は、WooCommerce の返金にはなりません。必要に応じて、Refund via Nets Easy を使わずに WooCommerce で手動返金を作成してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Nets Nexi が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択したモードに秘密鍵があること（テストモードでは Test Secret Key、本番モードでは Live Secret Key）を確認してください。キーがない場合、設定ページに警告が表示されます。

決済は完了したが、注文が Pending payment のまま: Webhook が貴店に届いていません。サイトが HTTPS と分かりやすいパーマリンクを使用していること、Payment セクションの Webhook URL が「&」を含まない公開 HTTPS アドレスであること、決済の環境の秘密鍵が設定されていることを確認してください。その後、注文アクション Nets: check payment status and capture を使用します。購入者が注文受付ページに戻ったときにも、注文は確認されます。

Webhook answers Unauthorized: Webhook にその注文の秘密情報が含まれていませんでした。Webhook は、決済とともに登録された秘密情報がある場合にのみ受け付けられます。

Webhook answers Busy, retry later, Payment lookup failed または Payment not reserved yet: 別のリクエストが注文を更新中だった、Nets API に接続できなかった、または予約がまだ表示されていなかった、のいずれかです。Nets は Webhook を自動的に再試行します。

購入者が注文時にエラーを見る: Debug log をオンにし、WooCommerce > Status > Logs でソース wcp_nets_nexi_gateway を確認してください。This payment method is temporarily unavailable. Please choose another payment method. は、通常、秘密鍵が間違っているか未設定であることを意味します。拒否された通貨は、Nets がログに報告します。

Order is On hold after payment: 注文メモを確認してください。キャプチャが拒否された場合は、注文アクション Nets: check payment status and capture で再試行するか、Nets ポータルで請求してください。金額または通貨が異なる場合は、Nets ポータルで決済を確認してください。購入者がキャンセル後に支払った場合は、注文を確認し、予約をキャプチャするかキャンセルしてください。

Refund via Nets Easy が表示されない、または失敗する: 返金は、決済が請求された後にのみ可能です。注文メモで請求を確認してください。返金は、注文が支払われた環境の秘密鍵を使用するため、その鍵が設定されている必要があります。

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

アンインストール

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

Nets、Nets Easy、Nexi は、それぞれの所有者の商標です。本プラグインは Nets や Nexi と提携しておらず、両社の承認も受けていません。