VibeFox PayU for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降（インストールおよび有効化されていること）。WooCommerce がないとプラグインは有効化できません。後から WooCommerce を無効化した場合、プラグインは何も処理を行わず、管理画面に通知を表示します。

PHP: 8.0 以降。

ストア通貨: PLN、EUR、CZK、HUF、RON、BGN、GBP、USD、CHF、DKK、NOK、SEK、UAH のいずれか。通貨は PayU の POS でも有効化されている必要があります。その他の通貨の場合、支払い方法はチェックアウトで非表示になります。

サイトへのインターネットアクセス: PayU はストアに決済通知を送信するため、サイトがインターネットからアクセス可能である必要があります（HTTP 認証やメンテナンスページで遮断されていないこと）。通知が届かない場合でも、購入者が PayU から戻った際に注文が確認されます。

PayU アカウント: POS の 4 つのキー（POS ID、Second key (MD5)、OAuth client_id、OAuth client_secret）が必要です。これらは PayU 加盟店パネルの Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys にあります。サンドボックスのキーは、独立した PayU サンドボックスアカウントから取得します。

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

インストール

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

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

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

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

5. 4 つの Sandbox キーと 4 つの Live キーを入力します（設定を参照）。PayU 側で通知 URL を設定する必要はありません。

6. Enable/Disable をオンにします。テスト決済を行うまで Test Mode をオンのままにし、その後チェックを外して Live キーで実際の決済を受け付けます。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > PayU。サンドボックスモードがオンの間、現在のモードの 4 つのキーのいずれかが不足している場合、またはストア通貨が PayU で受け付けられない場合、ページの上部で警告が表示されます。後者 2 つの場合、PayU はチェックアウトに表示されません。

PayU パネルからのコピー時にスペースや改行が紛れ込みやすいため、保存時にすべてのキーからスペースや改行が自動的に削除されます。

一般

Enable/Disable: Enable PayU payment gateway で支払い方法をオンまたはオフにします。既定値: オフ。

Title: チェックアウトで購入者に表示される支払い方法の名前。既定値: PayU。

Description: チェックアウトで購入者に表示される支払い方法の説明文。既定値: Pay securely via PayU。

API 認証情報

PayU 加盟店パネルでキーを確認します: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys。サンドボックスキーは独立した PayU サンドボックスアカウントから取得します。各モードの 4 つのキーをすべて入力する必要があります。

Test Mode: Enable sandbox (test) mode。PayU サンドボックスと下記の Sandbox キーを使用します。実際のお金は請求されません。クラシックチェックアウトおよびチェックアウトブロックで購入者には Sandbox mode — no real money is charged と表示されます。Live キーで実際の支払いを受け付けるにはオフにします。既定値: オン。

Live POS ID: 本番 POS の POS ID (merchantPosId)。

Live Second Key (MD5): PayU 通知の署名を検証するために使用されます。

Live OAuth Client ID: POS の OAuth client_id。

Live OAuth Client Secret: POS の OAuth client_secret。

Sandbox POS ID: PayU サンドボックス POS の POS ID。

Sandbox Second Key (MD5): PayU サンドボックス通知の署名を検証するために使用されます。

Sandbox OAuth Client ID: サンドボックス POS の OAuth client_id。

Sandbox OAuth Client Secret: サンドボックス POS の OAuth client_secret。

決済ごとにその環境が記録されます。通知、ステータス確認、返金は常にその決済の環境のキーを使用するため、モードを切り替えた後でも過去の決済は正常に動作します。サンドボックスキーで署名された通知が本番決済として受け付けられることはありません。

決済通知

このセクションには、https://your-site/wc-api/wc_pu_payment/ のような通知 URL が表示されます。プラグインは決済ごとにこれを PayU に送信するため、PayU パネル側で設定を行う必要はありません。インターネットからアクセス可能であること（ファイアウォール、メンテナンスモード、HTTP 認証で遮断されていないこと）を確認してください。

詳細設定

Receive payments automatically: Automatically receive payments waiting for confirmation。これは PayU パネルで POS の自動受取がオフになっている場合にのみ関係します。その場合、決済は確認待ち（WAITING_FOR_CONFIRMATION）になります。この設定をオンにすると、プラグインはそのような決済をすぐに受け取ります。オフにすると、該当する注文は保留になり、注文アクションの Receive PayU payment および Cancel PayU payment で決済を受け取るかキャンセルします。既定値: オン。

Logging: Enable logging は、技術的なイベント（注文番号、PayU 注文 ID、ステータス、エラー。キーや個人データは除外）を WooCommerce > Status > Logs のソース wcp_payu_payment に記録します。既定値: オフ。

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted。注文とその決済データが削除されることはありません。プラグインを無効化してもすべてのデータは保持されます。既定値: オフ。

チェックアウト

購入者は支払い方法（既定では PayU）を選び、注文を確定します。プラグインは、注文通貨での注文合計額について、説明 Order #、注文番号、ストア名、および PayU ページに表示するための注文項目、配送、手数料を含む PayU 注文を作成します。PayU ページの言語は、PayU が対応している場合はストア言語に、それ以外の場合は英語になります。購入者は PayU 決済ページにリダイレクトされ、そこで方法を選んで支払います。

決済の試行ごとに専用の PayU 注文が作成されます。購入者が再度支払う場合（決済の失敗やキャンセル後、または Pay for order ページから）、その注文の以前の未完了の PayU 決済は PayU 側でキャンセルされるため、古い決済リンクから二重に支払われることはありません。

ストアに戻っただけで注文が支払い済みになることは決してありません。注文が支払い済みとしてマークされるのは、PayU が確認した後のみです。つまり、決済環境の Second Key で署名された通知によるか、購入者が戻った際のサーバー上の PayU 注文ステータス確認によります（通知が遅延した場合に便利です）。PayU 注文はこの注文に対して作成されたものである必要があり、金額と通貨が一致していなければなりません。プラグインは以下の PayU ステータスを処理します:

