VibeFox CCAvenue for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 6.0 以降がインストールされ、有効になっていること。これがないと、プラグインは有効化できません。

PHP: 8.0 以降。OpenSSL 拡張機能を含みます（リクエストの暗号化と応答の復号に使用します）。

CCAvenue アカウント: 加盟店 ID、アクセスコード、Working Key を持つ CCAvenue の加盟店アカウントが必要です。アクセスコードと Working Key はウェブサイトのドメインごとに発行されるため、このストアのドメイン用に生成してください。テスト環境でも CCAvenue は同じ認証情報を使用します。テストアクセスは、CCAvenue がお客様のアカウントで有効にする必要があります。プラグインは CCAvenue インドのエンドポイントを使用します。

通貨: 注文通貨は、そのまま CCAvenue に送信されます。CCAvenue のアカウントは既定で INR を受け付けます。その他の通貨は、CCAvenue のアカウントで多通貨処理が必要です。

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

インストール

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

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

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

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

5. CCAvenue のダッシュボードから Merchant ID、Access Code、Working Key を入力し、Enable/Disable をオンにします。

6. テスト中は Test mode をオンのままにし、実際の決済を受け付けるときにオフにします。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > CCAvenue。フィールドの上には、CCAvenue が有効なのに Merchant ID、Access Code、Working Key のいずれかが欠けている場合に警告が表示されます（その場合、3 つすべてが設定されるまで支払い方法はチェックアウトに表示されません）。テストモードがオンの間は、CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. と表示されます。ストアの通貨が INR でない場合は、多通貨処理に関する注意も表示されます。

一般

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

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

Description: チェックアウトで支払い方法の下に表示される説明文。既定値: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

API 認証情報

CCAvenue の加盟店ダッシュボード（M.A.R.S.）にログインし、Settings > API Keys を開きます。このストアのドメイン用に、アクセスコードと Working Key を生成してください。認証情報のスペースは、保存時に削除されます。

Merchant ID: 数字の CCAvenue 加盟店 ID。数字以外の文字が含まれている場合、保存時にエラーが表示され、以前に保存された値が保持されます。

Access Code: このウェブサイトのアクセスコード。

Working Key: このウェブサイトの Working Key（暗号化キー）。決済リクエストを暗号化し、CCAvenue の応答を検証する唯一の手段です。秘密にしてください。

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com)。CCAvenue はテストと本番で同じ Merchant ID、Access Code、Working Key を使用します。テストアクセスは、CCAvenue がお客様のアカウントで有効にする必要があります。テストモードでは、チェックアウトに TEST MODE: no real transactions will be processed. と表示されます。既定値はオンです。実際の決済を受け付けるにはオフにしてください。

戻り URL

CCAvenue は、このセクションに表示されるアドレスに購入者を戻します。https://your-site/wc-api/ccavenue_p_callback/ のような形式です。プラグインはこの URL を各決済とともに送信するため、CCAvenue で設定する必要はありません。CCAvenue に登録されたドメインに属している必要があります。

詳細設定

Debug log: Log CCAvenue events は、注文 ID、CCAvenue の参照番号、ステータスを WooCommerce > Status > Logs のソース wcp_ccavenue_payment に書き込みます。キー、カード情報、住所は記録されません。既定値はオフです。

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted。プラグインを無効化しても、何も削除されません。既定値はオフです。

チェックアウト

購入者は支払い方法（既定では CCAvenue）を選び、注文を確定します。Pay for order ページには Thank you for your order. You are being redirected to CCAvenue to complete the payment. と表示され、購入者は CCAvenue の決済ページに移動します。JavaScript が無効な場合、購入者は Pay via CCAvenue または Cancel order をクリックします。試行ごとに、新しい CCAvenue の注文参照が発行されます。注文合計と通貨、請求先と配送先の詳細、注文キーは、暗号化されたリクエストで送信されます。氏名と住所は、CCAvenue が受け付ける文字と長さに整えられます。国と州は名前として、電話番号は数字として送信されます。

決済後、CCAvenue は暗号化された応答とともに購入者を戻します。注文が支払い済みになるのは、CCAvenue が確認した後だけです。応答は貴店の Working Key で復号でき、この注文に属し、注文と同じ金額と通貨を含んでいる必要があります。その後、購入者は注文受付ページに到着します。

決済が失敗した場合、購入者は Payment was not completed. Please try again or choose a different payment method. と表示されてチェックアウトに戻ります。購入者が CCAvenue のページでキャンセルした場合、メッセージは 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 ページから）。Pay for order ページから支払いを開始し、カートが空の場合、WooCommerce はカートページにメッセージを表示します。失敗した注文は My account > Orders から再度支払うことができます。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。購入者向けのテキストはヒンディー語に翻訳されています。

