VibeFox PayU India for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 6.0 以降がインストールされ、有効になっていること。WooCommerce なしではプラグインの有効化が拒否されます。後から WooCommerce が無効化された場合、プラグインは何もしない状態となり、管理画面に通知を表示します。

PHP: 8.0 以降。

Store currency: インドルピー（INR）。PayU India の請求はルピーのみです。他の通貨の場合、支払い方法はチェックアウト時に非表示になります。

Phone number: PayU ではすべての支払いに電話番号が必要です。チェックアウトで電話番号フィールドを必須にするか、少なくとも表示されるように設定してください。

PayU India account: PayU Dashboard > Payment Gateway > Key Salt Details にある Merchant Key と Merchant Salt (v1) が必要です。ダッシュボードを Test Mode に切り替えるとテスト用ペアが表示されます。Salt v2 ではなく、Salt v1 を使用してください。

Internet access to your site: オプションのウェブフックに必要です。ウェブフックがない場合、購入者が PayU から戻ったときに注文が確定されます。

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

インストール

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

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

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

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

5. テスト用の Merchant Key と Salt、および本番用の Merchant Key と Salt を入力します（設定セクションを参照）。

6. 推奨: PayU Dashboard > Webhooks で、成功および失敗した支払いに対して設定ページに表示されるウェブフック URL を追加します。

7. Mode を選択し、Enable/Disable を有効にします。Test モードで支払いをテストしてから、Live に切り替えます。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > PayU India。現在のモードのキーまたは Salt が不足している場合、ページの上部で警告が表示されます。また、Test モードでは Test mode is active: payments go to test.payu.in and no real money is charged. と表示され、ストア通貨が INR 以外の場合は警告が表示されます（この場合、決済ゲートウェイはチェックアウト時に非表示になります）。

キーや Salt に誤ってスペースが含まれていると PayU からのすべての応答の検証に失敗するため、保存時に空白や改行は自動的に除去されます。

一般

Enable/Disable: Enable PayU India Payment Gateway は支払い方法の有効/無効を切り替えます。デフォルト: 無効。

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

Description: チェックアウト時に購入者に表示される支払い方法の説明。デフォルト: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU。

API 認証情報

PayU Dashboard > Payment Gateway > Key Salt Details から Merchant Key と Merchant Salt (v1) をコピーします。テスト用ペアを取得するには、ダッシュボードを Test Mode に切り替えます。

Mode: 新しい支払いに使用する PayU 環境。

返金は常に支払いが実行されたモードに送られます。

Live Merchant Key: 本番用の PayU Merchant Key。

Live Merchant Salt (v1): 本番用の PayU Merchant Salt (v1)。リクエストに署名し、PayU からの応答を検証します。秘密に保管してください。

Test Merchant Key: Test モードでのみ使用される PayU テスト用 Merchant Key。

Test Merchant Salt (v1): Test モードでのみ使用される PayU テスト用 Merchant Salt (v1)。

リターンおよびウェブフック URL

Return URL: https://your-site/wc-api/payu_p_callback/ のような形式です。支払いのたびに自動的に PayU に送信されるため、設定は不要です。

Webhook URL: https://your-site/wc-api/payu_p_webhook/ のような形式です。任意ですが推奨されます。購入者がストアに戻る前にブラウザを閉じた場合でも支払いを確定できます。成功および失敗した支払いについて、PayU Dashboard > Webhooks に追加してください。設定ページに表示されているとおりに正確に URL をコピーしてください。

詳細設定

Verify Payment: Double-check every successful payment with the PayU verify_payment API。推奨。確認を完了できない場合、注文は支払い済みにならず「保留中」になります。デフォルト: 有効。

Enable Logging: Log gateway events for troubleshooting。WooCommerce > Status > Logs のソース wcp_payu_india_payment に記録されます。エラーと警告は常に記録されますが、このオプションはその他のイベントも追加します。キー、Salt、購入者の個人情報は一切記録されません。デフォルト: 無効。

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted (orders are never deleted)。デフォルト: 無効。

チェックアウト

購入者は支払い方法（デフォルトでは PayU India）を選択して注文を確定します。注文に請求先電話番号（または配送先電話番号）がない場合、購入者には PayU India requires a phone number. Please enter your phone number and try again. と表示されます。それ以外の場合、購入者は短いページ Thank you for your order. You will be redirected to PayU to complete your payment. に進み、署名された支払いリクエストが PayU のホスト型チェックアウトに送信されます。そこで購入者はカード、NetBanking、UPI、またはウォレットで支払います。

各支払いページには固有の PayU 取引 ID が割り当てられ、金額とモードとともに注文に保存されます。同じ注文の以前に開いた古い支払いページで行われた支払いも受け付けられます。支払い済み、保留中、またはキャンセルされた注文に新しい支払いフォームが提供されることは決してないため、ブラウザの「戻る」ボタンによって二重の支払いが開始されることはありません。

PayU は購入者とともに結果を返し、設定されている場合はウェブフックでも結果を送信します。結果は、支払いが開始されたモードのキーと Salt で作成された有効な PayU ハッシュがあり、かつその注文に対して発行された取引 ID である場合にのみ受け入れられます。Verify Payment が有効な場合、成功した結果は PayU verify_payment API でも確認されます。支払額は、INR でパイサ単位まで注文合計と正確に一致していなければなりません。注文はこの方法で PayU が確認した後にのみ支払い済みとしてマークされます。プラグインは以下の PayU 結果を処理します:

