戻る

VibeFox PayU India for OpenCart — ヘルプ

要件

OpenCart: 3.0.x(3.0.5.0 で動作確認)、または 4.0.2 以降(4.1.0.3 で動作確認)。

PHP: 8.0 以降。

通貨: インドルピー(INR)。PayU India はルピーでのみ請求します。ストアには INR 通貨が必要です(System > Localisation > Currencies)。INR 以外の通貨の注文では、チェックアウトでこの決済方法は表示されません。

電話番号: PayU は、すべての決済に電話番号を必要とします。注文に電話番号が含まれるように、チェックアウトの Telephone フィールドを残してください。OpenCart 4 のチェックアウトでは、既定では電話番号は求められません。注文に電話番号がない場合、拡張機能は確認ステップに独自の Phone フィールドを表示します(「チェックアウト」を参照)。

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

ストアのインターネット接続: 任意のウェブフックに必要です。ウェブフックがない場合、購入者が PayU から戻ったときに注文が確認されます。

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

インストール

ダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。コンピューターで解凍してください。内容は README.txt、OpenCart 3 用のパッケージ wcp_payu_india_payment-oc3-(version).ocmod.zip、OpenCart 4 用のパッケージ wcp_payu_india_payment.ocmod.zip です。お使いの OpenCart のバージョンのパッケージだけをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_payu_india_payment-oc3-(version).ocmod.zip を選択します。この拡張機能には OCMOD の変更が含まれないため、Extensions > Modifications の更新は不要です。インストーラーを使わず、このパッケージ内の upload フォルダの内容をストアのルートフォルダにコピーすることもできます。

2. Extensions > Extensions に移動し、種類として Payments を選択します。VibeFox PayU India Payment Gateway を見つけて、Install(緑色の + ボタン)をクリックします。管理者ユーザーには、決済拡張機能の一覧を変更する権限が必要です。

3. Edit(鉛筆のボタン)をクリックして設定ページを開きます。ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします(ライセンスキーを参照)。

4. テスト用の Merchant Key と Salt、および本番用の Merchant Key と Salt を入力します(設定を参照)。

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

6. Mode を選択し、Enable/Disable をオンにして、Save をクリックします。Test モードで決済をテストしてから Live に切り替えてください。

OpenCart 4

1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_payu_india_payment.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から取得するため、名前を変更したパッケージは動作しません。

2. インストール済み拡張機能の一覧に、同じページでパッケージが表示されます。その横の Install(緑色の + ボタン)をクリックします。

3. Extensions > Extensions に移動し、種類として Payments を選択します。VibeFox PayU India Payment Gateway を見つけ、Install(緑色の + ボタン)をクリックしてから、Edit(鉛筆ボタン)をクリックします。

4. OpenCart 3 の手順 3 から 6 と同じように、ライセンスキー、PayU の認証情報、ウェブフックを入力します。設定ページとその欄は両方のバージョンで同じです。違うのは戻り URL とウェブフック URL だけです(「戻り URL とウェブフック URL」を参照)。

新規インストール時は、決済方法がオフ、Test モードが選択された状態で始まります。

設定

すべての設定は拡張機能のページにあります: Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > Edit。セクションは左側に並んでおり、一覧の下にある Save ボタンでページ全体を保存します。設定の上部では、現在のモードのキーまたは salt が不足しているとき警告が表示され、Test モードでは テストモードが有効です: 決済は test.payu.in に送られ、実際の料金は請求されません。 と表示されます。ストアの既定通貨が INR でない場合はエラーが表示されます。この場合、購入者が INR で支払う場合にのみ、チェックアウトにゲートウェイが表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時、Title は空欄にできず、128 文字を超えることもできません。Sort Order は整数である必要があります(負の数も使用できます)。Total は 0 以上の数値である必要があり、地域(Geo Zone)と注文ステータスが存在している必要があります。これらを満たさない場合、何も保存されません。キーと salt からはスペースと改行が削除されます。貼り付けられたスペースを含む salt では、すべての PayU の応答が検証に失敗してしまうためです。現在のモードのキーと salt が未入力のまま決済方法を有効にした場合、保存後にページが警告します。

PayU India