結果は、購入者が CCAvenue から戻ったときにのみ取得されます。サーバー間の通知やステータスの問い合わせはありません。戻る前に購入者がブラウザーを閉じた場合、注文は支払い待ちのままになります。本プラグインには、WooCommerce からの返金、保存済みカード、定期購読や定期払い、iframe やサイト上のカード入力フォームはありません。また、CCAvenue UAE やその他の地域別プラットフォームには対応していません。

注文

注文ステータス

Pending payment: 購入者は CCAvenue に移動されましたが、まだ戻っていません。購入者が戻らない場合は、CCAvenue のダッシュボードで支払いを確認してください。

Processing: 支払いが確認されました（仮想のダウンロード可能な商品のみの注文は、WooCommerce の既定の動作どおり完了になります）。注文メモには、銀行の参照番号、CCAvenue のトラッキング ID、支払いモードが表示されます。注文の取引 ID は CCAvenue のトラッキング ID です。

On hold, amount/currency mismatch: CCAvenue が、金額または通貨が注文と異なる支払いを確認しました。例えば、購入者が支払いを開始した後で注文が編集された場合や、CCAvenue の割引オファーが適用された場合です。メモには、受け取った金額と想定された金額が表示されます。CCAvenue のダッシュボードで支払いを確認してから、注文を完了するか返金してください。

On hold, awaiting bank confirmation: CCAvenue が、支払いを Awaited と報告しました。お金がまだキャプチャされる可能性があるため、注文は失敗とは記録されません。注文を処理する前に CCAvenue のダッシュボードで確認し、ステータスを手動で変更してください。同じトラッキング ID を持つ後の応答も引き続き適用されます。

On hold, payment for a cancelled order: 購入者は、注文がキャンセルされた後に支払いました。在庫を確認し、注文を処理するか返金してください。

Cancelled: 購入者が CCAvenue のページで決済を中止しました。

Failed: 支払いが失敗したか、CCAvenue が Invalid、Timeout、またはその他の不成功のステータスを返しました。メモには CCAvenue のメッセージが表示されます。遅れて届いた失敗が、支払い済みの注文を変更することは決してありません。

すでに支払い済みの注文に対して別の支払いが成功した場合（例えば、2 つのブラウザータブから）、その注文は再び変更されません。メモで、CCAvenue のダッシュボードで重複分を返金するよう求められます。

返金: WooCommerce からの返金はサポートされていません。CCAvenue のダッシュボードで支払いを返金し、WooCommerce には手動で記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに CCAvenue が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、3 つの認証情報がすべて設定されていることを確認してください。Merchant ID、Access Code、Working Key です。設定ページに、いずれかが欠けている場合は警告が表示されます。

決済は完了したが、注文が Pending payment のまま: ブラウザーを閉じたなどの理由で、購入者が CCAvenue から貴店に戻っていません。プラグインにはサーバー間の通知がありません。CCAvenue のダッシュボードで支払いを確認し、注文を手動で更新してください。

すべての決済が We could not confirm the payment result で終わる: 応答を復号できません。Working Key が誤っているか、別のドメイン用のものか、余分な文字を付けてコピーされています。このストアのドメイン用にキーを生成し、貼り付け直してください。Debug log をオンにして、WooCommerce > Status > Logs をソース wcp_ccavenue_payment で確認してください。

決済ページの前に CCAvenue がエラーを表示する: アクセスコードと Working Key がこのドメイン用に生成されていること、戻り URL が CCAvenue に登録されたドメインに属していること、テストモードでは CCAvenue がお客様のアカウントでテストアクセスを有効にしていることを確認してください。INR 以外の通貨では、CCAvenue のアカウントで多通貨処理を有効にする必要があります。

購入者に This payment method is temporarily unavailable と表示される: いずれかの認証情報が欠けています。

購入者に Payment gateway error: encryption failed と表示される: リクエストを暗号化できませんでした。PHP の OpenSSL 拡張機能がインストールされているか確認してください。

支払い後に注文が On hold になっている: 注文メモを読んでください。支払われた金額または通貨が注文と異なっていたか、支払いが銀行の確認を待っているか、注文がキャンセルされていました。CCAvenue のダッシュボードで支払いを確認してから、注文を処理するか支払いを返金してください。

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

開発者向けには、readme に、CCAvenue に送信されるデータを変更するフィルター ccavenue_p_request_params（例: merchant_param2 から merchant_param5、または promo_code。amount、currency、order_id、merchant_param1 は変更しないでください）と、チェックアウトのアイコン用のフィルター ccavenue_p_icon が記載されています。

アンインストール

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

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