VibeFox PayPlug for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降。インストールされて有効になっている必要があります。WooCommerce がないとプラグインを有効化できません。

PHP: 8.0 以降。

通貨と金額:ユーロ（EUR）、支払いごとに 0.99 〜 20,000.00。これは PayPlug の既定値です。別の通貨を使う場合、またはこの範囲外の場合、支払い方法は非表示になります。

PayPlug アカウント:PayPlug アカウントの秘密鍵が必要です。テスト用の鍵（sk_test_...）と／または本番用の鍵（sk_live_...）です。ほかの鍵は不要で、PayPlug で通知を設定する必要もありません。通知を受け取るには、サイトがインターネットから到達可能である必要があります。そうでない場合、購入者が PayPlug から戻ったときに注文が更新されます。

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

インストール

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

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

3. 設定を開きます: WooCommerce > Settings > Payments > PayPlug > Manage。または、プラグイン一覧ページのプラグイン名の下にある Settings をクリックします。

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

5. PayPlug ポータルから秘密鍵を貼り付けます（設定を参照）。

6. Enable/Disable をオンにして保存します。Test Mode をオンにしてテスト支払いを行い、その後オフにして実際の支払いを受け付けます。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > PayPlug。支払い方法が有効なのに現在のモードの秘密鍵が空である場合や、ストアの通貨が EUR ではない場合には、フィールドの上に警告が表示されます。どちらの場合も、支払い方法はチェックアウトで非表示になります。支払い方法の一覧では、テストモードのとき PayPlug に Test mode バッジが表示され、現在のモードに秘密鍵が設定されるまで、設定が必要な状態として表示されます。

チェックアウト

Enable/Disable: Enable PayPlug Gateway で支払い方法のオン／オフを切り替えます。デフォルト: off。

Title: チェックアウトで購入者に表示される支払い方法の名称。デフォルト: PayPlug。

Description: チェックアウトで支払い方法の下に表示されるテキスト。デフォルト: Pay securely by card via PayPlug。

API キー

秘密鍵は PayPlug ポータルの Developers > API keys にあります。このセクションには、プラグインが支払いごとに送信する通知 URL も表示されます。形式は次のとおりです: https://your-site/wc-api/ppg_payplug_webhook/。PayPlug で通知を設定する必要はありません。

Test Mode: Enable test mode を有効にすると、新しい支払いにテスト用の秘密鍵が使われます。実際の支払いは処理されません。もう一方のモードで行われた支払いは、ステータス確認と返金にそれぞれのモードの鍵を引き続き使用します。デフォルト: on。

Test Secret Key: PayPlug のテスト用秘密鍵。sk_test_ で始まります。

Live Secret Key: PayPlug の本番用秘密鍵。sk_live_ で始まります。

接頭辞が誤っている鍵は保存されません。ページには、例えば Test Secret Key は「sk_test_」で始まる必要があります。以前の値を保持しました。 と表示されます。

注文

Order Status After Payment: 支払いが成功した後に設定される注文ステータス。ステータスは 1 回の変更で直ちに設定されます。

詳細設定

Logging: Enable debug logging は、API 呼び出しと通知を WooCommerce > Status > Logs に記録します（ソース: wcp_payplug_gateway）。エラーは常に記録されます。秘密鍵、カード情報、購入者データは記録されません。デフォルト: off。

Delete Data on Uninstall: Remove all plugin data when uninstalling。オンにすると、プラグインを削除したときにプラグインの設定とログが削除されます。注文に保存された PayPlug の支払い ID は保持されます。デフォルト: off。

チェックアウト

購入者は支払い方法（デフォルトは PayPlug）を選び、注文を確定します。テストモードでは、チェックアウトに テストモード: 実際の支払いは行われません。 と表示されます。プラグインは注文合計（セント単位）で PayPlug の支払いを作成し、購入者を PayPlug の支払いページに移動させます。注文の請求先情報と配送先情報、およびサイトの言語が PayPlug に渡されます。そこで購入者はカードで支払います。

支払い後、購入者は貴店に戻ります。注文が支払い済みになるのは、PayPlug が確認した後です。プラグインは、通知が届いたときと購入者が戻ったときに、PayPlug API から支払いを読み取ります。支払いが成功すると、購入者は注文受付ページに移動します。

購入者が PayPlug のページでキャンセルすると、その支払いページは PayPlug 側で閉じられるため、後から誤って支払われることはありません。購入者は、例えば PayPlug での支払いをキャンセルしました。もう一度試すか、別の支払い方法を選択できます。、PayPlug の支払いセッションの期限が切れました。もう一度試すか、別の支払い方法を選択してください。 または PayPlug での支払いに失敗しました。もう一度試すか、別の支払い方法を選択してください。 といったメッセージとともに Pay for order ページに戻ります。

