VibeFox Moyasar for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 でテスト済み）、または 4.0.2 以降（4.1.0.3 でテスト済み）。

PHP: 8.0 以降。

通貨: チェックアウトの通貨は SAR、AED、USD、EUR、KWD、BHD、OMR のいずれかである必要があります。それ以外の通貨の場合、チェックアウトで支払い方法は表示されません。

Moyasar アカウント: Moyasar アカウントのシークレット API キー（テストと本番）が必要です。使用されるのはシークレットキーのみです。支払いは Moyasar のページで行われるため、公開可能キー（publishable key）は不要です。Moyasar Dashboard で Webhook を設定することをお勧めします（設定を参照）。

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

インストール

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

OpenCart 3

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

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

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

4. Moyasar のシークレットキーを貼り付け、Save をクリックします。最初の保存で Webhook の共有シークレットが生成され、設定の上に一度だけ表示されます。このシークレットを使って Moyasar Dashboard で Webhook を設定してください（設定を参照）。

5. Enable/Disable をオンにし、Save をクリックします。テストモードでテスト注文を行い、その後 Test mode をオフにします。

OpenCart 4

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

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

3. Extensions > Extensions に移動し、種類として Payments を選択します。VibeFox Moyasar Payment Gateway を探し、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。

4. ライセンスキー、Moyasar のキー、Webhook を、OpenCart 3 の手順 3 から 5 と同じように入力します。設定ページとそのフィールドは両バージョンで同じです。違うのは Webhook URL だけです（Webhook URL を参照）。

新規インストール時は、支払い方法はオフ、テストモードはオンの状態で始まります。

設定

すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > Edit。セクションは左側に並んでおり、一覧の下にある Save ボタンでページ全体が保存されます。設定の上部では、現在のモードにシークレットキーがない場合（その場合、チェックアウトで支払い方法は非表示になります）、保存済みの Webhook 共有シークレットがない場合（その場合、Webhook はすべての呼び出しを拒否します）、またはストアの既定の通貨が対応していない場合に、ページが警告を表示します。拡張機能がテストモードで有効な間は、テストモードが有効です：支払いはシミュレーションされ、料金は請求されません。 と表示されます。拡張機能を変更する権限がない場合、ページは設定を表示しますが、保存はできません。

保存時には、Title は 1 〜 128 文字である必要があり、Sort Order は整数である必要があり（負の数も使用可能）、Total は 0 以上の数値である必要があり、ジオゾーンと注文ステータスが存在している必要があります。それ以外の場合は何も保存されません。拡張機能は公開可能キー、もう一方のモードのキー、または空白を含むキーを拒否します。残りの設定は 設定は保存されました。ただし赤で表示されたキーを除きます。 と表示されて保存され、以前のキーは保持され、理由が表示されます。現在のモードのシークレットキーがないまま拡張機能が有効化された場合、設定は警告付きで保存されます。

Moyasar

Enable/Disable: Enable Moyasar は、支払い方法をオンまたはオフにします。既定値：オフ。

Title: 顧客がチェックアウトで見る支払い方法の名前です。注文に保存される支払い方法名でもあります。既定値：Pay with Moyasar。必須、128 文字まで。

Description: Confirm Order のステップで、確認ボタンの上に顧客に表示されるテキストです。既定値：You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. テストモードでは、このステップに （テストモード：実際の支払いは行われません。） が追加されます。

Sort Order: チェックアウトにおける支払い方法の中での Moyasar の表示順です。空欄のままにするか、整数を入力します。

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

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

API キー

シークレットキーは Moyasar Dashboard > Settings > API Keys からコピーしてください（そのページへのリンクがあります）。テストキーと本番キーは別々です。テストモードではテストキーのみを、本番モードでは本番キーのみを使用します。

Test mode: テスト用のシークレットキーを使用します。支払いはシミュレーションされ、料金は請求されません。既定値：オン。本番のシークレットキーで実際の支払いを受け付けるにはオフにします。もう一方のモードの請求書は、ステータスの確認や返金のために、そのモード自身のキーを引き続き使用します。

Test secret key: テストモードのシークレットキーです。sk_test_ で始まります。

Live secret key: 本番モードのシークレットキーです。sk_live_ で始まります。

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

