hyper business solution Logohyper business solution Logohyper business solution
THE HBS Framework™
Some WorkWho We AreBlog
AmrakNewOnline Academy (LMS)New
Web & Digital Platforms
Search Visibility & Performance
Paid Media & User Acquisition
Direct Marketing & Retention
Brand & Online Presence
RankLab
  • Corporate WordPress Websites
  • Enterprise Software Development
  • API & Systems Integration
  • WordPress Development
  • Mobile App Development
  • Custom Web Development
  • Advanced Technical SEO
  • SEO Services
  • Search Engine Marketing (SEM)
  • Digital Media Buying
  • Email Marketing Automation
  • Corporate Branding & Identity
  • UI/UX & Product Design
  • Social Media Management
  • Logo Design
Contact

Cairo--:--

Have a project in mind?Let's make it real.

Start a projectContact page
Emailinfo@hbs-group.xyz
Phone+20 10 2179 1291
Office30 A, Asmaa Fahmy, Nasr City, Cairo, Egypt
hyper business solution Logohyper business solution Logohyper business solution

We build scalable digital platforms focused on performance, usability, and business growth.

Company

  • THE HBS Framework™
  • Some Work
  • Who We Are
  • Blog
  • Content Partner
  • Careers
  • Contact

Solutions

  • Amrak New
  • Online Academy (LMS) New
  • Web & Digital Platforms
  • Search Visibility & Performance
  • Paid Media & User Acquisition
  • Direct Marketing & Retention
  • Brand & Online Presence
  • View All Solutions →

All services

15 services

Web & Digital Platforms06

  • Corporate WordPress Websites
  • Enterprise Software Development
  • API & Systems Integration
  • WordPress Development
  • Mobile App Development
  • Custom Web Development

Search Visibility & Performance03

  • Advanced Technical SEO
  • SEO Services
  • Search Engine Marketing (SEM)

Paid Media & User Acquisition01

  • Digital Media Buying

Direct Marketing & Retention01

  • Email Marketing Automation

Brand & Online Presence04

  • Corporate Branding & Identity
  • UI/UX & Product Design
  • Social Media Management
  • Logo Design
HBS

© 2026 hyper business solution · All rights reserved.

llms.txt
Background
Decorative Arrow
Decorative Arrow
Decorative Arrow

Integrating a Payment Gateway With Your System in Egypt: Fawry, Paymob and InstaPay.

HomeBlogIntegrating a Payment Gateway With Your System in Egypt: Fawry, Paymob and InstaPay
Software & Business Systems
Back to Blogs

Table of Contents

  • Which payment methods does your company need in Egypt?
  • How do you choose the right payment gateway for your company?
  • What fees do you pay, and how do you read the structure?
  • Is a ready-made plugin enough, or do you need a custom integration?
  • How does a payment gateway integration work technically, from order to notification?
  • How do you handle settlement, refunds and reconciliation?
  • What are the common mistakes when integrating a payment gateway?
  • How does HBS approach payment gateway integration?

Share this post

Table of Contents

  • Which payment methods does your company need in Egypt?
  • How do you choose the right payment gateway for your company?
  • What fees do you pay, and how do you read the structure?
  • Is a ready-made plugin enough, or do you need a custom integration?
  • How does a payment gateway integration work technically, from order to notification?
  • How do you handle settlement, refunds and reconciliation?
  • What are the common mistakes when integrating a payment gateway?
  • How does HBS approach payment gateway integration?

Integrating a payment gateway with your system means that your system creates the payment request with the gateway, receives a verified notification of the result of every transaction, and then matches what reaches your bank account against orders and invoices. In Egypt, gateways such as Paymob and Fawry cover cards, mobile wallets and cash payment by reference number, and InstaPay can be accepted through some gateways by QR code or a request to pay. The real decision is not the gateway's name. It is the payment methods your customers use, the fees, the settlement period, how refunds work and how well the integration fits your accounting.

This guide is for companies and stores that sell products or services. We explain each payment method and what your system needs for it, how to read a fee structure, how the integration works technically from order to notification, and then settlement, refunds and reconciliation. If you sell training courses specifically, you will find the automatic enrolment details in our article on collecting course payments in Egypt.

Which payment methods does your company need in Egypt?

Each payment method follows a different path inside your system, and the most important difference is when you know the money has actually arrived:

Payment methodHow the customer paysWhat your system needs
Bank cardsEnters card details on the gateway's secure payment pageA success or decline result within seconds, and a clear path to refund to the same card
Mobile walletsConfirms the payment on their phone with their wallet numberWaiting for the customer's confirmation, then a notification of the result
Cash by reference numberGets a reference number and pays at a Fawry outletAn order "awaiting payment" for hours or days, an expiry for the number, and a notification when it is paid
InstaPayScans a QR code or approves a request to pay in their banking appA notification from the gateway when the request is approved, declined or expires
Instalments and pay laterChooses an instalment provider on the payment pageAvailable through some gateways depending on your account setup, with its own settlement terms

