Skip to main content
Fawry Gateway for Magento 2 — A build-to-order Fawry payment integration for Magento 2 and Adobe Commerce — letting Egyptian  — 1/1Illustrative preview

A build-to-order Fawry payment integration for Magento 2 and Adobe Commerce

— letting Egyptian shoppers pay with a Fawry reference code at any outlet, or by card and Meeza, with reliable webhook-driven order confirmation. Designed, installed and supported by ECOSIRE.

What is Fawry Gateway for Magento 2?

A build-to-order Fawry payment integration for Magento 2 and Adobe Commerce — letting Egyptian shoppers pay with a Fawry reference code at any outlet, or by card and Meeza, with reliable webhook-driven order confirmation. Designed, installed and supported by ECOSIRE. Built to order by ECOSIRE for Magento 2 / Adobe Commerce (build-to-order) — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Fawry reference-code cash payments — generates a pay-at-outlet code shown at checkout and emailed to the customer, with configurable expiry
Card and Meeza acceptance through Fawry's hosted/charge flow, including local Meeza debit cards
Optional installment plans surfaced at checkout for eligible card BINs and amounts
Order placed in a pending-until-paid state with native Magento order status mapping (pending → processing on confirmation)
Webhook endpoint with HMAC signature verification to confirm payment in real time, plus a cron-based status polling fallback for missed callbacks
Built as a real module under app/code implementing PaymentMethodInterface and a di.xml gateway command pool (authorize/capture/void)
Admin configuration under Stores → Configuration with ACL resource control, sandbox/production toggle and encrypted credential storage
Automatic invoice generation on confirmed payment, with refund handling wired to Fawry's refund API where supported
GraphQL and REST checkout support so the method works on headless PWA / Hyvä storefronts as well as native Luma
Full payment request/response and callback logging to var/log for auditing and dispute resolution
Multi-store and multi-currency aware configuration (EGP primary), with per-website credential scopes
Idempotent callback handling so duplicate Fawry notifications never double-confirm or double-invoice an order

Built to order, done for you

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

  1. 1

    You order

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

  2. 2

    We build & install

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

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

About this Product

Fawry is Egypt's dominant payment aggregator, and many shoppers still prefer to complete an online order by paying cash at a nearby Fawry outlet or kiosk. This extension brings that experience into Magento 2 and Adobe Commerce as a first-class payment method, alongside card and Meeza acceptance and optional installment plans.

ECOSIRE builds this as a proper Magento module under app/code/Ecosire/Fawry, implementing the PaymentMethodInterface service contract and wiring the gateway command pool (authorize, capture, void) through di.xml rather than bolting logic onto controllers. When a customer selects Fawry at checkout, the module calls Fawry's charge API, stores the returned reference code on the order, and places the order in a clear pending state. The storefront then shows the reference number and outlet instructions, and a webhook endpoint (plus a cron-based polling fallback) confirms payment and moves the order to processing — invoicing automatically if configured.

This is NOT an instant Adobe Commerce Marketplace download. It is engineered to your exact Magento version (Open Source or Adobe Commerce), your checkout (native Luma or a headless PWA/Hyvä front end), and your Fawry merchant account, then installed and tested on your environment by our team.

You get admin configuration with ACL-protected settings, sandbox and production credential modes, signature verification on every callback, full request/response logging, and clean GraphQL/REST exposure so the method works on API-driven checkouts. We hand over source code, a deployment runbook, and a support window — no black boxes, no per-transaction lock-in to us.

What you get

  • Complete Magento 2 module source (Ecosire_Fawry) installed under app/code on your environment, version-matched to your Open Source or Adobe Commerce release
  • Admin configuration panel with ACL roles, sandbox/production modes and encrypted Fawry credential fields
  • Webhook controller plus cron job for payment confirmation and polling fallback, configured for your domain
  • Sandbox end-to-end test pass (reference-code cash, card, Meeza, and one installment scenario) with evidence
  • Deployment runbook covering setup:upgrade, di:compile, static-content:deploy and cache flush steps for your pipeline
  • A defined post-launch support window for bug fixes plus Magento/Fawry-API compatibility guidance