支払い通知（Webhook）

Webhook は推奨されますが、必須ではありません。注文は、顧客がストアに戻ったときや、請求書が支払われたときに Moyasar がストアへ自動的に送信する請求書通知によっても確定します。Webhook は、戻る前にブラウザを閉じてしまった顧客を補い、Moyasar Dashboard で行われた返金も反映します。Moyasar Dashboard > Settings > Webhooks で追加してください。

Webhook URL: 読み取り専用で表示され、Copy ボタンがあります。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook、OpenCart 4 では https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook のような形式で、OpenCart インストールのストアフロントのアドレスから生成されます。URL は設定に表示されているとおりに正確にコピーしてください。HTTP メソッド：POST。この URL はインターネットから到達可能である必要があります。

Webhook shared secret: Moyasar の Webhook にある Shared secret と同じ値を入力するか、Generate a new secret にチェックを入れて保存します。何も保存されていない場合、Save はランダムなシークレットを生成します。生成されたシークレットは、保存後に設定の上部に一度だけ表示され、それ以降は表示されないため、すぐに Moyasar へコピーしてください。正しい共有シークレットのない Webhook は拒否されます。1 つの共有シークレットが両方のモードで使われます。

Webhook には次のイベントを選択してください（これらはこのセクションにも記載されています）：

payment_paid: 顧客が請求書を支払いました。

payment_failed: 支払いに失敗しました。

payment_refunded: 支払いが返金されました（例：Moyasar Dashboard での返金）。

payment_voided: 支払いが取り消されました。

Webhook や通知の内容は、そのまま信頼されることはありません。拡張機能は、そのたびに、請求書が作成されたモードのシークレットキーを使って Moyasar API から請求書を読み取り、その請求書がこのストアによって作成されたものであることを確認します。同じ Moyasar アカウント上の他の連携による支払いは無視されます。

注文

OpenCart は、Confirm Order のステップで注文をステータスなし（注文未確定）として作成します。注文にステータスが設定されるのは、Moyasar が請求書を確認した後だけです。下の各フィールドには、お使いの OpenCart の注文ステータスが表示されます。

Status after payment: 確認された支払いの後に設定されるステータスです。既定値：処理中。支払い済みの注文をすぐに完了させたい場合は Complete を、支払い済みのすべての注文を手動確認まで待たせたい場合は確認用のステータスを選択してください。

Awaiting Moyasar payment status: Moyasar が支払いを確認のために保留します。Moyasar が支払いを確認すると、注文は Status after payment に移行します。既定値：保留中。

Moyasar payment on hold status: Moyasar が注文合計と異なる金額または通貨を報告した場合、あるいは注文がキャンセルされたり別のステータスに変更されたりした後に請求書が支払われた場合です。注文は支払い済みにはなりません。既定値：保留中。OpenCart には「保留」ステータスがないためです。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。

Payment error status: 確認中の支払いが失敗しました。既定値：失敗。

Refunded status: 注文ページから支払い全額の返金を行った後に設定されます。既定値：返金済み。

詳細設定

Debug log: API の呼び出しと通知を、OpenCart のログフォルダ（storage/logs）内の moyasar_p_debug.log.php に記録します。このファイルは Web から開くことはできず、5 MB に達すると moyasar_p_debug.old.log.php に移動されます。エラーと警告は常に記録されます。API キー、カード情報、顧客の詳細は記録されません。既定値：オフ。

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

Clean uninstall: オンの場合、拡張機能をアンインストールすると、ゲートウェイの設定とログが削除されます。注文と一緒に保存された支払いの詳細（Moyasar の請求書と支払い ID）は、返金を追跡できるように保持されます。既定値：オフ。

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

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

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

チェックアウト

Payment Method のステップで、顧客は支払い方法を選択します（既定では Pay with Moyasar）。Confirm Order のステップで、顧客にはお使いの説明が表示されます。OpenCart はこのステップで、まだステータスのない注文を作成します。顧客が Confirm Order をクリックすると、拡張機能は注文の通貨で注文合計の Moyasar 請求書を作成し、顧客をその支払いページへ送ります。そこで顧客は、お使いの Moyasar アカウントで有効になっている任意の方法で支払いを行います。OpenCart 4 では、顧客は支払い方法ブロックの Choose ボタンから、Payment method options のウィンドウで支払い方法を選択し、チェックアウトページ下部の Confirm Order をクリックします。請求書には Order #、注文番号、ストア名が表示されます。