このセクションは短い注意書きで始まります。カード、NetBanking、UPI、ウォレットは PayU がホストする決済ページで利用でき、結果は有効な PayU の署名がある場合にのみ受け付けられます。対応しているのはルピーのみです。

Enable/Disable: Enable PayU India Payment Gateway で、決済方法のオン/オフを切り替えます。既定値: オフ。

Title: チェックアウト中に購入者に表示される決済方法のタイトルです。注文にも、この名前が決済方法として保存されます。既定値: PayU India。必須、128 文字以内。

Description: Confirm Order ステップで、確認ボタンの上に購入者へ表示されるテキストです。既定値: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU。

Sort Order: チェックアウトの決済方法の中での PayU India の表示順です。空欄のままにするか、整数を入力します。

Geo Zone: 選択した地域内の支払い先住所に対してのみ PayU India を提供します。既定値: All zones。地域は System > Localisation > Geo Zones で設定します。

Total: PayU India を提供するために、注文がストアの既定通貨で達している必要のあるチェックアウト金額です。空欄にすると、どの金額でも PayU India を提供します。

API 認証情報

Merchant Key と Merchant Salt(v1)は、PayU Dashboard > Payment Gateway > Key Salt Details からコピーします。テスト用のペアを取得するには、ダッシュボードを Test Mode に切り替えてください。このセクションには Open the PayU Dashboard のリンクがあります。

Mode: 新しい決済で使用する PayU の環境です。

Test (Sandbox): テストキーと salt、および test.payu.in を使用します。実際の料金は請求されません。Confirm Order ステップで、購入者には テストモード: 実際の料金は請求されません。(既定値)と表示されます。
Live (Production): 本番キーと salt、および secure.payu.in を使用します。

すでに開始された決済は、開始されたときのモードを維持します。モードを切り替えた後でも、その結果はそのモードのキーと salt を使って確認され、返金もそのキーと salt で送信されます。

Live Merchant Key: 本番環境の PayU Merchant Key です。

Live Merchant Salt (v1): 本番環境の PayU Merchant Salt(v1)です。リクエストの署名と PayU 応答の検証に使われます。秘密にしてください。

Test Merchant Key: テスト環境の PayU Merchant Key です。Test モードでのみ使用されます。

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

保存された salt は、再表示されることはありません。フィールドは空欄のままで、保存済み — 変更しない場合は空欄のままにしてください。 と表示されます。値を変更する場合にのみ、新しい値を入力してください。保存された salt を削除するには、フィールドの下にある Clear the saved salt on save にチェックを入れ、Save をクリックします。

戻り URL とウェブフック URL

Return URL: OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/back の形式で、OpenCart 4 では https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.back の形式です。決済ごとに自動的に PayU に送信されます。設定は不要です。

Webhook URL: OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/webhook の形式で、OpenCart 4 では https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.webhook の形式です。任意ですが、推奨されます。購入者が戻る前にブラウザを閉じてしまった場合でも、決済を確認できます。成功および失敗した決済について、PayU Dashboard > Webhooks に追加してください。設定ページに表示されたとおりに URL をそのままコピーしてください。インターネットから到達可能である必要があります(ベーシック認証やファイアウォールでブロックされていないこと)。ストアのメンテナンスモードでもブロックされません。

ウェブフックは、購入者の戻りと同じ署名済みの結果を運びます。有効な PayU hash がないウェブフックは拒否されます。

注文

OpenCart は、Confirm Order ステップで注文をステータスなし(欠落した注文)として作成します。注文にステータスが設定されるのは、PayU が正しく署名された結果を送信した後だけです。失敗またはキャンセルされた決済では注文はステータスなしのままで、購入者はカートが保持された状態でチェックアウトに戻ります。以下の各フィールドには、OpenCart の注文ステータスが一覧表示されます。

Order Status After Payment: Verify Payment がオンのとき、INR で想定どおりの金額の成功した決済で、verify_payment によって確認されたもの。既定値: Processing。

Awaiting PayU Payment Status: PayU が決済を保留と報告したとき(UPI collect、NetBanking の処理中)。PayU が確認すると、注文は支払い後のステータスになります。既定値: Pending。

On Hold (Review) Status: PayU が、手動確認が必要な成功した決済を報告したとき(注文ステータスを参照)。既定値: Pending。OpenCart には On hold ステータスがないためです。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。