購入者が同じ注文をもう一度支払う場合、プラグインはまず前回の試行を確認します。その間に支払いが済んでいれば、新たな支払いなしで注文が完了します。同じ金額でまだ開いていれば、同じ支払いページが再利用されます。そうでなければ、古いページは PayPlug で閉じられ、新しい支払いが作成されます。

PayPlug が支払いを開始できない場合、購入者には、例えば PayPlug がお支払い情報（郵便番号）を受け付けられませんでした。内容を確認してもう一度お試しください。 や 決済プロバイダーに接続できません。しばらくしてからもう一度お試しください。 といった短いメッセージが表示されます。技術的な理由は注文メモに追加されます。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高パフォーマンス注文保存（HPOS）に対応しています。

支払いはすぐに売上として確定されます。本プラグインには、Oney の分割払い、Bancontact、Apple Pay、American Express、ワンクリックの保存済みカード、埋め込み型の決済フォーム、サブスクリプション、後日売上を確定する機能はありません。

注文と返金

Order statuses

Pending payment: 購入者は PayPlug に移動しましたが、まだ支払っていないか、PayPlug がまだ支払いを確認していません。

Processing or Completed: 支払いが確認されました。ステータスは Order Status After Payment に従います。注文メモには PayPlug の支払いとそのモードが表示されます。取引 ID は PayPlug の支払い ID（pay_...）です。

On hold: 支払われた金額または通貨が注文と一致しません（メモ amount/currency mismatch）。または、ストアが本番モードの間にテスト支払いが行われ、お金は受け取られていません。または、注文がキャンセルされた後に支払いが届きました。または、支払いは承認されたものの、売上は確定されていません（PayPlug ポータルで売上を確定してください。PayPlug が支払い済みと報告すると、注文は支払い済みになります）。注文メモに確認すべき内容が記載されています。

Failed: 保留中の注文の最新の支払い試行が失敗したか、キャンセルされました。古い試行の失敗は注文に影響しません。購入者は再度支払うことができます。

すでに支払い済みの注文の 2 回目の試行も支払われた場合、注文は変更されません。重複した支払いを PayPlug ポータルで返金するよう、メモに表示されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via PayPlug をクリックします。全額返金と一部返金に対応しています。返金は、実際に注文の支払いを行った支払いに対して、支払いが行われたモード（テストまたは本番）の秘密鍵を使って送信されます。そのため、そのモードの鍵が設定されている必要があります。PayPlug が返金を受け付けない場合、WooCommerce にエラーが表示され、返金は記録されません。返金が成功すると、PayPlug の返金 ID が注文メモに追加されます。

PayPlug ポータルで行われた返金は、通知によって届き、注文メモに追加されます。WooCommerce で自動的に作成されることはありません。必要に応じて手動で記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに PayPlug が表示されない:ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの秘密鍵（テストモードでは Test Secret Key、本番モードでは Live Secret Key）が入力されていること、ストアの通貨が EUR であること、注文合計が 0.99 〜 20,000.00 EUR の範囲にあることを確認してください。ほかの上限を持つアカウントは、ppg_amount_limits フィルター（セント単位の値）で変更できます。

支払いは完了したのに、注文が支払い待ちのまま:通知が貴店に届かず、購入者も戻ってこなかった状態です。設定に表示されている通知 URL で、サイトがインターネットから到達可能か確認してください。例えば、メンテナンスモード、ファイアウォール、パスワード保護によってブロックされていないかを確認します。拒否された通知は、WooCommerce > Status > Logs のソース wcp_payplug_gateway で確認できます。

通知が Verification failed を返す:PayPlug API から支払いを読み取れませんでした（例えば PayPlug が応答しなかった場合）。注文は変更されず、PayPlug は通知を再送します。

通知が Busy, retry を返す:購入者の戻りなどにより、同時に別のリクエストが注文を更新していました。PayPlug は通知を再送します。

通知が Unknown payment または Payment does not belong to the order を返す:支払いはこのストアで作成されたものではないか、この注文のものではありません（例えば、同じ PayPlug アカウント上の別のショップの支払い）。無視されます。

購入者に Payment could not be initiated と表示される:その注文の前回の支払い試行が現在確認中であるか、PayPlug がリクエストを拒否しました。少し待ってから再試行してください。注文メモに PayPlug のエラーが表示されます。

支払い後に注文が保留になっている:注文メモを確認してください。支払われた金額または通貨が注文と一致しなかった、ストアが本番モードの間にテスト支払いが行われた、または注文がキャンセルされた後に支払いが届いた可能性があります。注文を処理するか、支払いを返金してください。

モードに関するメッセージで返金が失敗する:支払いはテストモードまたは本番モードで行われましたが、そのモードの秘密鍵が設定されていません。鍵を入力してから再試行してください。

ライセンス欄にエラーが表示される:欄に表示されるメッセージに従ってください。例えば、そのキーが別のドメインで使われている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認できたステータスで動作を続けます。

アンインストール

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

PayPlug は、それぞれの所有者の商標です。このプラグインは PayPlug と提携しておらず、PayPlug による推奨も受けていません。