VibeFox Nets Nexi for PrestaShop — ヘルプ
要件
PrestaShop: 8.0 から 9.x。
PHP: cURL 拡張機能付きの 8.0 以降。古いバージョンの PHP や cURL がない環境では、モジュールはインストールされません。
Nets アカウント: Nets Easy アカウントの秘密鍵（テストと本番）が必要です。使用されるのは秘密鍵だけです。顧客は Nets がホストする決済ページで支払うため、チェックアウト用のキーは不要です。
通貨と決済方法: モジュール自体は通貨や国を制限しません。Nets アカウントで有効になっている通貨を使用してください。サポートされていない通貨は、決済の作成時に Nets から通知されます。顧客に表示される決済方法は、Nets との契約、国、通貨によって異なります。
Webhook 用の HTTPS: Nets が呼び出すのは、256 文字以内で "&" を含まない公開 HTTPS アドレスのみです。そのため、Webhook を受信するには、ストアで HTTPS と分かりやすい URL が必要です。Webhook がなくても、顧客がストアに戻った時、または注文ページでのステータス確認によって決済は確認されます。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインでのみ使用できます。
インストール
1. 管理画面で Modules > Module Manager に進み、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら Configure をクリックします。または、後でモジュール一覧から VibeFox Nets Nexi Gateway を探して Configure をクリックします。
3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーの項を参照）。
4. Nets Easy のテストポータルからテスト用の秘密鍵をコピーし、Test Secret Key に貼り付けます（設定を参照）。
5. Enable/Disable をオンにし、Test Mode はオンのまま Save をクリックして、テスト注文を行います。その後、本番用の秘密鍵を入力し、Test Mode をオフにします。
インストール時、モジュールは注文ステータス Nets payment on hold を作成します。PrestaShop は、新しい決済モジュールをインストール時に有効だった国にのみ関連付けます。Payment > Preferences で、モジュールの通貨、国、顧客グループを確認してください。
設定
すべての設定はモジュールのページにあります: Modules > Module Manager > VibeFox Nets Nexi Gateway > Configure。各セクションには個別の Save ボタンがあり、ページ全体が保存されます。フィールドの上には、選択したモードの秘密鍵がない場合に Nets Nexi: enter the Test Secret Key — the payment method is hidden at checkout until the key of the selected mode is set. という警告が表示され、テストモードがオンの間は Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. と表示されます。
Nets Nexi（北欧）
セクションのタイトルには、選択したモードに応じて TEST または LIVE と表示されます。
Enable/Disable: Enable Nets Nexi Gateway で決済方法のオン・オフを切り替えます。デフォルト: オフ。
Title: チェックアウト時に顧客に表示される決済方法のタイトルです。注文に保存される決済方法の名前にもなります。デフォルト: Nets Easy。必須: タイトルが空だと Enter a title for the payment method. というエラーが表示され、何も保存されません。
Description: チェックアウト時に顧客に表示される決済方法の説明です。デフォルト: Pay securely with Nets Easy。
API キー
秘密鍵は Nets Easy ポータルの Company > Integration からコピーします。テスト用キーはテストポータル（test.portal.dibspayment.eu）から、本番用キーは本番ポータル（portal.dibspayment.eu）から取得します。チェックアウト用のキーは不要です。
Test Mode: テストモードでは test.api.dibspayment.eu とテスト用秘密鍵を、本番モードでは api.dibspayment.eu と本番用秘密鍵を使用します。注文の返金とキャプチャは、常に注文が支払われた環境を使用します。デフォルト: オン。オンの間、顧客には決済方法の下に Test mode: no real money will be charged. と表示されます。
Test Secret Key: Nets テスト環境の秘密 API キーです。
Live Secret Key: Nets 本番環境の秘密 API キーです。
保存済みのキーは再表示されません。フィールドは空のままで、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。
Clear saved secrets: キーにチェックを入れて Save をクリックすると削除されます。フィールドが空の場合は、保存済みの値が保持されます。
決済
Webhooks: Nets の通知（Webhook）は、決済のたびに自動的に登録されます。Nets ポータルで設定する必要はありません。このセクションには、通知の送信先アドレスが表示されます。分かりやすい URL の場合、たとえば https://your-shop/module/wcp_nets_nexi_gateway/webhook のようになり、/en/ などの言語コードが付くこともあります。アドレスが公開 HTTPS アドレスでない場合、このセクションには、ストアで Webhook を受信できないという警告が表示されます。その場合、決済は顧客がストアに戻った時、または注文ページの Nets: check payment status and capture: によって確認されます。以下のイベントが登録されます:
各 Webhook には、モジュールがその決済用に作成したランダムな秘密情報を含める必要があります。正しい秘密情報がない Webhook は拒否されます。Webhook は、どの決済が変化したかをモジュールに伝えるだけです。決済自体は、支払いが行われた環境の秘密鍵を使って、常に Nets API から読み取られます。Webhook は、ストアがメンテナンスモードの間も動作し、ストアの国による制限にもブロックされません。
Order Status After Payment: Nets が決済を確認して請求した後の注文のステータスです。
詳細設定
Debug log: API 呼び出しと決済ステータスの変更を、モジュールフォルダ内の logs/nng_debug.log.php に記録します。このファイルはウェブから開くことはできません。エラーは常に記録されます。キーや顧客データは記録されません。デフォルト: オフ。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。
Delete Data on Uninstall: モジュールをアンインストールすると、モジュールの設定とログを削除します。注文に保存された決済データは常に保持されます。デフォルト: オフ。
チェックアウト
支払いステップで、顧客は決済方法（デフォルトは Nets Easy）を選んで確定します。モジュールは、カートの合計金額をカートの通貨で Nets の決済として作成し、商品、配送料、ギフトラッピング、割引を注文明細として送信して、顧客を Nets のホスト型決済ページに移動させます。Nets 上の決済参照番号はカート番号です。顧客のメールアドレス、氏名、住所、電話番号は、Nets が形式を受け付けた場合に Nets に渡されます。チェックアウトの利用規約ページは Nets のページにリンクされます（未設定の場合はストアのホームページ）。この時点ではまだ注文は存在しません。
決済後、顧客は貴店に戻ります。注文は、Nets が確認した後にのみ支払い済みとしてマークされます。モジュールは Nets API から決済を読み取り、仮押さえされた金額と通貨をカートと比較し、仮押さえを請求してから注文を作成します。これは Webhook または顧客が戻った時のいずれか早い方で行われます。その後、顧客には標準の注文確認ページが表示されます。まだ決済を確認できない場合（Nets に接続できない、またはその時点で別のリクエストが確認中の場合）、Payment confirmation ページに Your Nets payment is being confirmed. Your order will be created as soon as it is confirmed — please do not pay again. と表示され、Check again と Back to checkout のボタンが表示されます。
顧客が Nets のページでキャンセルした場合、The Nets payment was cancelled. You can try again or choose another payment method. と表示されてチェックアウトに戻ります。何も支払われていない場合のメッセージは The payment was not completed. You can try again or choose another payment method. です。カートは保持されます。再試行時、モジュールはまず前回の決済を確認します。すでに支払い済みであれば、新しい決済ではなく注文が作成されます。そうでなければ、新しいセッションを開始する前に、前回の Nets セッションが閉じられます。
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.、This payment method is temporarily unavailable. Please choose another payment method.、The payment service could not be reached. Please try again in a moment. などです。カートの合計金額が 0 の場合は The order total must be greater than zero to pay with Nets. と表示されます。詳細はログに記録されます。
モジュールはホスト型決済ページのみを使用します。ページに組み込まれた Nets チェックアウト、サブスクリプションや定期決済、保存済みカード、請求書手数料、承認のみのモード、配送ごとの部分キャプチャには対応していません。
注文と返金
注文ステータス
No order yet: 顧客は Nets に移動しましたが、まだ支払っていないか、決済がまだ確認されていません。カートのみが存在します。
Payment accepted or Delivered: Nets が決済を確認し、請求しました。ステータスは Order Status After Payment に従います。決済は Nets の決済 ID をトランザクション ID として記録され、メモには決済 ID、請求 ID、決済方法が表示されます。
Nets payment on hold: Nets 上の金額または通貨がカートと異なる（キャプチャされていない）、キャプチャが拒否された、または注文がキャンセルされた後に顧客が支払った（仮押さえされたが、キャプチャされていない）場合です。メモに理由が記載されます。自動でキャプチャされることはありません。注文を確認した後、Nets: check payment status and capture: でキャプチャするか、Nets ポータルで仮押さえをキャンセルしてください。
Canceled: 保留中の注文の仮押さえがキャンセルされました（例: Nets ポータルでのキャンセル）。
Refunded: 決済がモジュールを通じて全額返金されました。
繰り返される Webhook やページの再読み込みによって、二重に請求されたり重複したメモが追加されることはありません。また、支払い済みの注文が Nets のイベントによって再び変更されることはありません。すでに支払い済みの注文に対して古い決済リンクが完了した場合、2 回目の仮押さえは自動的に解放されます。すでに請求されていた場合は、Nets ポータルで返金するようメモで通知されます。
Nets Easy 決済ブロック
注文ページには Nets Easy payment ブロックが表示されます。決済 ID、請求 ID、環境（テスト決済には Test environment バッジ付き）、ステータス、Nets で仮押さえおよび請求された金額、注文合計と返金額、返金履歴、注文の Nets notes が含まれます。ブロックのボタンは、注文を編集できるすべての従業員が使用できます。モジュールのページへのアクセスは必要ありません。
Nets: check payment status and capture: 未払いの注文に表示されます。Nets から決済を読み取り、注文に一致する仮押さえをキャプチャします。キャプチャの失敗後や、保留中の注文を確認した後にも使用できます。何も変わらない場合は、たとえば顧客がまだ決済を完了していないなど、理由がメモに表示されます。
返金
Nets Easy payment ブロックで金額を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて理由を入力し、Refund via Nets をクリックします。確認の質問 Refund this amount through Nets? This cannot be undone. に同意してください。全額返金と部分返金は、決済が請求された後にサポートされます。仮押さえのみの決済は、Nets ポータルでキャンセルできます。返金は、決済が行われた環境での注文の請求に対して行われます。Nets が返金を受け付けない場合、ブロックにエラーが表示され、返金は記録されません。返金が成功すると、Nets の返金 ID とともに返金履歴とメモに追加されます。全額返金では注文が Refunded になります。部分返金ではステータスは変わりません。
モジュールはクレジットメモを作成しません。注文ページの標準の PrestaShop の返金ボタンでは、Nets を通じて返金されません。Nets ポータルで行われた返金は同期されません。必要に応じて注文を手動で更新してください。
ライセンスキー
モジュールは、vibefox.net で入手した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Nets Nexi Gateway は Modules > Module Manager > VibeFox Nets Nexi Gateway > Configure ページの最上部にあり、設定より上に表示されます。License key にキーを入力し、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（ライセンスの有効期限日やドメインなど）、ステータスを再確認する Check now、別のキーを入力する Change key、このショップからキーを削除する Remove key のボタンが表示されます。その下には Product: presta-payment-nets-nexi の行と、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 のアカウントで枠を解放してください。
有効なキーがない場合、チェックアウトで顧客に Nets は表示されません。それでも決済が開始された場合、顧客には This payment method is not available. Please choose another one. と表示されます。PrestaShop のストアフロントは、管理画面にログインしていることを認識しないため、決済方法はあなたに対しても非表示になります。購入前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。すでに開始された決済は引き続き確認され、返金も機能します。
ライセンスの期限が切れても、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、管理画面で作業している間に自動的に再確認されます。キー入力後の最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは必要ありません。モジュールをアンインストールまたはリセットすると、ライセンスキーとライセンスステータスは必ず削除されます。
トラブルシューティング
Nets Nexi がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択したモードに秘密鍵があることを確認してください。テストモードでは Test Secret Key、本番モードでは Live Secret Key が必要です。キーがない場合、設定ページに警告が表示されます。Payment > Preferences で、カートの通貨、顧客の国、顧客グループに対してモジュールが許可されているか確認してください。
決済は完了したが、注文が作成されない: Webhook がストアに届いていません。ストアが HTTPS と分かりやすい URL を使用していることを確認してください。そうすることで、Webhooks のアドレスは "&" を含まない公開 HTTPS アドレスになります。また、決済の環境の秘密鍵が設定されていることも確認してください。顧客が決済後にストアに戻った場合にも、注文は作成されます。
Webhook が Unauthorized と応答する: Webhook にその決済の秘密情報が含まれていませんでした。Webhook は、決済とともに登録された秘密情報がある場合にのみ受け付けられます。
Webhook が Busy, retry later、Payment lookup failed、Payment not reserved yet と応答する: 同じカートを別のリクエストが確認中だった、Nets API に接続できなかった、または仮押さえがまだ表示されていなかったことを意味します。Nets は Webhook を自動的に再試行します。
Webhook が Order could not be created, retry later と応答する: 注文を作成できませんでした。たとえばモジュールが無効になっている場合などです。理由を確認するには Debug log をオンにしてください。
ブラウザで Webhook の URL に Method not allowed と表示される: これは正常です。このアドレスは Nets からのリクエストのみを受け付けます。
顧客が Nets を選択するとエラーが表示される: Debug log をオンにして、モジュールのページの Log フィールドを確認してください。This payment method is temporarily unavailable. Please choose another payment method. は、通常、秘密鍵が誤っているか存在しないことを意味します。拒否された通貨は、Nets がログに記録します。
支払い後に注文が Nets payment on hold になる: ブロックの Nets notes を確認してください。キャプチャが拒否された場合は、Nets: check payment status and capture: で再試行するか、Nets ポータルで請求してください。金額または通貨が異なる場合は、Nets ポータルで決済を確認してください。顧客がキャンセル後に支払った場合は、注文を確認し、仮押さえをキャプチャするかキャンセルしてください。
Refund via Nets が表示されない、または失敗する: 返金は決済が請求された後にのみ可能です。その場合、ブロックには請求 ID が表示されます。返金には、注文が支払われた環境の秘密鍵が使われるため、そのキーが設定されている必要があります。設定されていない場合は、ブロックにどの環境のキーがないかが表示されます。
アンインストール
Modules > Module Manager に進み、VibeFox Nets Nexi Gateway の横のメニューを開いて Uninstall を選択します。このモジュールのライセンスキーとライセンスステータスは必ず削除されます。Delete Data on Uninstall がオンの場合、モジュールの設定とログが削除されます。オフの場合、後で再インストールするためにすべての設定が保持されます。注文に保存された Nets の決済データ（決済、請求、返金）と注文ステータス Nets payment on hold は常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は、決済メモとトランザクション ID を保持します。
Nets、Nets Easy、Nexi は、それぞれの所有者の商標です。本モジュールは Nets または Nexi と提携しておらず、両社の承認も受けていません。