注文が支払い済みとしてマークされるのは、Moyasar が確認した後だけです。拡張機能は Moyasar API から請求書を読み取り、支払い済みであること、この注文に属していること、そして注文の金額と通貨とまったく一致していることを確認します。その後、注文は OpenCart の標準の方法でステータスを取得し、通常の注文メールが送信され、在庫が更新されます。顧客には OpenCart の注文完了ページが表示され、Moyasar でのお支払いを受け付けました。 と表示されます。Moyasar が支払いを確認のために保留している場合、ページには お支払いは Moyasar によって確認中です。Moyasar が確認すると注文は自動的に更新されます。再度お支払いいただく必要はありません。 と表示されます。注文がお店側の確認のために保留されている場合、ページには お支払いを受け付け、ご注文を確認しています。必要な場合はご連絡いたします。再度お支払いいただく必要はありません。 と表示されます。確認中の支払いが後で失敗した場合、ページには Moyasar でのお支払いは完了しませんでした。この注文についてお問い合わせください。 と表示されます。

顧客が支払わずに戻ってきた場合（例：支払いページの戻るボタンを使用した場合）、次のいずれかのメッセージとともにチェックアウトに戻ります：Moyasar での支払いは完了しませんでした。もう一度お試しいただくか、別の支払い方法をお選びください。、Moyasar でのお支払いは拒否されたか、期限切れになりました。もう一度お試しいただくか、別の支払い方法をお選びください。、または支払いをまだ確認できない場合は Moyasar でのお支払いはまだ確認できていません。お支払いが完了している場合、数分以内に注文は自動的に更新されます。再度お支払いいただく前に、メールをご確認ください。 OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。カートは保持されます。

顧客は再試行できます。OpenCart 3 では、Confirm Order のステップが表示されるたびに新しい注文が作成されますが、OpenCart 4 はチェックアウトで 1 つの注文を保持し、同じ注文を再度支払います。拡張機能は、同じカートの未処理の請求書をまず確認します。この注文の未処理の支払いページが同じモード、金額、通貨のままであれば、それを再利用します。そうでなければ、古い請求書は Moyasar でキャンセルされ、新しい請求書が作成されるため、古い請求書はもう支払えなくなります。カートの以前の請求書がすでに支払い済みであることが判明した場合は、新しい支払いを作成する代わりにその支払いを確認します。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その間に支払いのないまま注文が閉じられた場合（例：キャンセルされた、または支払いが失敗した）、顧客は Your previous order was cancelled or its payment failed. Please confirm the order again. とともにチェックアウトに戻され、次の Confirm Order では新しい注文の支払いが行われます。支払い後にキャンセルまたは返金された注文は、もうそのカートを保持しません。

Moyasar が支払いを開始できない場合、顧客は Confirm Order のステップに留まり、ボタンの上に短いメッセージが表示されます。例えば Moyasar の支払いサービスが応答していません。数分後にもう一度お試しください。 です。顧客は別の支払い方法を選択できます。詳細はログに書き込まれます。

Webhook と請求書通知は、ストアがメンテナンスモードの間も機能します。その理由は、OpenCart 3 が支払い拡張機能のリクエストを通過させ、OpenCart 4 では拡張機能がそのために起動時アクションを追加し、これにより顧客も Moyasar から戻れるためです。

この拡張機能が扱うのは Moyasar のページでの一回限りの支払いのみです。お使いのチェックアウトにカードフォームはなく、保存済みカードやトークン化、サブスクリプション、承認と売上確定の分離もありません。

注文と返金

注文ステータス

ステータスなし（注文未確定）：顧客は Moyasar に送られたものの支払っていない、Moyasar がまだ支払いを確認していない、または支払いが拒否、期限切れ、キャンセルされた場合です。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。

Status after payment（既定値処理中）：支払いが確認されました。メモには、支払いがどのように確認されたか（Webhook、請求書通知、顧客の戻り、またはチェックアウト）、請求書 ID、支払い ID、そして支払い方法（例：カードブランドと下 4 桁）が表示されます。

