VibeFox Moyasar for Adobe Commerce

Overview

VibeFox Moyasar Payment Gateway adds payments through the Moyasar hosted payment page to Magento Open Source and Adobe Commerce. The customer chooses Moyasar at the payment step and clicks Place Order. Magento places the order in Pending Payment, and the customer goes to a Moyasar payment page created for the order, pays with mada, Visa, Mastercard, Apple Pay, STC Pay or another method active on your Moyasar account, and comes back to your store. Card data never touches your site. The order is invoiced only after Moyasar confirms the payment, and the order e-mail is sent only then.

It suits stores in Saudi Arabia and the GCC that want to accept local and international payments with a Moyasar account. The module takes one-time payments only. It has no card form on your own checkout, saved cards, subscriptions, separate authorize and capture, or payments for orders created in the Admin. Which methods appear on the Moyasar page is set in your Moyasar account, not in the module.

Key features

Moyasar payment page: an invoice is created for the order total in the order currency: SAR, AED, USD, EUR, KWD, BHD or OMR. Three-decimal currencies are converted to fils correctly. The invoice shows the order number and your store name.

Paid only when Moyasar confirms: the module reads the invoice from the Moyasar API with your secret key before it creates the invoice in Magento. The customer's return, the invoice notification and the optional webhook are checked the same way.

Amount and currency check: the paid amount and currency are compared with the order. A mismatch puts the order On Hold with a note and without an invoice, and the amount actually charged can be refunded from the order page.

No double processing: each payment is applied once, even when confirmations arrive together. A new payment attempt cancels the previous open Moyasar invoice, so the cart cannot be paid twice. A cancelled payment cancels the waiting order and gives the cart back.

Test and live modes: separate secret keys for each mode. Every payment is checked and refunded with the key of the mode it was made in, and a test payment never confirms an order while live mode is on.

Online refunds with Credit Memo: full and partial refunds through the standard Magento Credit Memo of the invoice with Refund. A full refund of a card payment within 2 hours is sent as a void. Refunds made in the Moyasar Dashboard are noted on the order.

Order status of your choice: Processing, Complete or On hold for manual review after a successful payment.

Standard Magento settings: all settings are on the standard Payment Methods configuration page, with encrypted keys, the webhook URL shown on the page, countries and minimum and maximum order totals, and an optional log without keys, card data or customer details.

Requirements

Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (your own server or Adobe Commerce on cloud infrastructure; not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4. A Moyasar account with secret API keys; a webhook in the Moyasar Dashboard is recommended. A VibeFox license key from vibefox.net (one key per domain).