概要
VibeFox Moyasar Payment Gateway は、Moyasar のホステッド決済ページによる支払いを PrestaShop に追加します。支払いの手順で購入者が Moyasar を選ぶと、カート用に作成された Moyasar の決済ページに移動し、mada、Visa、Mastercard、Apple Pay、STC Pay、または Moyasar アカウントで有効になっている他の方法で支払い、ストアに戻ります。注文は Moyasar が支払いを確認した後にのみ作成されるため、途中で中断された支払いによって未払いの注文が残ることはありません。
Moyasar アカウントで国内外の支払いを受け付けたいサウジアラビアおよび GCC のストアに適しています。本モジュールは 1 回限りの支払いのみに対応しています。貴店のチェックアウトにカードフォームはなく、保存済みカード、サブスクリプション、個別のオーソリとキャプチャもサポートしていません。Moyasar のページに表示される支払い方法は、モジュールではなく Moyasar アカウントで設定します。
主な機能
Moyasar 決済ページ: カートの合計金額を、カートの通貨（SAR、AED、USD、EUR、KWD、BHD、OMR）の請求書として作成します。小数点以下 3 桁の通貨も、fils に正しく変換されます。
Moyasar が確認した場合にのみ支払い済みとする: モジュールは、注文を作成する前に、貴店のシークレットキーを使って Moyasar API から請求書を読み取ります。購入者の戻り、請求書通知、任意のウェブフックも同じ方法で検証されます。
金額と通貨の確認: 支払われた金額と通貨をカートと照合します。不一致の場合、注文は Moyasar payment on hold となり、メモが残されます。
二重処理の防止: 確認が同時に届いても、各支払いは 1 回だけ適用されます。カートの合計金額が変更された場合は、古い決済ページを閉じます。
テストモードと本番モード: モードごとに別々のシークレットキーを使用します。各支払いは、行われたモードのキーで検証および返金されます。
注文画面からの返金: Moyasar payment ブロックで、Moyasar が請求した金額を上限として、全額返金と一部返金ができます。2 時間以内に行われたカード支払いの全額返金は、取り消し（void）として送信されます。Moyasar Dashboard で行われた返金は注文に記録されます。
任意の注文ステータス: 支払いが成功した後、Payment accepted、Delivered、Moyasar payment on hold のいずれかに、ステータス変更 1 回で設定できます。
注文画面の Moyasar ブロック: 請求書、支払い、カード、返金履歴、およびモジュールのメモを表示します。ログにはキー、カード情報、顧客情報は記録されません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。Moyasar アカウントとシークレット API キー（推奨：Moyasar Dashboard でのウェブフック設定）。VibeFox ライセンスキー（vibefox.net で入手、1 つのキーは 1 つのドメインで使用可能）。