VibeFox Cashfree for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。

PHP: 8.0 以降。

HTTPS: Cashfree は https:// の URL にのみウェブフックを配信します。HTTPS がなくても、顧客がストアに戻ったときに決済は確認されますが、本番稼働の前に HTTPS を有効にしてください。

Cashfree アカウント: Cashfree アカウントの App ID と Secret Key が必要です。テスト（サンドボックス）環境と本番環境それぞれに別々のものがあります。また、Cashfree Merchant Dashboard でウェブフックを設定する必要があります（設定を参照）。Secret Key はウェブフックの検証にも使われるため、別途ウェブフック用のシークレットはありません。注文の通貨が Cashfree アカウントで有効になっている必要があります。

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

インストール

このダウンロードは、両方の OpenCart バージョン用パッケージを含む 1 つの zip ファイルです。コンピューターで解凍してください。中には README.txt、OpenCart 3 用パッケージ wcp_cashfree_payment-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ wcp_cashfree_payment.ocmod.zip が含まれています。ご利用の OpenCart バージョンに合ったパッケージだけをインストールしてください。ライセンスキーは両バージョンで同じです。

OpenCart 3

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

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

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

4. Sandbox App ID と Sandbox Secret Key を入力し、Cashfree Merchant Dashboard でウェブフックを追加し（設定を参照）、Enable/Disable をオンにして、Save をクリックし、決済をテストします。

5. 準備ができたら、本番用の App ID と Secret Key を入力し、Sandbox Mode をオフにして、Save をクリックします。

OpenCart 4

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

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

3. Extensions > Extensions に移動し、種類として Payments を選択します。VibeFox Cashfree Payments を見つけて、Install（緑色の + ボタン）をクリックし、次に Edit（鉛筆ボタン）をクリックします。

4. ライセンスキー、Cashfree のキー、ウェブフックは、OpenCart 3 の手順 3〜5 と同じように入力します。設定ページとそのフィールドは両バージョンで同じです。ウェブフックの URL だけが異なります（ウェブフックを参照）。

新規インストールでは、決済方法がオフ、サンドボックスモードがオンの状態から始まります。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Cashfree Payments > Edit。セクションは左側に一覧表示されます。一覧の下にある Save ボタンで、ページ全体が保存されます。設定の上には、Cashfree が決済を確認した後にのみ注文がステータスを受け取ることが説明されています。決済方法が有効な場合、選択したモードの API キーがないとページに警告が表示され（その場合、決済方法はチェックアウトで非表示になります）、サンドボックスモードがオンの間は Sandbox mode is on: customers see a test checkout and no real money is charged. と表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。

保存時には、Title は空欄にできず（最大 128 文字）、API Version は一覧にあるバージョンのいずれかである必要があり、Sort Order は整数である必要があり、Total は 0 以上の数値である必要があり、ジオゾーンと注文ステータスは存在する必要があります。これらを満たさない場合は、何も保存されません。選択したモードのキーがないまま有効な決済方法を保存すると、キーが設定されるまで決済方法がチェックアウトで非表示のままになるという警告付きで、設定が保存されます。

Cashfree Payments

Enable/Disable: Enable Cashfree Payments は決済方法をオンまたはオフにします。既定値：オフ。

Title: チェックアウトで顧客に表示される決済方法の名前です。注文にも決済方法名として保存されます。既定値：Cashfree Payments。必須。

Description: Confirm Order のステップで、確認ボタンの上に顧客に表示されるテキストです。既定値：Pay securely via Card, UPI, Net Banking, Wallet via Cashfree.

Sort Order: チェックアウトにおける決済方法の中での Cashfree の位置です。空欄のままにするか、整数を入力します。

Geo Zone: 選択したジオゾーン内の支払い先住所に対してのみ Cashfree を表示します。既定値：All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。

Total: Cashfree が表示されるために注文が満たす必要がある、ストアの既定通貨での合計金額です。空欄にすると、どの金額でも Cashfree を表示します。通貨の Cashfree 最低金額（1 単位。小数点以下 3 桁の通貨では 0.01 または 0.1）を下回る金額には、決して表示されません。