Payment by reference number deserves special attention. According to the FawryPay developer documentation, you can set an expiry for the reference number, after which the customer can no longer pay with it, and set a URL where your system is notified whenever the order's status changes. So your system has to know how to hold stock for an unpaid order, and when to release it.

How do you choose the right payment gateway for your company?

Compare gateways on these criteria before price, because the cheapest gateway can cost you more if it does not support the payment method your customers prefer:

  • The payment methods actually enabled for your account. Some methods are enabled depending on your type of business and account setup, so ask for a written list of what will be activated for you.
  • The full fee structure. The percentage and fixed amount per transaction, plus any setup, subscription or refund fees.
  • Settlement period. When the money reaches your bank account, and whether faster settlement is available and at what fee.
  • Refunds and disputes. Whether partial refunds are possible from the dashboard or through the API, and how cardholder disputes are handled.
  • Documentation quality and a test environment. Clear documentation of the APIs and notifications, and a test account where you can try every scenario before launch.
  • Ready plugins for your platform. If your store runs on a ready-made platform, make sure there is an official plugin the gateway supports and keeps updated.

You do not have to settle for a single gateway. Many companies use a main gateway for cards and wallets and add cash by reference number or InstaPay to match their customers' habits. What matters is that your system handles every gateway the same way when it records orders and reconciles them.

What fees do you pay, and how do you read the structure?

Fees differ between gateways and between accounts, so always rely on the official page and your contract. For example, as things stand (November 2026), Paymob's pricing page shows a standard rate of 2.75% plus EGP 3 per transaction with no monthly or subscription fees, weekly settlement to your bank account, and a note that rates are adjusted as your business grows. At that rate, an order worth EGP 1000 carries about EGP 30.5 in fees, and about EGP 969.5 reaches you.

Do not stop at the percentage. Ask about these items and get them in writing:

  • Refund fees. Is the original transaction fee returned on a refund, or is another fee deducted?
  • Fees per payment method. Does the percentage differ between cards, wallets, cash and InstaPay?
  • Minimums and fixed charges. Is there a monthly minimum, a setup fee or an annual fee?
  • Faster settlement. If it is available, at what extra fee?

Then calculate the fees on your real average order value, not on a generic example, because the fixed amount per transaction weighs far more on small orders than on large ones.

Is a ready-made plugin enough, or do you need a custom integration?

If your store runs on a ready-made platform and sells only by card and wallet, the gateway's official plugin is usually enough, as long as you test it well and keep up with its updates. You can review the differences between the platforms themselves in our comparison of Shopify, WooCommerce and a custom-built store.

A custom integration becomes necessary in specific cases: when every payment must reach your accounting system or ERP automatically, when you sell through more than one channel, such as a store, an app and branches, and want a single record of payments, when you need special logic such as deposits, staged payments or splitting an amount between several vendors, or when you want the e-invoice or e-receipt issued automatically after every successful transaction.

How does a payment gateway integration work technically, from order to notification?

Whatever the gateway, a sound integration goes through these steps:

  1. Create the order in your system first. With a unique number, a fixed amount and an "awaiting payment" status, before contacting the gateway.
  2. Request the payment from the gateway. Your server sends the order number and amount, and gets back a payment page link, a reference number or a QR code.
  3. Let the customer pay with the gateway. Card details are entered on the gateway's secure page, not in your system.
  4. Rely on the server notification, not the return page. Paymob's developer documentation separates a notification that reaches your server to update orders and records from a redirect that brings the customer back to your site to show the result. The first is the source of truth.
  5. Verify the notification's signature. Every gateway offers a way to confirm that a notification really came from it, such as an HMAC signature, so do not update any order before verifying it.
  6. Update the order only once. The same notification can arrive more than once, and stock must not be deducted twice or an invoice issued twice.
  7. Issue the invoice or receipt after payment is confirmed. Then record the gateway's transaction number next to the order number, ready for reconciliation.

How do you handle settlement, refunds and reconciliation?

Money does not reach your account order by order. It arrives in grouped settlement batches after fees and refunds are deducted. So your accounts team needs to link three numbers for every transaction: the order number in your system, the transaction number at the gateway, and the settlement batch number on the bank statement.

ItemWhere it comes fromWhat you match
Paid salesGateway notifications recorded in your systemThat every paid order has exactly one successful transaction at the gateway
FeesThe gateway's settlement reportThat the fees deducted match the percentage and fixed amount in your contract
RefundsThe refund log in your system and at the gatewayThat every return has one refund for the correct amount
Net settlementYour bank statementThat the amount transferred equals sales minus fees and refunds