Payment Error Status: 保留中の決済が、その後 PayU によって失敗と報告されたもの。既定値: Failed。

Refunded Status: 支払われた全額が注文ページから返金されたときに設定されます。既定値: Refunded。

Cancelled Order Status: ストアがキャンセルされた注文に使うステータスです。そのような注文に対して受け取った決済は、支払い済みとしてマークされず、確認状態になります。この拡張機能がこのステータスを設定することはありません。既定値: Canceled。

詳細設定

Verify Payment: 成功したすべての決済を、PayU の verify_payment API で再確認します。推奨されます。確認を完了できない場合、注文は支払い済みとしてマークされず、確認状態になります。既定値: オン。

Enable Logging: トラブルシューティングのため、ゲートウェイのイベントを OpenCart のログフォルダ(storage/logs)内の payu_p_debug.log.php に記録します。このファイルは Web から開くことはできません。エラーと警告は常に記録されます。このオプションは、すべての決済フォームや PayU の結果など、その他のイベントも追加します。キー、salt、購入者の個人データは決して記録されません。既定値: オフ。

Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にできます。

Delete data on uninstall: 拡張機能をアンインストールしたとき、ゲートウェイの設定とログを削除します。注文と PayU の取引記録は決して削除されません。既定値: オフ。

インポート / エクスポート

Export: Download JSON で、設定を JSON ファイルとして保存します。salt はエクスポートされません。

Import: 以前にエクスポートした JSON を貼り付けて Import をクリックすると、設定を復元します。保存されている salt は保持されます。

チェックアウト

Payment Method ステップで、購入者が決済方法を選択します(既定では PayU India)。Confirm Order ステップで、購入者には貴店の説明が表示されます。OpenCart は、このステップでステータスなしのまま注文を作成します。OpenCart 4 では、購入者は決済方法ブロックの Choose ボタンを押し、Payment method options ウィンドウで決済方法を選んで、チェックアウトページ下部の Confirm Order をクリックします。注文に電話番号がない場合、OpenCart 4 の確認ブロックには Phone フィールドも表示され、ヒント PayU India requires the phone number of the payer. が付きます。そこに入力された番号は PayU に送信され、次の試行のために保持されます。注文の電話番号が優先されます。購入者が Confirm Order をクリックすると、拡張機能は通貨、現在のモードの認証情報、注文の電話番号を確認します。電話番号がない場合、購入者は PayU India には電話番号が必要です。電話番号を入力して、もう一度お試しください。 と表示されたステップに留まります。それ以外の場合、拡張機能は注文合計額について INR で署名された決済リクエストを作成し、ブラウザはそれをすぐに PayU がホストする決済ページに送信します。ページには 決済を完了するために PayU にリダイレクトされます。 と表示され、ブラウザが自動で進まない場合に備えて Pay with PayU ボタンも表示されます。PayU のページで、購入者はカード、NetBanking、UPI、またはウォレットで支払います。

Confirm Order をクリックするたびに、注文番号で始まり、金額とモードとともに保存される独自の PayU トランザクション ID(txnid)で新しい試行が開始されます。OpenCart 3 は Confirm Order ステップが表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を更新するため、そこでは新しい試行が同じ注文を決済します。同じ注文の、まだ開いている以前の決済ページで行われた支払いも引き続き受け付けられます。同じカートの別の注文がすでに支払い済み、PayU で待機中、または確認中の場合、購入者は成功ページに直接進み、新しい決済フォームは作成されません。カートを変更した場合(数量の変更を含む)は、新しいカートとして扱われ、独自の決済が必要です。

PayU は、購入者とともに結果を返します。また、設定されていればウェブフックでも送信されます。結果は、決済が開始されたモードのキーと salt で作成された有効な PayU hash があり、かつその注文に対して発行されたトランザクション ID の場合にのみ受け付けられます。Verify Payment がオンの場合、成功した結果は PayU の verify_payment API でも確認されます。支払われた金額は、試行の金額および注文合計額と、INR で paisa(パイサ)単位まで一致する必要があります。注文は、この方法で PayU が確認した後にのみ支払い済みとしてマークされ、その後、OpenCart の標準的な方法でステータスを受け取り、通常の注文メールが送信され、在庫が更新されます。拡張機能は次の PayU の結果を処理します:

success: 決済が完了しました。すべてのチェックに合格すると、注文は Order Status After Payment になります。合格しない場合は確認ステータスになります。
pending: UPI または NetBanking の決済がまだ処理中です。注文は Awaiting PayU Payment Status になります。最終的な結果はウェブフックで届きます。
failure: 決済は購入者によって拒否またはキャンセルされました。ステータスのない注文はステータスなしのままで、カートは保持されるため、購入者は再び支払うことができます。この決済を待っていた注文は Payment Error Status になります。支払い済みの注文が変更されることはありません。

成功または保留中の決済の後、購入者は OpenCart の注文成功ページを表示されます。保留中の決済では PayU による決済は保留中です。PayU が結果を確認次第、注文は更新されます。再度お支払いいただく必要はありません。 が追加されます。確認中の注文には お支払いを確認しています。ほかに必要な情報があればご連絡します。 が追加されます。決済エラーまたはキャンセル状態の未払いの注文には PayU による決済が完了しませんでした。この注文についてお問い合わせください。 と表示されます。

決済が失敗した後、購入者は次のいずれかのメッセージとともにチェックアウトに戻ります: 決済が完了しませんでした。もう一度お試しいただくか、別の決済方法をお選びください。、決済はキャンセルされました。もう一度お試しいただけます。、または結果を確認できなかった場合は 決済結果を確認できませんでした。お客様のアカウントに請求が発生している場合は、再度お支払いいただく前にお問い合わせください。 購入者が戻った時点で結果がまだ処理中の場合、ページには PayU による決済を確認しています。決済を完了している場合、注文はまもなく更新されます。再度お支払いいただかないでください。 と表示され、Check again と Back to checkout のボタンがあります。OpenCart 4 では、チェックアウトのメッセージはチェックアウトページの上に表示されます。

OpenCart 4 では、完了ページが表示されるまで注文がチェックアウト内に保持されます。その間に注文が決済なしで閉じられた場合(たとえば保留中の決済が失敗した、またはキャンセルした場合)、購入者は Your previous order was cancelled or its payment failed. Please confirm the order again. というメッセージとともにチェックアウトに戻されます。注文が支払い済みになった後にストアによってキャンセルまたは返金された場合、メッセージは Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. です。注文が以前のカートについてすでに支払い済みで、その後カートが変更された場合、メッセージは Your previous order has already been paid. Your cart has changed since — please confirm the order again to pay for the current cart. です。次の Confirm Order で新しい注文の決済が行われます。閉じられた注文が支払い済みとして表示されることはありません。

OpenCart は決済拡張機能のリクエストを通過させるため、ストアがメンテナンスモードでもウェブフックは機能します(OpenCart 4 では、拡張機能が独自の起動アクションを追加しており、これにより購入者は PayU から戻ることもできます)。

この拡張機能は INR でのみ請求し、マルチカレンシー処理(MCP)には対応していません。保存済みカードやトークン化、定期課金、オンサイト(シームレス)のカードフォーム、EMI やオファーの管理、PayU のワンクリック決済はありません。

注文と返金

注文ステータス

ステータスなし(欠落した注文): 購入者は PayU に送られましたが支払っていないか、決済が失敗またはキャンセルされたか、PayU がまだ決済を確認していません。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。

Order Status After Payment(既定値 Processing): 決済が確認されました。メモには PayU payment successful. Transaction ID: …, Mode: …, Bank: … と表示されます。

Awaiting PayU Payment Status(既定値 Pending): UPI または NetBanking の決済がまだ PayU で保留中です。PayU が確認すると、注文は支払い済みステータスになります。

On Hold (Review) Status(既定値 Pending): 支払われた金額または通貨が注文と異なる、verify_payment API に接続できない、または決済をまだ確認していない、あるいは Cancelled Order Status の注文に対して決済を受け取った。メモに理由が表示されます。PayU Dashboard でトランザクションを確認してから、支払い済みステータスを設定するか、注文をキャンセルして決済を返金してください。確認だけが失敗した場合は、次回の結果の受信時に注文は自動的に支払い済みになります。