モードと API キー

App ID と Secret Key は、Cashfree Merchant Dashboard の Developers > API Keys で確認できます（ページにはそこへのリンクがあります）。テスト用キーと本番用キーは異なります。

Sandbox Mode: テストには Cashfree のサンドボックスを使用します。実際の料金は請求されず、Confirm Order のステップと決済ページには SANDBOX MODE - no real payments will be processed. と表示されます。既定値：オン。実際の決済を行うには、オフにします。

Sandbox App ID: Cashfree のテスト環境の App ID です。

Sandbox Secret Key: Cashfree のテスト環境の Secret Key です。

App ID: Cashfree の本番環境の App ID です。

Secret Key: Cashfree の本番環境の Secret Key です。

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

決済は、作成された環境のまま保持されます。そのウェブフックは検証され、ステータスは確認され、返金もその環境のキーで送信されます。そのため、本番に切り替えた後もサンドボックスの決済が精算されるまでは、サンドボックスのキーを入力したままにしておいてください。

ウェブフック

ウェブフックは、決済が行われたか、失敗したか、返金されたかをストアに通知します。Cashfree Merchant Dashboard で Developers > Webhooks に移動し、このセクションの Webhook URL に表示されている URL を、Payment と Refund のイベントとともに追加します。URL は OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_cashfree_payment/webhook のような形式、OpenCart 4 では https://your-store/index.php?route=extension/wcp_cashfree_payment/payment/wcp_cashfree_payment.webhook のような形式で、OpenCart インストールのストアフロントのアドレスから組み立てられます。設定に表示されている URL を、そのままコピーしてください。HTTPS のストアでは、拡張機能は決済のたびにこの URL を Cashfree にも渡します。ストアが HTTPS を使用していない場合、このセクションに警告が表示されます。

拡張機能は次のイベントを処理します（これらもこのセクションに一覧で示されています）：

PAYMENT_SUCCESS_WEBHOOK: 決済が成功しました。金額と通貨の確認の後、注文はステータスを受け取ります。

PAYMENT_FAILED_WEBHOOK: 決済が失敗しました。注文はステータスなしのままで、顧客は再度支払うことができます。

PAYMENT_USER_DROPPED_WEBHOOK: 顧客が決済を離脱しました。注文はステータスなしのままで、顧客は再度支払うことができます。

REFUND_STATUS_WEBHOOK and AUTO_REFUND_STATUS_WEBHOOK: 返金のステータスが変わりました。返金 ID、金額、ステータスを含むメモが追加され、返金履歴には新しいステータスが表示されます。

Cashfree はすべてのウェブフックを、あなたの Secret Key で署名します。有効な署名のないウェブフックは拒否されます。ウェブフックは、決済が行われた環境の Secret Key で署名されている必要があるため、サンドボックスのキーが本番の決済を確認することは決してありません。このストアが開始していない決済（同じ Cashfree アカウント上の別のストアなど）に対する署名付きウェブフックは、確認応答されて無視されます。ウェブフックがない場合、注文は顧客が決済後にストアに戻ったときにのみ確認されます。顧客が決済後にブラウザを閉じた場合、注文を確認できるのはウェブフック（または同じカートに対する次の決済試行）だけです。

注文

OpenCart は、Confirm Order のステップで、ステータスのない注文（欠落した注文）を作成します。注文が状態を得るのは、Cashfree が決済を確認した後だけです。決済が失敗または中断された場合、注文はステータスなしのままになり、カートは保持されます。以下の各フィールドには、OpenCart の注文ステータスが表示されます。

Order Status After Payment: 決済が確認され、金額と通貨が一致した後に設定されるステータスです。既定値：処理中。

On Hold (Review) Status: Cashfree が、注文合計と異なる支払い金額または通貨を報告しました。メモには、想定された金額と受け取った金額が表示されます。既定値：保留中。OpenCart には保留ステータスがないためです。独自のステータスは System > Localisation > Order Statuses で作成し、ここで選択できます。