The more automated this matching is, the fewer differences you discover at month end. Our article on invoices, reconciliation and e-invoicing explains how this matching is built and followed day to day.

What are the common mistakes when integrating a payment gateway?

  • Confirming the order from the return page. The customer may close the browser before returning, or reach the page without the payment completing.
  • Ignoring pending states. An unpaid reference number and an expired InstaPay request both need handling that releases the stock and informs the customer.
  • Gateway keys inside the code. Production keys belong in secure server settings, fully separate from test environment keys.
  • Recording the net instead of the gross. Record the full sale amount and the fees as a separate expense, or reconciliation and tax filings become harder.
  • Launching without testing the hard cases. Try declines, partial refunds, duplicate notifications and lost connections before your first real customer.

How does HBS approach payment gateway integration?

At HBS we start by mapping your systems and the data that has to move between them: the store or app, the gateway, accounting and e-invoicing. We then design the integration before writing code, test it in a preview environment against every scenario, and document what we deliver. Security is built into the design from the start: API keys stored securely, encrypted connections, input validation, rate limiting and an audit log for every integration.

One example from our work is Hala Nur, a multivendor marketplace app we built for a charitable organisation that helps artisans and small vendors sell their handmade products. The app includes payments integrated with payment gateways, order tracking, a dashboard for each vendor showing their sales and earnings reports, and an admin panel that tracks sales across the platform. In multivendor marketplaces, reconciliation matters even more, because every payment must be attributed to its vendor and their earnings calculated from it accurately.

Legal details and fees in this article reflect the situation in November 2026 and may change; check the official source before you decide.

If you want to connect a payment gateway to your store or system and be sure every pound is recorded correctly, from the first order until it reaches your account, tell us which payment methods your customers use and which systems you run. We will sit down with you in a free discovery session and tell you honestly what fits, and you can learn more about HBS payment gateway and API integration services.

About the author

Ahmed Hashim

Ahmed Hashim

CEO · Tech Lead

CEO of HBS Group and its tech lead. Ahmed drives HBS's software engineering, AI and digital transformation work for businesses across Egypt, the Gulf and North Africa, and leads product development on the group's SaaS platforms.

LinkedIn

Frequently Asked Questions

Which payment gateway is best for stores and companies in Egypt?

There is no single best gateway for everyone. Choose the gateway that supports the payment methods your customers actually use, then compare the fee structure, settlement period, ease of refunds and the quality of its technical documentation. Many companies start with one main gateway for cards and wallets, then add cash by reference number or InstaPay to match their customers' habits.

Can I accept InstaPay in my online store?

Yes, through payment gateways that support it. Some let the customer scan a QR code or approve a request to pay in their banking app, and the gateway then notifies your system of the result. Before you sign, check that the gateway supports refunds through InstaPay, and how it handles requests that expire without payment.

When does sales money reach my bank account?

Your contract with the gateway decides that. Some gateways settle weekly, and some offer faster settlement for an extra fee. The money usually arrives in grouped batches after fees and refunds are deducted, so ask for a detailed settlement report that links every batch to the transactions it contains, which makes reconciliation much easier.

Can the e-invoice or e-receipt be issued automatically after payment?

Yes, if your system is connected to both the Tax Authority's system and the gateway's notifications. When a verified success notification arrives, the system issues the invoice or receipt, submits it, and records the gateway's transaction number next to it. What matters is that this happens only once, even if the same notification arrives more than once.

What is the difference between a hosted payment page and paying inside my site?

With a hosted payment page, the customer goes to the gateway's page to enter card details, then returns to your site. It is simpler and lighter on security obligations, because card data never passes through your servers. An embedded checkout inside your own page gives a smoother experience, but it needs more care in implementation, testing and card security requirements.

Related services: API & Systems Integration

Ready to discuss API & Systems Integration?

Explore

Related Posts

Digital Transformation for Mid-Sized Companies in Egypt: Where to Start Without a Huge Project

Digital Transformation for Mid-Sized Companies in Egypt: Where to Start Without a Huge Project

A practical guide to digital transformation for mid-sized companies in Egypt: why big projects stall, how to start with one process, which process to pick first, and how to measure success before the next phase.

Nov 20, 2026

MVP for Your Startup: What to Build First and What It Costs

MVP for Your Startup: What to Build First and What It Costs

What should go into the first version of your product? A practical guide to scoping a startup MVP: the forms a first version can take, choosing the core path, what not to postpone, what drives cost, and an example from HBS work.

Nov 19, 2026

Building a SaaS Platform From Idea to Launch: Steps, Costs and Common Mistakes

Building a SaaS Platform From Idea to Launch: Steps, Costs and Common Mistakes

How do you take a SaaS platform from idea to launch? The eight steps, how to separate customer data, cost drivers, Saudi and Gulf market requirements and the most common mistakes, with a real HBS example.

Nov 18, 2026