Payment Error Status(既定値 Failed): 保留中の決済が、その後拒否またはキャンセルされました。後から成功した結果が届けば、注文は支払い済みになります。

Refunded Status(既定値 Refunded): 支払われた全額が、この拡張機能を通じて返金されました。

すでに支払い済みの注文に対して PayU が別の成功した決済を報告した場合、注文は変わらず、メモには重複分を PayU Dashboard で返金するよう記載されます。支払い済みのカートの別の注文に対する決済は、その注文をステータスなしのままにし、支払い済みの注文にメモを追加します。別の決済方法に切り替えられた注文に対する PayU の決済は、メモが追加されるだけです。

メモは、注文の History にあるエントリで、購入者には表示されません。

VibeFox PayU India Payment Gateway タブ

Sales > Orders で、PayU India で支払われた注文を開きます。注文ページの下部、History と Additional の隣にある VibeFox PayU India Payment Gateway タブには、PayU transaction ID (mihpayid)、Store transaction ID (txnid)、テストの決済には Test mode バッジが付いた Environment、PayU の Status、決済の Mode / bank、Paid / refund requested (INR) の金額、返金フォーム、返金履歴、注文の PayU notes が表示されます。確認状態の注文では、決済を確認するよう促すリマインダーが表示されます。このタブは、拡張機能へのアクセス権があるユーザーに表示されます。

返金

VibeFox PayU India Payment Gateway タブで Amount(まだ返金されていない金額が自動入力されます)を入力し、必要に応じて Reason (optional) を入力して、Refund via PayU をクリックします。Refund this amount through PayU? This cannot be undone. の確認に同意します。全額返金と一部返金に対応しています。金額は 0 より大きく、PayU が請求した額のうち残りの返金可能額を超えないようにしてください。拡張機能を変更する権限が必要です(System > Users > User Groups で設定)。返金は、決済が行われたモードのキーと salt を使って PayU の返金 API を通じて送信されるため、それらの認証情報が設定されている必要があります。1 つの注文について、同時に実行される PayU リクエストは 1 つだけです。PayU が返金を拒否した場合、タブには PayU refund failed: と PayU のメッセージが表示され、返金は記録されません。

PayU は返金をキューに入れ、非同期に処理します。購入者が通常、お金を受け取るまでには 5~7 営業日かかります。返金履歴とメモには、金額、PayU のリクエスト ID、理由が表示されます。全額返金を行うと、注文は購入者に通知されず、商品も在庫に戻されずに Refunded Status になります。これは手動でのステータス変更と同じです。一部返金ではステータスは変わりません。返金は、PayU が決済のトランザクション ID を報告した後に利用できます。拡張機能は後から返金のステータスを確認しません。

Sales > Returns での商品返品では、PayU を通じた返金は行われません。PayU Dashboard で行った返金は、OpenCart に同期されません。

ライセンスキー

この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。License — VibeFox PayU India Payment Gateway のライセンスブロックは、Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > Edit の最初のブロックで、設定の上にあります。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス(例: ライセンスの有効期限の日付と貴店のドメイン)、そして次のボタンが表示されます。ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key。その下には Product: opencart-payment-payu-india の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。キーを変更できるのは、この拡張機能の Modify 権限を持つ管理者ユーザーだけです。ブロックのテキストは管理画面の言語に従います(英語とロシア語が含まれます)。

キーが受け入れられない場合、ブロックに理由が表示されます。例: Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認できた状態で動作を続けます。

1 つのキーは 1 つのドメインで機能します。OpenCart の設定にあるストアのアドレスが対象です。ストアからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。

有効なキーがない場合、PayU India はチェックアウトで購入者に表示されません。それでも決済を開始すると、購入者には This payment method is not available. Please choose another one. と表示されます。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアで決済方法が (unlicensed — visible to admins only) と表示されたまま表示されるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアからは管理画面へのログインが見えないため、有効なキーがない場合は、決済方法がすべてのユーザーに対して非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると、7 日間非表示になります。既存の注文には影響しません。開始済みの決済は引き続き確認され、返金も機能します。

ライセンスの有効期限が切れた場合も拡張機能は動作し続けますが、アップデートとサポートには更新が必要です。ステータスは、管理画面の Dashboard または Edit ページを開くと自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日 1 回、その後は週に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