Refunded Status: 注文ページから決済が全額返金された後に設定されます。既定値：返金済み。

詳細設定

API Version: 使用する Cashfree API のバージョンです。

v1 (2022-09-01): 既定値。

v2 (2023-08-01): 新しい API バージョンです。

Order ID prefix: Cashfree の注文 ID は、プレフィックス + OpenCart の注文 ID で構成されます。同じ注文に対する新しい試行には、末尾に番号が付きます（例：123-2）。空欄のままにすると、フィールドの説明に表示されるこのストアの自動プレフィックスが使われます（OC、ストアのアドレスから得られる 4 文字とハイフン）。同じ Cashfree アカウントに接続されているストアごとに、異なるプレフィックスを使用してください。使用できるのは英字、数字、「_」、「-」のみで、最大 20 文字です。それ以外の文字は、保存時に警告付きで削除されます。

Debug log: エラーは常に記録されます。オンにすると、Cashfree API の呼び出しとウェブフックも、OpenCart のログフォルダ（storage/logs）内の cashfree_p_debug.log.php に記録されます。このファイルは Web から開くことはできず、5 MB に達するとローテーションされます。キーと顧客データは決して記録されません。既定値：オフ。

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

Delete Data on Uninstall: オンにすると、拡張機能のアンインストール時に Cashfree の設定と拡張機能のログが削除されます。注文、およびその Cashfree の取引と返金は常に保持されます。既定値：オフ。

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

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

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

チェックアウト

Payment Method のステップで、顧客は決済方法を選択します（既定では Cashfree Payments）。Confirm Order のステップで、顧客にはあなたの説明と、安全に支払うため、Cashfree のチェックアウトに移動します（カード、UPI、ネットバンキング、ウォレット）。 という注記が表示されます。OpenCart はこのステップで注文を作成しますが、まだステータスはありません。顧客が Confirm Order をクリックすると、拡張機能は注文通貨での注文合計に対する Cashfree 注文を作成し、Cashfree payment ページを開きます。このページには Cashfree での支払いのためにリダイレクトしています... と表示され、Cashfree のチェックアウトが読み込まれます。自動で開かない場合は、顧客が Pay Now をクリックできます。Cashfree のチェックアウトでは、顧客は Cashfree アカウントで有効になっている任意の方法（たとえばカード、UPI、ネットバンキング、ウォレット）で支払います。顧客のメールアドレスと電話番号は Cashfree に渡されます。OpenCart 4 では、顧客は決済方法のブロックにある Choose ボタンを押し、Payment method options ウィンドウで決済方法を選択してから、チェックアウトページ下部の Confirm Order をクリックします。OpenCart 4 では既定で電話番号を求めません。注文に電話番号がない場合、確認ブロックに任意の Phone フィールドが表示されます（任意: Cashfree（UPI、OTP）用の支払者の電話番号です。）。形式が正しくない場合は、有効な電話番号（10 桁、または + と国番号）を入力するか、フィールドを空欄のままにしてください。 と表示されます。番号は次回の試行のために記憶されます。

決済の後、顧客はストアに戻ります。注文は、Cashfree が署名付きウェブフックによって、または顧客が戻ったときのサーバー側のリクエストによって確認した後にのみ、支払い済みとしてマークされます。その後、注文は通常の OpenCart の方法でステータスを受け取り、通常の注文メールと在庫更新が行われ、顧客には OpenCart の注文成功ページが表示されます。UPI アプリから戻った場合など、別のブラウザでも戻りは機能します。銀行がまだ決済を確認していない場合、Payment confirmation ページに Your payment is being processed by the bank. We will update the order as soon as Cashfree confirms it — please do not pay again. と表示され、Check again ボタンが表示されます。銀行が決済を確認すると、ウェブフックが直ちに注文ステータスを設定します。OpenCart 4 では、Cashfree が顧客を戻す際にブラウザがストアのセッションを送信しないため、拡張機能はまず短いページを表示し、ストアから同じ戻り先アドレスを開き直します。顧客はカートとログイン状態を維持します。

