Magento 2 Moyasar Payment Gateway

Key Features

Native Magento 2 payment method built with the Gateway Command pattern (config.xml + di.xml), so it works across quote, order, invoice and credit-memo flows like a first-class method

Lightweight embedded Moyasar checkout form — no full-page redirect off your domain

mada, Visa and Mastercard, Apple Pay and STC Pay supported through a single configurable method

SAR settlement via the Moyasar REST API with server-side payment creation and verification

Webhook controller that validates Moyasar callbacks against your secret key before placing the order, preventing spoofed or premature order placement

Cron-backed reconciliation job that re-checks pending Moyasar payments and syncs Magento order states if a browser callback is lost

Full and partial refunds issued directly from the Magento credit-memo screen and pushed to Moyasar via API

Card tokenization so returning customers can reuse a saved instrument (Vault-compatible storage)

Admin configuration under Stores → Configuration → Sales → Payment Methods with ACL resource, test/live key separation and per-store-view scope

Sandbox/test mode wired to Moyasar test keys for safe pre-launch verification

Structured logging of API requests, responses and webhook events for support and reconciliation

Adobe Commerce and Magento Open Source compatible; clean module boundaries for upgrade safety

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

This is a custom-built Magento 2 / Adobe Commerce payment integration for Moyasar, the Saudi payment processor — not an instant Adobe Commerce Marketplace download. ECOSIRE engineers the module to your store, installs it on your environment, and supports it after launch.

The extension ships as a proper module under app/code/Ecosire/Moyasar, registered through registration.php and module.xml. It implements Magento's payment service contracts (Magento\Payment\Model\MethodInterface via the Gateway Command/ValueHandler pattern in etc/config.xml and etc/di.xml), so it behaves like a first-class payment method across quote, order and invoice flows rather than a bolted-on redirect.

At checkout, customers pay through Moyasar's lightweight embedded form (mada, Visa/Mastercard, Apple Pay and STC Pay) without leaving your domain. Server-side, the module calls the Moyasar REST API to create and verify payments, validates the callback/webhook against your secret key, and only places the order once the payment is confirmed — closing the double-spend and abandoned-order gaps that naive integrations leave open. Settlement is in SAR.

Admin staff get a full system-config section under Stores → Configuration → Sales → Payment Methods with ACL-gated access, test/live key separation, and per-store-view scoping. Refunds (full and partial) are issued straight from the credit-memo screen and pushed to Moyasar via API. Optional tokenization lets returning customers reuse a saved card. A webhook controller and cron-backed reconciliation job keep Magento order states in sync with Moyasar even if a browser callback is lost.

Everything is delivered as readable, upgrade-safe code with a deployment runbook, so your team — or ECOSIRE — can maintain it across Magento minor upgrades.

What you get

Custom Magento 2 module (Ecosire_Moyasar) delivered under app/code with registration.php, module.xml, config.xml and di.xml

Installation and configuration on your Magento 2 / Adobe Commerce environment (staging then production) by ECOSIRE

Moyasar sandbox and live key wiring, with test transactions verified across mada, card, Apple Pay and STC Pay

Webhook endpoint and cron reconciliation job configured and confirmed against your Moyasar account

Admin walkthrough covering configuration, refunds from credit memos, and tokenization behavior

Deployment runbook plus README documenting setup, environment variables and upgrade notes

Post-launch support window and a versioned codebase you own

Who this is for

Saudi Magento merchant

An online retailer in Saudi Arabia who needs mada, Apple Pay and STC Pay at checkout and wants settlement in SAR through a local processor rather than a foreign gateway.

Magento developer / technical lead

An in-house or agency developer who wants a clean, upgrade-safe module under app/code using Magento's gateway service contracts — not a hacked-in redirect — so it survives minor upgrades and is easy to maintain.

Store operations and finance manager

The person handling orders and reconciliation who needs reliable order states, admin-side full and partial refunds from credit memos, and a clear log trail that matches the Moyasar dashboard.

How Magento 2 Moyasar Payment Gateway Compares

Criterion	ECOSIRE	Custom Build	Competitor
mada, Apple Pay and STC Pay through Moyasar at checkout	Included	Included	Partial support
Native Magento 2 gateway pattern (config.xml/di.xml, service contracts) — not a redirect hack	Included	Partial support	Partial support
Admin full and partial refunds from credit memos pushed to Moyasar	Included	Partial support	Partial support
Webhook validation plus cron reconciliation for reliable order states	Included	Partial support	Not included
Installed, tested and configured on your store by the provider	Included	Not included	Not included
Tailored to your theme, checkout customizations and Magento version	Included	Included	Not included
Post-launch support and upgrade-safe code ownership	Included	Partial support	Partial support

Frequently Asked Questions about Magento 2 Moyasar Payment Gateway

Is this an instant download from the Adobe Commerce Marketplace?

No. This is a build-to-order extension. ECOSIRE builds the module for your specific Magento 2 / Adobe Commerce store, installs it on your environment, and supports it after launch. You receive the full source code and a deployment runbook — there is no Marketplace download link.

How long until it is live on my store?

Typical delivery is about 1 to 2 weeks from the time we have your Moyasar account access (test and live keys) and access to a staging environment. We build, install on staging, run test transactions across mada, card, Apple Pay and STC Pay, then deploy to production after your sign-off. Complex themes, custom checkout flows or Apple Pay domain verification can extend this slightly.

What about ongoing support and updates?

The build includes a post-launch support window for fixes and configuration help. Because the module is cleanly scoped under app/code using Magento service contracts, it is upgrade-safe across Magento minor versions; if a future Magento or Moyasar API change requires updates, ECOSIRE can provide them under a support arrangement. You own the source code, so your own team can also maintain it.

Does it support mada, Apple Pay and STC Pay, and settle in SAR?

Yes. The single payment method handles mada, Visa/Mastercard, Apple Pay and STC Pay through Moyasar's embedded form, with settlement in SAR. Apple Pay requires domain verification with Apple, which we handle as part of installation.

Can staff refund orders, and are payments reliable if a callback is lost?

Yes. Full and partial refunds are issued directly from the Magento credit-memo screen and sent to Moyasar via API. Orders are placed only after the webhook is validated against your secret key, and a cron reconciliation job re-checks pending payments so order states stay in sync even if a browser callback is missed.

Will it work with Adobe Commerce as well as Magento Open Source?

Yes. The module targets standard Magento 2 payment service contracts, so it runs on both Magento Open Source and Adobe Commerce. We confirm compatibility with your exact version and any existing checkout customizations during the build.