PayU India がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、選択された Mode のキーと salt が入力されていることを確認してください。購入者が INR で支払うこと、支払い先住所が選択された Geo Zone 内にあること、注文が設定の Total に達していることを確認してください。認証情報が不足している場合やストアの通貨が INR 以外の場合、設定ページに警告が表示されます。

決済は完了したが、注文にステータスがない: 購入者がストアに戻らず、ウェブフックも届いていません。設定ページのウェブフック URL を、成功および失敗した決済について PayU Dashboard > Webhooks に追加し、インターネットから到達可能であることを確認してください。

ウェブフックが invalid_signature と応答する: PayU の hash が一致しませんでした。決済のモードのキーと salt が正しいこと、Salt v2 ではなく Salt v1 を使用していることを確認してください。テスト用の salt で署名された本番決済の結果、またはその逆も拒否されます。何も変更されません。

ウェブフックが not_configured と応答する: 決済が開始されたモードのキーまたは salt が不足しています。入力してください。PayU はウェブフックを再試行します。

ウェブフックが verify_unavailable と応答する: verify_payment API はまだ決済を確認できていません。注文は確認状態になり、次回の受信時に再確認されます。

ウェブフックが busy または retry と応答する: 同じカートによる購入者の戻りが同時に処理中であったか、注文ステータスを設定できませんでした。PayU はウェブフックを再試行します。理由はログに書き込まれます。

ウェブフックが ignored_unknown_txnid と応答する: このトランザクションは、このストアによって開始されたものではありません。例えば、同じ PayU アカウントを使う別のストアなどです。何も変更されません。

購入者に PayU India には電話番号が必要と表示される: 注文に電話番号がありません。チェックアウトの Telephone フィールドを残してください。OpenCart 4 では、購入者は確認ブロックの Phone フィールドに番号を入力できます。

購入者に This payment method is not available. Please reload the checkout page. と表示される: その間に決済方法がオフにされたか、認証情報が不足しているか、チェックアウトが注文と一致しなくなりました。購入者はチェックアウトを再読み込みしてください。

注文が確認ステータスになっている: VibeFox PayU India Payment Gateway タブのメモを確認してください。理由は、金額または通貨の不一致、失敗または保留中の確認、あるいはキャンセルされた注文に対する決済です。

返金に失敗する: PayU transaction ID not found for this order. は、その注文にまだ PayU の決済がないことを意味します。This payment was made in Test mode, but the Merchant Key/Salt of that mode are not set.(または Live mode)は、そのモードの認証情報を先に入力する必要があることを意味します。Invalid refund amount: at most … INR can be refunded. は、金額が決済の残額を超えていることを意味します。

ログの情報が少ない: エラーと警告は常に書き込まれます。すべての決済フォームと PayU の結果も確認するには、Enable Logging をオンにしてください。

開発者向け: 決済リクエストに署名する前に、拡張機能はリクエストのフィールドと注文を含む OpenCart イベント payu_p_request_fields を発行します。このイベントでキー、トランザクション ID、金額、戻り URL を変更することはできません。

アンインストール

Extensions > Extensions に移動し、種類として Payments を選んで、VibeFox PayU India Payment Gateway の横にある Uninstall(赤い − ボタン)をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は拡張機能自身の設定を常に削除します: Enable/Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータス。これらは再インストール時に既定値に戻ります。拡張機能の OpenCart イベントも削除されます(OpenCart 4 では、そのイベントと起動アクションも削除されます。起動アクションにより、メンテナンスモードでもウェブフックと購入者の戻りが通過します)。Delete data on uninstall がオンの場合、その他のゲートウェイ設定(タイトル、説明、モード、キー、salt、決済の検証、ログ記録)とログも削除されます。オフの場合は、後で再インストールするために保持されます。PayU の取引記録と返金リクエストは常に保持されるため、以前に支払われた注文は再インストール後も返金できます。既存の注文は、決済のメモを保持します。

OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox PayU India Payment Gateway の横にある Uninstall(オレンジ色の − ボタン)をクリックしてから、アップロードしたパッケージを削除するために Delete(赤いゴミ箱ボタン)をクリックします。

PayU は、それぞれの所有者の商標です。この拡張機能は PayU と提携しておらず、PayU の承認を受けていません。