Skip to main content
Fawry Gateway for ERPNext — A build-to-order Fawry payment integration for ERPNext that lets Egyptian merchants accept cards, — 1/1Illustrative preview

A build-to-order Fawry payment integration for ERPNext that lets Egyptian merchants accept cards,

mobile wallets, valU installments, and reference-code cash payments at 200k+ outlets — with automatic webhook reconciliation into your Sales Invoices.

ECOSIRE builds, installs, and supports it on your bench.

What is Fawry Gateway for ERPNext?

A build-to-order Fawry payment integration for ERPNext that lets Egyptian merchants accept cards, mobile wallets, valU installments, and reference-code cash payments at 200k+ outlets — with automatic webhook reconciliation into your Sales Invoices. ECOSIRE builds, installs, and supports it on your bench. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Native Frappe app (`erpnext_fawry`) with dedicated `Fawry Settings` and `Fawry Payment Request` DoctTypes rather than a brittle custom-field-only hack
Card and Meeza acceptance plus Egyptian mobile-wallet payments through Fawry's charge API
Reference-code cash collection generating codes payable at 200k+ Fawry outlets across Egypt, linked to the source Sales Order or Sales Invoice
Fawry valU installment plans exposed as a selectable payment option at checkout
Both hosted Fawry payment-page redirect flow and direct API-driven charge flow, chosen per your checkout surface
Signature-verified webhook endpoint (whitelisted method) that validates Fawry's HMAC signature before trusting any callback field
`hooks.py` doc-event handler that creates and allocates the ERPNext Payment Entry against the invoice inside a single atomic transaction
Scheduler event on `scheduler_events` that polls Fawry's status API to reconcile expired or missed-webhook references automatically
Encrypted storage of merchant code and secure key via Frappe's password fieldtype, with a staging/production environment toggle
Client Scripts rendering the live reference code and a payment-status badge directly on the ERPNext form
Refund and partial-refund actions wired to Fawry's refund API with audit trail on the Payment Request
Dedicated `Fawry Manager` role profile and DocType permissions restricting credential access, refunds, and settings
Idempotent callback handling keyed on Fawry reference number so retried webhooks never double-post a Payment Entry
Structured error logging via Frappe's `Error Log` for every failed charge, callback, or signature mismatch, plus optional email alerts
Built and tested for Frappe/ERPNext v15 and v16, exposed through whitelisted methods on the Frappe REST API

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 ERPNext.

  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.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

Egyptian merchants running ERPNext hit a wall the moment they try to collect money the way their customers actually pay. A huge share of the market still pays in cash, and the rest expect Meeza cards, mobile wallets, or valU installments — none of which ERPNext supports natively. Out of the box ERPNext gives you manual Payment Entries and a couple of generic gateways with no Egyptian coverage, so finance teams end up reconciling Fawry settlements by hand against bank statements, chasing reference codes in spreadsheets, and marking invoices paid days after the customer actually paid at a kiosk. That gap is where cash leaks, disputes start, and month-end close drags.

