Fawry Gateway for Magento 2

Características clave

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

Hecho a medida, listo para ti

Sin configuración por tu cuenta: una app funcional creada, instalada y con soporte de ECOSIRE.

Haces el pedido

Empieza con un precio único de desarrollo. Definimos el alcance contigo en el arranque.

Creamos e instalamos

ECOSIRE la crea, la configura y la instala en tu Magento 2.

En marcha + soporte

Sales en vivo en unas 2–4 semanas, con un periodo de soporte posterior al lanzamiento.

Sobre este producto

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.

lo que obtienes

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

¿Para quién es esto?

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.

Cómo se compara Fawry Gateway for Magento 2

Criterio	ECOSIRE	Construcción personalizada	Competidor
Native Fawry reference-code + Meeza acceptance in Magento checkout	Incluido	Apoyo parcial	Apoyo parcial
Built and version-matched to your exact Magento/Adobe Commerce release	Incluido	Incluido	No incluido
Webhook + cron polling fallback with idempotent confirmation	Incluido	Apoyo parcial	Apoyo parcial
Installed, sandbox-tested and supported by the builder	Incluido	Apoyo parcial	No incluido
GraphQL/REST exposure for headless or Hyvä storefronts	Incluido	Apoyo parcial	Apoyo parcial
Full source handover with no per-transaction lock-in	Incluido	Incluido	Apoyo parcial
Available as an instant self-serve download	No incluido	No incluido	Incluido

Preguntas frecuentes sobre Fawry Gateway for Magento 2

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

Because this is built-to-order, typical delivery is about 1–2 weeks 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.