成功または保留中の支払いの後、購入者には注文受付ページが表示されます。支払いが失敗した後、購入者は次のいずれかのメッセージとともにチェックアウトに戻ります: Payment was not completed. Please try again or choose a different payment method.、Payment was cancelled. You may try again.、または結果を確認できなかった場合は We could not confirm the payment result. If your account was charged, please contact us before paying again.。これらのメッセージは、クラシックチェックアウトとチェックアウトブロックの両方で動作します。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、および Pay for order ページで動作します。WooCommerce 高パフォーマンス注文ストレージ（HPOS）と互換性があります。

プラグインの請求は INR のみであり、複数通貨処理（MCP）には対応していません。カード情報の保存やトークン化、WooCommerce Subscriptions、サイト内シームレスカードフォーム、分割払い（EMI）やプロモーションの管理、PayU ワンクリックチェックアウトには対応していません。

注文と返金

注文ステータス

Pending payment: 購入者が PayU に誘導され、まだ支払っていません。

Processing: 支払いが確認されました。注文メモには、PayU 取引 ID（mihpayid）、支払いモード、銀行コードが表示されます。注文の取引 ID は PayU mihpayid です。仮想ダウンロード商品のみの注文は、WooCommerce のデフォルトどおり「完了」になります。

On hold: PayU で支払いがまだ保留中である（UPI または NetBanking）、支払額または通貨が注文と異なる、verify_payment API に接続できなかったかまだ支払いが確認されていない、あるいはキャンセルされた注文に対して支払いが届いた状態です。注文メモにその理由が記載されます。PayU Dashboard で取引を確認し、完了するか返金してください。検証に失敗した場合、結果の次回の配信時に注文が自動的に確定されます。

Failed: 支払いが拒否されたか、キャンセルされました。購入者は再度支払うことができます。

PayU がすでに支払い済みの注文に対して別の支払いの成功を報告した場合、注文メモにより PayU Dashboard で重複分を返金するよう促されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via PayU India をクリックします（ボタンには貴店の Title が表示されます）。全額返金と一部返金に対応しています。金額は 0 より大きくなければなりません。返金は支払いが行われたモードのキーと Salt を使用して PayU 返金 API 経由で送信されるため、それらの認証情報が設定されている必要があります。PayU が返金を拒否した場合、WooCommerce に PayU のメッセージが表示され、返金は記録されません。

PayU は返金をキューに入れて非同期に処理します。購入者は通常 5〜7 営業日以内に返金を受け取ります。注文メモには金額、PayU リクエスト ID、理由が表示されます。プラグインは後から返金ステータスを再確認することはありません。

ライセンスキー

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

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

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

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

トラブルシューティング

PayU India does not appear at checkout: ライセンスが有効であること、Enable/Disable が有効であること、選択した Mode のキーと Salt が入力されていることを確認してください。ストア通貨（または Pay for order ページの注文通貨）が INR であることを確認してください。設定ページには、これらの問題ごとに警告が表示されます。

The payment went through, but the order stays Pending payment: 購入者がストアに戻らず、ウェブフックも届きませんでした。成功および失敗した支払いについて、設定にあるウェブフック URL を PayU Dashboard > Webhooks に追加し、インターネットからアクセス可能であることを確認してください。

Webhook answers invalid_signature: PayU ハッシュが一致しませんでした。支払いモードのキーと Salt が正しいこと、および Salt v2 ではなく Salt v1 が使用されていることを確認してください。注文は変更されません。

Webhook answers not_configured: 支払いが開始されたモードのキーまたは Salt が不足しています。これらを入力すると、PayU はウェブフックを再試行します。

Webhook answers verify_unavailable: verify_payment API がまだ支払いを確認できていません。注文は保留中になり、次回の配信で再度検証されます。

The customer sees PayU India requires a phone number: チェックアウトで電話番号フィールドを必須にするか、表示されるように設定してください。請求先電話番号が使用され、配送先電話番号のみが入力されている場合はそれが使用されます。

The order is On hold: 注文メモを確認してください。理由は、保留中の UPI または NetBanking の支払い、金額または通貨の不一致、検証の失敗または保留、あるいはキャンセルされた注文に対する支払いです。

Refund fails: PayU transaction ID not found for this order. は、注文に PayU による支払いが存在しないことを意味します。支払いモードの Merchant Key/Salt が設定されていないというメッセージは、まずそのモードの認証情報を入力する必要があることを意味します。

Too little in the log: エラーと警告は常に記録されます。すべての PayU リクエストと結果も確認するには、Enable Logging を有効にしてください。

Developer hooks: payu_p_request_fields フィルターは、支払いリクエストのフィールドが署名される前に変更します。payu_p_icon フィルターはチェックアウトのアイコンを変更します。

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

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。完全に削除するには、Plugins ページで無効化して削除してください。このプラグインのライセンスキーとライセンスステータスは常に削除されます。ゲートウェイ設定およびこのプラグインのログ（ログファイルおよび WooCommerce データベースログの行）は、Delete data on uninstall が有効になっている場合にのみ削除されます。それ以外の場合は、将来の再インストールのために保持されます。既存の注文は、支払いメモ、PayU 取引 ID、返金リクエスト ID を保持します。

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