決済が失敗した場合、または顧客が支払わずに Cashfree のページを離れた場合、顧客は Cashfree の決済は完了しませんでした。もう一度お試しいただくか、別の決済方法をお選びください。 と表示されたチェックアウトに戻ります。OpenCart 4 では、チェックアウトのメッセージがチェックアウトページの上部に表示されます。注文はステータスなしのまま残り、カートは保持されます。OpenCart 3 は Confirm Order のステップが表示されるたびに新しい注文を作成しますが、OpenCart 4 はチェックアウトの注文を 1 つ保持して更新するため、顧客は同じ注文を再度決済します。同じ注文の未完了の Cashfree 決済は、金額が変わっておらず 5 分以上の余裕がある場合に再利用されます。そうでない場合は、古い Cashfree 注文が閉じられ、新しい注文が作成されます。同じカートの以前の注文の未完了の Cashfree 決済も閉じられるため、カートを二重に支払うことはできません。カートが Cashfree で既に支払われていたのに記録されていない場合、次の試行は再請求するのではなく、その決済を確認します。別の注文で既に支払い済みのカートに対しては再請求されません。顧客は成功ページに移動します。同じカートがそれでも二重に支払われた場合（たとえば 2 つのブラウザタブで同時に）、2 番目の注文はステータスなしのままになり、支払い済みの注文には、顧客が二重に請求された可能性があるというメモが付くため、Cashfree のダッシュボードで返金できます。

OpenCart 4 では、成功ページが表示されるまで注文はチェックアウト内に保持されます。その間に注文が閉じられた場合（たとえばキャンセル）で、Cashfree がその注文の代金を保持していなければ、顧客は Cashfree の決済は完了しませんでした。もう一度お試しいただくか、別の決済方法をお選びください。 と表示されたチェックアウトに戻され、次の Confirm Order ではカートの新しい注文が決済されます。注文にすでにステータスがあり、その後カートが変更されている場合（他の商品や数量の変更）、顧客は 以前の注文はすでに受け付けられています。注文をもう一度確認してください。現在のカートは新しい注文で決済されます。 と表示されたチェックアウトに戻されます。

Cashfree が決済を開始できない場合、顧客は Confirm Order のステップに留まり、ボタンの上に Cashfree の決済を開始できませんでした。もう一度お試しいただくか、別の決済方法をお選びください。 と表示されます。技術的な理由はログに書き込まれます。Cashfree の最低金額（通貨の 1 単位。KWD のような小数点以下 3 桁の通貨は 0.01、TND は 0.1）を下回る注文合計は Cashfree で支払うことができず、その注文では決済方法が表示されません。

ウェブフックは、ストアがメンテナンスモードの間も機能します。OpenCart 3 は決済拡張機能のリクエストを通過させ、OpenCart 4 では拡張機能がウェブフックと顧客の戻りを通過させるスタートアップアクションを追加します。

この拡張機能は、Cashfree のチェックアウトでの一回限りの決済のみを受け付けます。保存されたカード、サブスクリプション、定期決済はなく、個別のオーソリとキャプチャもなく、Cashfree のオファーウィジェット、Cashfree 経由の代金引換や決済リンクもありません。また、通貨の換算は行わず、注文は注文通貨で請求されます。

注文と返金

注文ステータス

ステータスなし（欠落した注文）: 顧客は Cashfree に移動したが、まだ支払っていないか、決済が失敗したか、銀行で決済がまだ保留中です。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合のみ表示されます。

Order Status After Payment（既定値処理中）: 決済が確認されました。メモには Cashfree の取引 ID と、支払い方法のグループ（たとえば upi や credit_card）が表示されます。