Awaiting Moyasar payment status（既定値保留中）：Moyasar が支払いを確認のために保留します。Moyasar が支払いを確認すると注文は Status after payment に、支払いが失敗すると Payment error status に移行します。

Moyasar payment on hold status（既定値保留中）：Moyasar が注文合計と異なる金額または通貨を報告したか、注文をキャンセルまたはステータス変更した後に請求書が支払われました。注文は支払い済みにはなりませんが、実際に請求された金額は返金のために記録されます。メモに理由が説明されます。Moyasar Dashboard で支払いを確認してから、注文を処理するか、支払いを返金してください。

Payment error status（既定値失敗）：確認中の支払いが失敗しました。

Refunded status（既定値返金済み）：この拡張機能を通じて支払いが全額返金されました。

支払い済みまたは返金済みの注文が、後のイベントによって元に戻されることはありません。お客様ご自身がすでに支払い済みのステータスを設定していた場合、支払いは記録されますが、ステータスは変更されません。すでに支払い済みのカートの 2 枚目の請求書も支払われた場合（例：ブラウザの 2 つのタブから）、支払い済みの注文は変更されません。メモで、Moyasar Dashboard で重複した支払いを返金するよう通知されます。

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

VibeFox Moyasar Payment Gateway タブ

Sales > Orders で、Moyasar で支払われた注文を開きます。注文ページの下部、History と Additional の隣にある VibeFox Moyasar Payment Gateway タブには、Moyasar invoice（テスト支払いには Test mode のラベル付き）、Moyasar payment、Method、Status、Paid / refunded の金額、返金フォーム、返金履歴、そして注文の Moyasar notes が表示されます。このタブは、拡張機能へのアクセス権があるユーザーに表示されます。

返金

VibeFox Moyasar Payment Gateway タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。任意で Reason (optional) を入力し、Refund via Moyasar をクリックします。この金額を Moyasar 経由で返金しますか？この操作は取り消せません。 の確認に同意してください。全額返金と一部返金に対応しています。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。返金は、Moyasar が請求した金額と通貨で行われます。そのため、金額に不一致があった場合は、注文合計ではなく、顧客が実際に支払った金額までしか返金できません。2 時間以内に行われたカード支払いの全額返金は、取り消し（void：決済前のキャンセル、手数料なし）として送信されます。STC Pay による支払いやその他すべての場合は通常どおり返金されます。返金は、支払いが行われたモード（テストまたは本番）のシークレットキーを使用するため、そのモードのキーが設定されている必要があります。拡張機能は、まず Moyasar で支払いの通貨、ステータス、返金可能な金額を確認します。Moyasar が返金を受け付けない場合、タブにエラーが表示され、返金は記録されません。返金または取り消しが成功すると、返金履歴とメモに追加されます。全額返金を行うと、注文は Refunded status になります。その際、顧客への通知や商品の在庫への戻しは行われず、手動でステータスを変更した場合と同じになります。部分返金ではステータスは変わりません。返金は、Moyasar が支払いを確認した後に利用できます。

Sales > Returns での商品返品では、Moyasar を通じた返金は行われません。

Moyasar Dashboard で行われた返金と取り消しは、Webhook を通じて届きます。Moyasar が拡張機能の記録よりも多くの返金額を示した場合、注文にメモが追加されます。注文ステータスは自動では変更されません。必要に応じて、Refund via Moyasar を使わずに手動で更新してください。

ライセンスキー

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

有効なキーがない場合、チェックアウトで Moyasar は顧客に表示されません。それでも支払いが開始された場合、顧客には 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 ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

Moyasar がチェックアウトに表示されない：ライセンスが有効であること、Enable/Disable がオンであること、現在のモードにシークレットキーがあることを確認してください。テストモードでは Test secret key、本番モードでは Live secret key です。キーがない場合、設定ページに警告が表示されます。顧客は SAR、AED、USD、EUR、KWD、BHD、OMR のいずれかで支払う必要があります（ストアで選択された通貨）。また、支払い先住所が選択した Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。