Who this is for

Egyptian online retailer

A Magento 2 merchant in Egypt whose customers expect to reserve an order online and pay cash at a Fawry outlet, and who is losing card-averse buyers without a reference-code option.

Cross-border brand entering Egypt

An international Adobe Commerce store launching an EGP storefront that needs local Meeza and Fawry acceptance to be taken seriously by Egyptian shoppers.

Headless/PWA store owner

A team running a Hyvä or PWA Studio front end that needs Fawry exposed cleanly over GraphQL/REST, not hard-coded into a Luma checkout template.

How Fawry Gateway for Magento 2 Compares

CriterionECOSIRECustom BuildCompetitorMagento 2 Native
Native Fawry reference-code + Meeza acceptance in Magento checkoutIncludedPartial supportPartial supportNot included
Built and version-matched to your exact Magento/Adobe Commerce releaseIncludedIncludedNot includedPartial support
Webhook + cron polling fallback with idempotent confirmationIncludedPartial supportPartial supportNot included
Installed, sandbox-tested and supported by the builderIncludedPartial supportNot includedNot included
GraphQL/REST exposure for headless or Hyvä storefrontsIncludedPartial supportPartial supportPartial support
Full source handover with no per-transaction lock-inIncludedIncludedPartial supportIncluded
Available as an instant self-serve downloadNot includedNot includedIncludedIncluded

Frequently Asked Questions about Fawry Gateway

How long until the Fawry gateway is live on my store?

Because this is built-to-order, typical delivery is about one working week from receiving your Magento access and Fawry sandbox credentials. That window covers version-matching the module to your store, wiring it to your checkout (Luma, Hyvä or headless), a full sandbox test pass, and production install. Complex headless or multi-website setups may add a few days; we confirm a firm date after a short scoping call.

What happens with support and updates after launch?

Every build includes a defined post-launch support window for bug fixes. We also track Magento minor/security releases and Fawry API changes, and advise on compatibility. After the included window you can engage us for an ongoing maintenance retainer or a one-off upgrade — and because we hand over full source code, your in-house team can also maintain it.

Does this work on Adobe Commerce as well as Magento Open Source?

Yes. The module targets the shared Magento 2 framework, so it runs on both Adobe Commerce and Magento Open Source. We build against your specific version and account for Adobe Commerce features (such as B2B or staging) where relevant during scoping.

Will it work with my headless or Hyvä storefront?

Yes. The payment method is exposed through Magento's GraphQL and REST APIs, so it integrates with PWA Studio, a custom headless front end, or Hyvä. We confirm your front-end stack during scoping and deliver the storefront integration accordingly rather than assuming native Luma.

How does an order get confirmed after the customer pays at a Fawry outlet?

When the order is placed it sits in a pending state with the reference code stored. Fawry sends a webhook to a signature-verified endpoint the moment payment is collected, which moves the order to processing and generates the invoice. As a safety net, a cron job polls Fawry's status API for any missed callbacks, and callback handling is idempotent so duplicate notifications never double-process an order.

Do I pay ECOSIRE per transaction?

No. This is a one-time build fee. Transaction fees are strictly between you and Fawry under your own merchant agreement — we never sit in the money flow or take a cut of your sales.

Request a quote

Fawry Gateway

A build-to-order Fawry payment integration for Magento 2 and Adobe Commerce — letting Egyptian shoppers pay with a Fawry reference code at any outlet, or by card and Meeza, with reliable webhook-driven order confirmation. Designed, installed and supported by ECOSIRE.

  • Fawry reference-code cash payments — generates a pay-at-outlet code shown at checkout and emailed to the customer, with configurable expiry
  • Card and Meeza acceptance through Fawry's hosted/charge flow, including local Meeza debit cards
  • Optional installment plans surfaced at checkout for eligible card BINs and amounts
  • Order placed in a pending-until-paid state with native Magento order status mapping (pending → processing on confirmation)

Request a Quotation

Tell us about your Fawry Gateway requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.