On Hold (Review) Status（既定値保留中）: Cashfree が、注文合計と異なる支払い金額または通貨を報告しました。メモには、想定された金額と受け取った金額、および取引 ID が表示されます。Cashfree のダッシュボードで決済を確認してから、注文を処理するか、決済を返金してください。

Refunded Status（既定値返金済み）: 拡張機能を通じて決済が全額返金されました。

待機中の注文に手動でステータス（たとえばキャンセル）を設定した後に決済が届いた場合でも、その決済は記録され、代金は既に受け取られているため注文は支払い済みになります。OpenCart はこの変更を顧客に通知します。支払い済みの注文は、その後の失敗した決済によって元に戻ることはなく、支払い済みの注文に対する 2 回目の決済によって変更されることもありません。

メモは、顧客には表示されない注文の History のエントリです。

VibeFox Cashfree Payments タブ

Sales > Orders で、Cashfree で支払われた注文を開きます。注文ページの下部、History と Additional の横にある VibeFox Cashfree Payments タブには、サンドボックスの決済の場合は Sandbox ラベル付きの Transaction ID、Cashfree order、決済の Status、Paid / refunded の金額、返金フォーム、各返金のステータスを含む返金履歴、そして注文の Cashfree notes が表示されます。このタブは、拡張機能へのアクセス権を持つユーザーに表示されます。

返金

タブで Amount（まだ返金されていない金額が自動入力されます）を入力し、必要に応じて Reason (optional) を入力して、Refund via Cashfree をクリックします。Refund this amount through Cashfree? This cannot be undone. の確認に応じてください。全額返金と部分返金に対応しています。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。返金は Cashfree が請求した金額と通貨で行われるため、金額に不一致がある場合は、注文合計ではなく、顧客が実際に支払った金額まで返金できます。返金は、支払われたサンドボックスまたは本番の環境のキーを使って、支払われた Cashfree 注文に送信されるため、そのうえで環境のキーが入力されている必要があります。Cashfree が返金を受け付けない場合、または返金をキャンセルまたは拒否と報告した場合、タブにエラーが表示され、返金は記録されません。開始された返金は、返金 ID、金額、ステータスとともに返金履歴とメモに追加されます。全額返金の場合、顧客には通知せず、商品を在庫に戻すこともなく、手動でのステータス変更と同様に注文を Refunded Status に設定します。部分返金ではステータスは変更されません。返金は、Cashfree が決済を確認した後に利用できるようになります。

最終的な返金ステータスは返金ウェブフックで届き、メモに追加されます。Sales > Returns での商品返品は、Cashfree を通じて返金されることはありません。

ライセンスキー

この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Cashfree Payments は、Extensions > Extensions > Payments > VibeFox Cashfree Payments > Edit の最初のブロックで、設定の上にあります。キーを License key に貼り付けて、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（たとえば、ライセンスの有効期限日とドメイン）、および Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このストアからキーを削除）のボタンが表示されます。その下には、Product: opencart-payment-cashfree の行と、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 のアカウントで枠を解放してください。

有効なキーがない場合、チェックアウトで顧客に Cashfree は表示されません。それでも決済が開始された場合、顧客には この決済方法は利用できません。別の方法をお選びください。 と表示されます。同じブラウザで管理画面にログインしている管理者ユーザーには、（未ライセンス — 管理者のみに表示）と表示されたうえで、ストアに決済方法が表示されます。そのため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 では、このプレビューは利用できません。ストアからは管理画面へのログインが見えないため、有効なキーがない場合は、決済方法がすべての人に対して非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると、7 日間非表示になります。既存の注文は影響を受けません。すでに開始された決済は引き続き確認され、返金も機能します。

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

トラブルシューティング

Cashfree がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードにキーが設定されていることを確認してください。サンドボックスモードでは Sandbox App ID と Sandbox Secret Key、本番モードでは App ID と Secret Key です。キーがないと、設定ページに警告が表示されます。注文合計が Cashfree の最低金額を下回る場合も、決済方法は非表示になります。また、支払い先住所が選択した Geo Zone に含まれていること、および注文が設定の Total に達していることも確認してください。