支払いは完了したが、注文がステータスなしのまま：確認通知がストアに届いていません。Webhook を設定してください。Moyasar Dashboard で、Webhook が存在すること、その URL が設定の Webhook URL と完全に一致すること、メソッドが POST であること、4 つのイベントがすべて選択されていること、そして共有シークレットが Webhook shared secret に保存されたものと一致することを確認します。注文は、顧客がストアに戻ったとき、または同じカートを再度支払おうとしたときにもステータスを取得します。

Webhook が Unauthorized を返す：Moyasar 側の共有シークレットが、保存されているものと異なります。Moyasar の Webhook のシークレットを Webhook shared secret に入力して保存するか、Generate a new secret にチェックを入れて保存し、表示されたシークレットを Moyasar に貼り付けてください。

Webhook が Webhook secret not configured を返す：共有シークレットが保存されていません。例えば Clear the saved value on save で削除した後などです。Save をクリックして生成し、Moyasar にコピーしてください。

Webhook が Key not configured を返す：請求書が、シークレットキーが空のモード（テストまたは本番）で作成されました。そのキーを入力してください。

Webhook が Verification failed または Try again later を返す：Moyasar API から請求書を読み取れなかった、同じ瞬間に別のリクエストによってカートが更新されていた、または注文ステータスを設定できなかった、のいずれかです。Moyasar は Webhook を再送します。理由を確認するには Debug log をオンにしてください。

Webhook の URL をブラウザで開くと Method not allowed と表示される：これは正常です。この URL は Moyasar からの POST リクエストのみを受け付けます。

キーに関する保存時のエラー：公開可能キー（pk_...）や別のモードのキーが貼り付けられたか、キーに空白が含まれています。以前の値は保持されています。テストキーは sk_test_、本番キーは sk_live_ で始まります。

Confirm Order の後に顧客がエラーを見る：Debug log をオンにして、拡張機能のページにある Log フィールドを確認してください。This payment method is not available. は、チェックアウトのセッションが注文と一致しなくなったこと、またはその間に支払い方法がオフにされたことを意味します。顧客はチェックアウトを再読み込みする必要があります。This payment method is temporarily unavailable. Please choose another payment method or contact us. は通常、シークレットキーが誤っているか不足していることを示します。A payment for this order has already been received and is being reviewed. Please contact us instead of paying again. は、カートにすでに支払い済みの請求書があるものの、その注文ステータスを設定できなかったことを意味します。ログを確認してください。

注文が支払い後に保留ステータスになっている：VibeFox Moyasar Payment Gateway タブの Moyasar notes を読んでください。支払われた金額または通貨が注文と異なっていたか、注文がキャンセルされた後に支払いが届いています。注文を処理するか、支払いを返金してください。

タブに返金フォームがない：タブに理由が表示されます。支払いがまだ確認されていない、全額返金済みである、またはお使いのユーザーグループに拡張機能を変更する権限がない、のいずれかです。

返金が失敗する：メッセージを確認してください。支払いがもう一方のモードで行われた場合は、そのモードのシークレットキーを入力してください。金額が、Moyasar でまだ返金可能な金額を超えている場合、支払いの一部がすでに返金されています（例：Moyasar Dashboard での返金）。Moyasar が返金済みの金額を確認していない場合は、再試行する前に Moyasar Dashboard で支払いを確認してください。

開発者向け：拡張機能は OpenCart イベント moyasar_p_supported_currencies と moyasar_p_invoice_params を発生させ、サポートされる通貨と請求書のデータを変更します。

アンインストール

Extensions > Extensions に移動し、種類として Payments を選択して、VibeFox Moyasar Payment Gateway の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します：Enable/Disable、Sort Order、Geo Zone、Total、そして Orders セクションの注文ステータス（再インストール時に既定値に戻ります）。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントと、メンテナンスモードで Webhook を通過させる起動時アクションも削除されます）。Clean uninstall がオンの場合、残りのゲートウェイ設定（タイトル、説明、テストモード、キー、Webhook の共有シークレット、デバッグログ）とログも削除されます。オフの場合は、後で再インストールするために保持されます。Moyasar の請求書、支払い、返金の記録は常に保持されるため、古い注文は、再インストール後も返金できます。既存の注文は、支払いのメモを保持します。

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

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