注文受付ページで、注文がまだ支払い待ちの間、購入者には We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again:、または決済失敗後に The payment was not completed. You can try again: と表示され、それぞれに Pay again ボタンが用意されています。保留中の注文の場合、メッセージは Your payment is being verified. We will send you an e-mail as soon as it is confirmed. です。

PayU で決済を開始できない場合、購入者には Payment error. Please try again or choose another payment method. と表示されます。技術的な理由（HTTP コードと PayU ステータス）がログおよび注文メモ PayU payment could not be started: に記録されます。現在のモードのキーが不足している場合、メッセージは Payment gateway is not configured properly. Please contact the administrator. になります。

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

購入者は自店のチェックアウトではなく、PayU のページ上で支払い方法を選択します。本プラグインには、ストア内のカードフォーム、保存済みカード、ワンクリック決済、定期購入、PayU 分割払いやクレジットウィジェットはありません。環境ごとに 1 つの POS を使用します（通貨ごとの POS はありません）。

注文と返金

注文ステータス

Pending payment: 購入者は PayU にリダイレクトされ、まだ支払っていません。注文メモには PayU 注文 ID と環境（sandbox または live）が表示されます。

Processing: 支払いが確認されました。注文メモには PayU 注文 ID、金額、環境が表示されます。取引 ID は支払われた PayU 注文 ID です。仮想のダウンロード可能な商品のみの注文は、WooCommerce の既定の動作どおり完了になります。

On hold: 支払われた金額または通貨が注文と一致しなかった場合、キャンセルされた注文に対して決済が完了した場合、または決済が管理者の確認待ちの場合（自動受取がオフ、または受取に失敗）。注文メモにその理由と対応方法が記載されます。

Failed: 直近の PayU 決済がキャンセルされたか拒否されました。購入者は再度支払いを試行できます。

各通知は、注文ごとのロックの下で 1 回だけ処理されます。重複通知によってメモが追加されたり、在庫が二重に減らされたり、メールが重複送信されることはありません。すでに支払い済みまたは返金済みの注文に対して別の決済が完了した場合、注文メモにより PayU パネルでの返金が案内されます。すでに支払い済みまたはクローズされた注文に対する確認待ち決済は自動的にキャンセルされ、二重請求が防止されます。

確認待ちの決済

確認待ちの決済がある未払い注文の場合、注文画面には 2 つの注文アクションが表示されます: Receive PayU payment (waiting for confirmation) と Cancel PayU payment (release the funds)。いずれかを選択して更新ボタンをクリックします。アクションはユーザー名とともに注文メモに追加され、新しい PayU ステータスが直ちに適用されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via PayU をクリックします（ボタンには設定した Title が表示されます）。全額返金と一部返金に対応しています。返金は実際に支払われた PayU 注文に対してその決済環境のキーで送信されるため、それらのキーが設定されている必要があります。返金理由は返金の説明として送信されます。PayU が返金を拒否した場合、WooCommerce に PayU のエラーが表示され、返金は記録されません。

PayU では返金は非同期で行われます。プラグインは直ちに PayU 返金 ID とステータスを記載したメモを追加し、最終ステータスは後から PayU 通知として届き、メモとして追加されます。PayU が返金をキャンセルした場合、購入者に返金されなかった旨がメモに記載されます。

金額または通貨の不一致により保留になった注文は、PayU 注文 ID を取引 ID として保持するため、WooCommerce からも PayU パネルからも返金できます。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに PayU が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの 4 つのキーがすべて入力されていること（サンドボックスモードでは Sandbox キー、本番モードでは Live キー）を確認してください。ストア通貨（または Pay for order ページの注文通貨）が対応通貨のいずれかであることを確認してください。設定ページには、これらの問題ごとに警告が表示されます。

決済は完了したが、注文が支払い待ちのまま: PayU がまだ通知を配信しておらず、復帰ページでのステータス確認でも完了した決済が検出されませんでした。設定に表示されている通知 URL がインターネットからアクセス可能であることを確認してください。何が届いているか確認するには Logging をオンにします。

通知が Invalid signature を返す: 通知がどちらの環境の Second Key でも署名されていませんでした。Live Second Key (MD5) および Sandbox Second Key (MD5) を確認してください。Invalid signature for this payment という応答は、決済と異なる環境のキーで通知が署名されていたことを意味します。

通知が Ignored を返す: PayU 注文が、このストアで PayU で支払われた注文に属していません（例: 同じ POS 上の別のショップ）。PayU は再試行を停止します。

決済が作成されない: Logging をオンにし、WooCommerce > Status > Logs のソース wcp_payu_payment を確認してください。ログには HTTP コードと PayU ステータスが記録されます。Could not authenticate with PayU (check the OAuth client ID / secret). は、現在のモードの OAuth キーが間違っていることを意味します。

注文が保留中: 注文メモを確認してください。原因は金額または通貨の不一致、キャンセル後の決済、または確認待ちの決済です。最後のケースでは、注文アクションの Receive PayU payment または Cancel PayU payment を使用してください。

返金が失敗する: This order has no completed PayU payment. Cannot process refund. は、注文に支払い済みの PayU 注文がないことを意味します。Sandbox キーまたは Live キーが不足しているというメッセージは、その環境で決済が行われ、そのキーが設定されていないことを意味します。キーを入力して再試行してください。

その他の通貨: 開発者は wc_pu_supported_currencies フィルターで通貨リストを、wc_pu_icon フィルターでチェックアウトアイコンを変更できます。

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

アンインストール

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

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