ECOSIRE builds a proper Frappe app — erpnext_fawry — that wires Fawry directly into your ERPNext payment flow rather than bolting on a fragile script. The app ships new DocTypes for Fawry Settings (encrypted merchant code, secure key, and environment toggle for Fawry's staging vs. production endpoints) and Fawry Payment Request, which stores the reference number, charge amount, expiry, and lifecycle status for every transaction. When a customer chooses Fawry at checkout — whether through the hosted Fawry payment page or the API-driven flow — the app calls Fawry's charge API from a whitelisted server method, generates the reference code the customer takes to any of the 200k+ collection outlets, and links it back to the originating Sales Order or Sales Invoice via a custom field.

Reconciliation is the part we take seriously. Fawry's webhook posts to a whitelisted, signature-verified endpoint that validates the HMAC signature before it trusts a single field, then a hooks.py doc-event handler creates the matching Payment Entry, allocates it against the invoice, and flips the Fawry Payment Request to Paid — all inside one database transaction so a half-processed callback can never leave your books inconsistent. A scheduler event runs on the Frappe scheduler_events hook to poll Fawry's status API for any reference that expired or never fired a webhook, closing the loop on stale kiosk payments automatically. Client Scripts surface the reference code and a live status badge right on the ERPNext form, and role-based permissions plus a dedicated Fawry Manager role profile keep the merchant credentials and refund actions locked to the right people.

Because this is build-to-order, nothing is a one-size download. We start with a scoping call to confirm exactly which rails you need — Meeza and card acceptance, valU installment plans, cash reference codes, or all of them — plus your ERPNext version (we support Frappe/ERPNext v15 and v16), your checkout surface, and any custom invoicing rules. We then build against your requirements, validate on a staging bench, and hand over the working app.

Typical delivery is one working week from confirmed scope. You get the full source code for your version, installation and configuration on your bench, technical documentation, a user guide and training session, a post-go-live support window, and the git repository so your team owns what we build. No instant download, no fabricated benchmarks — just a gateway that fits how you actually run ERPNext.

What you get

  • Installable source code of the `erpnext_fawry` app built for your exact Frappe/ERPNext version (v15 or v16)
  • Installation and configuration on your bench, including `Fawry Settings`, custom fields, role profile, and webhook endpoint setup
  • Technical documentation covering DocTypes, hooks, whitelisted methods, and the reconciliation flow
  • End-user guide plus a live training session for your finance and operations team
  • UAT on a staging bench with sandbox Fawry credentials, sign-off checklist, and a documented rollback plan
  • Post-go-live support window for bug fixes and configuration adjustments
  • Handover of the private git repository so your team fully owns the code
  • Configuration of Fawry production credentials and a go-live cutover checklist

Who this is for

Egyptian retail & e-commerce merchant

Runs an ERPNext-backed store and needs to capture both card/wallet payers and the large share of customers who still pay cash at Fawry kiosks — without finance manually reconciling every reference code.

Finance controller closing the books

Wants Fawry settlements to land as allocated Payment Entries against the right Sales Invoice automatically, with an audit trail and no more spreadsheet matching against bank statements at month-end.

ERPNext implementation partner or in-house developer

Needs a clean, version-matched Frappe app with proper DocTypes, hooks, and whitelisted methods they can read, extend, and maintain — not an undocumented pile of server scripts.

Subscription or installment-led business

Sells higher-ticket goods or services and wants to offer Fawry valU installment plans at checkout while keeping billing, invoicing, and reconciliation inside ERPNext.

How Fawry Gateway for ERPNext Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
Egyptian payment coverageCards, Meeza, wallets, valU installments, and cash at 200k+ outletsWhatever you scope and build in-houseOften card-only or a single rail, if it exists at allNo Fawry or Egyptian rails out of the box
Cash reconciliationSignature-verified webhook auto-creates and allocates Payment EntryYou design the callback and matching logic yourselfBasic callback; manual matching commonManual Payment Entry against bank statement
ERPNext version fitBuilt and tested for your exact v15 or v16 benchDepends on your team's depthGeneric build; may lag your versionN/A — no gateway to fit
ArchitectureProper Frappe app with DocTypes, hooks, whitelisted methods, role profileVaries; risk of server-script sprawlUsually a packaged app, quality variesNo dedicated payment DocTypes for Fawry
Missed-callback handlingScheduler polls Fawry status API to close stale referencesOnly if you build a pollerRarely includedNone
Ownership & sourceFull source plus git repo handoverYou own it but carry all build costOften closed or license-lockedCore code, no Fawry logic
Time to liveone working week from confirmed scopeMonths of design, build, and testingFast install, slow to fit your flowImmediate but incomplete
SupportPost-go-live window plus optional extended supportYour team's responsibilityCommunity or paid tier, variableGeneral ERPNext support only

Frequently Asked Questions about Fawry Gateway

Is this a ready-made app I can download and install today?

No. Fawry Gateway for ERPNext is build-to-order. ECOSIRE builds the app against your confirmed scope and ERPNext version, then installs it on your bench. It is not an instant Frappe Cloud Marketplace download — there is no fabricated 'one-click' claim here.

How long does delivery take?

Typical delivery is one working week from confirmed scope. The exact timeline depends on which payment rails you need (cards/Meeza, wallets, valU installments, cash reference codes), your checkout surface, and any custom invoicing rules. We lock the timeline during the scoping call before any build starts.

Which ERPNext versions are supported?

We build and test for Frappe/ERPNext v15 and v16. We confirm your exact version during scoping and build the app to match, so DocTypes, hooks, and API calls are compatible with your specific release rather than a generic lowest-common-denominator build.

How are cash payments at Fawry outlets reconciled back into ERPNext?

When a customer pays with a reference code at any of the 200k+ Fawry outlets, Fawry posts a signature-verified webhook to a whitelisted endpoint. A `hooks.py` doc-event handler then creates a Payment Entry, allocates it against the linked Sales Invoice, and marks the `Fawry Payment Request` as Paid — atomically. A scheduler job also polls Fawry's status API to catch any missed or expired references.

What about support and updates after go-live?

Every engagement includes a post-go-live support window for bug fixes and configuration adjustments. Because you receive the full source and the git repository, your team can maintain the app independently, and ECOSIRE can provide extended support or version upgrades (for example a future ERPNext major release) as a follow-on engagement.

Do I need my own Fawry merchant account?

Yes. You provide your Fawry merchant code and secure key; we store them encrypted in `Fawry Settings` using Frappe's password fieldtype. We can build and test against Fawry's sandbox credentials on staging first, then cut over to your production credentials at go-live.

Can it handle refunds and installment plans?

Yes. Refunds and partial refunds are wired to Fawry's refund API with an audit trail on the Payment Request, gated behind a dedicated `Fawry Manager` role. Fawry valU installment plans can be exposed as a selectable option at checkout if that rail is in your confirmed scope.

Request a quote

Fawry Gateway

A build-to-order Fawry payment integration for ERPNext that lets Egyptian merchants accept cards, mobile wallets, valU installments, and reference-code cash payments at 200k+ outlets — with automatic webhook reconciliation into your Sales Invoices. ECOSIRE builds, installs, and supports it on your bench.

  • Native Frappe app (`erpnext_fawry`) with dedicated `Fawry Settings` and `Fawry Payment Request` DoctTypes rather than a brittle custom-field-only hack
  • Card and Meeza acceptance plus Egyptian mobile-wallet payments through Fawry's charge API
  • Reference-code cash collection generating codes payable at 200k+ Fawry outlets across Egypt, linked to the source Sales Order or Sales Invoice
  • Fawry valU installment plans exposed as a selectable payment option at checkout

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.