VibeFox Moyasar for OpenCart

Overview

VibeFox Moyasar Payment Gateway adds payments through the Moyasar hosted payment page to OpenCart 3 and OpenCart 4. At the last checkout step the customer clicks Confirm Order, is sent 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. OpenCart creates the order before the payment, but the order gets a status only after Moyasar confirms the payment, so unpaid attempts stay missing orders.

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

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.

Paid only when Moyasar confirms: the extension reads the invoice from the Moyasar API with your secret key before it sets the order status. The customer's return, the invoice notification and the optional webhook are checked the same way. OpenCart then sends its usual order e-mails.

Amount and currency check: the paid amount and currency are compared with the order. A mismatch puts the order in a review status with a note.

No double processing: each payment is applied once, even when confirmations arrive together. A new attempt reuses or cancels the open payment page of the cart, so it cannot be paid twice.

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.

Refunds from the order page: full and partial refunds in the VibeFox Moyasar Payment Gateway tab of the order, up to the amount Moyasar charged. 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.

Your own order statuses: choose the OpenCart status for a paid order, a payment Moyasar is reviewing, a payment on hold, a payment error and a full refund.

OpenCart conditions: geo zone, minimum order total and sort order. Log without keys, card data or customer details.

Requirements

OpenCart 3.0.x (tested on 3.0.5.0) or OpenCart 4.0.2 and later (tested on 4.1.0.3), PHP 8.0 or later. One download has the packages for both versions. 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).