決済は完了したのに、注文がステータスなしのまま: ウェブフックが機能していません。ストアが HTTPS を使用していること、Developers > Webhooks の URL が Webhook URL に表示されているものと完全に一致していること、そして Payment のイベントが選択されていることを確認してください。設定の Secret Key が、決済が行われた環境のものであることを確認してください。Cashfree のダッシュボードには、ウェブフックごとにストアからの応答が表示されます。注文は、顧客が決済後にストアに戻ったときや、同じカートの次の決済試行のときにも、ステータスを受け取ります。

ウェブフックが Missing signature または Invalid signature と応答する: 呼び出しに有効な Cashfree の署名が含まれていなかったか、設定の Secret Key が決済の行われた環境と一致しません。サンドボックスのキーと本番のキーが入れ替わっていないか確認してください。

ウェブフックが Ignored と応答する: ウェブフックは正しく署名されていますが、このストアが開始していない決済（同じ Cashfree アカウント上の別のストアなど）に属しています。各ストアに個別の Order ID prefix を割り当ててください。

ウェブフックが Busy, retry later と応答する: 注文が同じタイミングで別のリクエストによって確認されていたか、注文ステータスを設定できませんでした。Cashfree はウェブフックを再試行します。理由を確認するには Debug log をオンにしてください。

顧客に「Cashfree の決済ページを読み込めませんでした。もう一度お試しください。」と表示される: ブラウザーが Cashfree のスクリプトを読み込めませんでした。たとえばブロッカーによる影響が考えられます。顧客は Pay Now を再度クリックするか、Choose another payment method を選択できます。

顧客に「Cashfree の決済を開始できませんでした」と表示される: 拡張機能のページの Log フィールドを確認してください。典型的な原因は、選択したモードに対するキーの誤りや、Cashfree アカウントで有効になっていない通貨です。

Confirm Order の後に顧客に「この決済方法は利用できません。」と表示される: チェックアウトのセッションが注文と一致しなくなったか、その間に決済方法がオフにされました。顧客がチェックアウトを再読み込みします。

顧客に「決済セッションが見つかりません。もう一度お試しください。」と表示される: 決済ページのリンクが、このストアの決済に属していないか、Cashfree のセッションが終了しています。顧客は注文を再度確認します。

顧客に「決済を確認できませんでした」と表示される: 戻りのリンクが決済と一致しませんでした。代金が請求されている場合、ウェブフックは引き続き注文を確認します。顧客が再度支払う前に、Cashfree のダッシュボードで決済を確認してください。

決済後、注文が確認状態になる: VibeFox Cashfree Payments タブのメモ（注文ステータスを参照）を読み、注文を処理するか、決済を返金してください。

タブに返金フォームが表示されない: タブには理由が表示されます。決済がまだ確認されていない、全額返金されている、ユーザーグループに拡張機能を変更する権限がない、または決済の環境の API キーが設定されていない、などです。

返金が、サンドボックスまたは本番モードに関するメッセージとともに失敗する: 決済はその環境で行われており、その API キーが設定されていません。キーを入力して、もう一度お試しください。

アンインストール

Extensions > Extensions に移動し、種類として Payments を選択して、VibeFox Cashfree Payments の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自体の設定を常に削除します。Enable/Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータスで、これらは再インストール時に既定値に戻ります。OpenCart 4 では、拡張機能のイベントと、メンテナンスモードでもウェブフックを通すスタートアップアクションも削除されます。Delete Data on Uninstall がオンの場合、その他の Cashfree の設定（タイトル、説明、モード、キー、API バージョン、注文 ID のプレフィックス、ログ記録）とログが削除されます。オフの場合は、後で再インストールするために保持されます。Cashfree の取引と返金は常に保持されるため、以前に決済された注文は、再インストール後も返金できます。既存の注文は、決済メモを保持します。

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

Cashfree は、その所有者の商標です。この拡張機能は Cashfree とは提携しておらず、Cashfree による承認もありません。