Quick facts
- Price
- $199.00 USD
- magento_2 versions
- —
- Setup time
- 30 min
- License
- One-time perpetual
- Languages
- 11 languages
One-time Purchase
HyperPay Payment Gateway
A build-to-order Magento 2 / Adobe Commerce payment integration that lets Saudi and Gulf merchants accept mada, Visa, Mastercard, Apple Pay and STC Pay through HyperPay — with 3D Secure 2, tokenized recurring payments, and refund/void from the admin. Built, installed and supported by ECOSIRE.
$199.00USD
No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.
Key Features
mada domestic debit scheme support with its dedicated HyperPay entity ID, presented as a first-class Magento payment method for KSA shoppers
Visa and Mastercard card payments via HyperPay COPYandPAY widget and Server-to-Server API
Apple Pay integration with merchant validation and the Apple Pay JS session wired into Magento checkout
STC Pay wallet support for Saudi customers as a separately configurable payment method
3D Secure 2 (EMV 3DS) authentication with frictionless and challenge flows handled in the redirect/callback cycle
Tokenized card-on-file for recurring, subscription and one-click repeat purchases via HyperPay registration tokens
Admin refund, partial refund, void and capture actions implemented as Gateway Commands with ACL-protected access
Signed webhook controller plus a status-reconciliation cron that finalizes orders even when the customer drops the redirect
Per store view, currency and customer-group method availability, with test/live endpoint switching in Stores → Configuration
Encrypted credential storage (access token, entity IDs) and PCI-conscious flow that keeps raw PAN off your servers
Order, payment and transaction visibility through Magento REST and GraphQL for headless / PWA Studio storefronts
Detailed transaction logging and HyperPay result-code mapping to clear Magento order statuses for reconciliation
About this Product
Most Magento 2 stores in KSA and the Gulf lose checkout conversions because mada — the kingdom's mandated domestic debit scheme — and wallets like Apple Pay and STC Pay aren't first-class payment options. This extension closes that gap by integrating HyperPay's COPYandPAY and Server-to-Server APIs directly into Magento's payment flow.
Why Choose HyperPay Payment Gateway
mada domestic debit scheme support with its dedicated HyperPay entity ID, presented as a first-class Magento payment method for KSA shoppers
Visa and Mastercard card payments via HyperPay COPYandPAY widget and Server-to-Server API
Apple Pay integration with merchant validation and the Apple Pay JS session wired into Magento checkout
STC Pay wallet support for Saudi customers as a separately configurable payment method
3D Secure 2 (EMV 3DS) authentication with frictionless and challenge flows handled in the redirect/callback cycle
Tokenized card-on-file for recurring, subscription and one-click repeat purchases via HyperPay registration tokens
ECOSIRE builds this as a proper payment module under app/code/Ecosire/HyperPay, implementing Magento's payment service contracts and the Gateway Command/Builder/Validator pattern wired through di.xml. Brand-specific entity IDs (mada, VISA/MASTER, APPLEPAY, STC_PAY) are exposed as separate, independently configurable payment methods so you control availability per store view, currency and customer group. A signed webhook controller plus a status-reconciliation cron job keep Magento order state authoritative even when a browser drops mid-redirect.
The build covers 3D Secure 2 authentication, tokenized card-on-file for recurring and subscription billing, and full admin refund/void/capture actions backed by ACL resources and gateway commands. Configuration lives in Stores → Configuration with encrypted credential storage and per-mode (test/live) endpoints. We expose order and transaction data through Magento's REST and GraphQL layers where your headless or PWA storefront needs it.
This is honest build-to-order: it is not an instant Adobe Commerce Marketplace download. After purchase, ECOSIRE configures the module to your HyperPay merchant entities, installs it on your environment (Adobe Commerce or Open Source, 2.4.x), runs end-to-end test transactions in HyperPay's test mode, and hands over with documentation. You get a typical delivery lead time of 10–15 business days and ongoing support.
What you get
- Custom Magento 2 module `Ecosire_HyperPay` under app/code, packaged as a deployable Composer artifact
- di.xml gateway wiring (Command Pool, Request Builders, Response/Transfer Factories, Validators) following Magento payment service contracts
- Webhook controller for HyperPay notifications plus a cron job for transaction status reconciliation
- Admin system configuration section with encrypted credentials, per-method enable/disable, and test/live mode toggle
- End-to-end test transactions executed in HyperPay test mode (mada, card, Apple Pay, STC Pay) before handover
- Installation on your Adobe Commerce or Open Source 2.4.x environment plus an admin + developer handover guide
Who this is for
KSA Magento store owner
Runs an Adobe Commerce or Open Source store in Saudi Arabia and is losing checkout completions because mada and local wallets like STC Pay aren't offered. Needs a compliant, conversion-friendly HyperPay checkout.
Gulf-region eCommerce manager
Operates multi-store-view sites across KSA, UAE and the wider GCC and wants Visa, Mastercard, mada and Apple Pay enabled per store view and currency without juggling brittle one-off scripts.
Magento developer / systems integrator
Owns the technical environment and wants a clean module under app/code that follows the Gateway Command pattern, di.xml wiring, webhooks and cron — not core hacks — so it survives 2.4.x upgrades.
Installation overview
Download from ECOSIRE
Buy the license on ecosire.com and download the HyperPay Payment Gateway module ZIP from your account dashboard.
Upload to Odoo
Extract the ZIP into your Odoo custom addons folder on the server (or upload via Apps > Install from file on Odoo.sh / runbot).
Install the module
Activate Developer Mode, open Apps, click Update Apps List, search for HyperPay Payment Gateway, and press Install.
Configure settings
Open the new menu, paste your ECOSIRE license key, connect any external credentials (Shopify, Amazon, Stripe, etc.), and save.
Verify & go live
Run the built-in connection test, sync your first 10 records, and schedule the recurring cron. Contact support if anything fails.
How HyperPay Payment Gateway Compares
| Criterion | ECOSIRE | Custom Build | Competitor | Odoo Native |
|---|---|---|---|---|
| mada + Apple Pay + STC Pay as first-class Magento payment methods | ||||
| Built with Magento Gateway Command pattern + di.xml service contracts (upgrade-safe) | ||||
| 3D Secure 2 with frictionless + challenge flow handling | ||||
| Tokenized recurring / subscription card-on-file | ||||
| Admin refund / void / capture as ACL-protected gateway commands | ||||
| Signed webhook + cron status reconciliation for dropped redirects | ||||
| Installed, configured to your entity IDs, and test-validated for you | ||||
| REST + GraphQL exposure for headless / PWA storefronts |
Frequently Asked Questions about HyperPay Payment Gateway
+How long does delivery take, since this is build-to-order?
Typical lead time is 10–15 business days from when we receive your HyperPay merchant credentials (access token and entity IDs) and environment access. This covers building/configuring the `Ecosire_HyperPay` module, installing it on your Adobe Commerce or Open Source 2.4.x environment, and running end-to-end test transactions in HyperPay test mode before go-live. Complex multi-store-view or headless/PWA setups may add a few days; we confirm a firm date after a short scoping call.
+Is this an instant download from the Adobe Commerce Marketplace?
No. This is honestly build-to-order — there is no instant Marketplace download. ECOSIRE builds the module, configures it to your specific HyperPay entity IDs (mada, card, Apple Pay, STC Pay), installs it on your server, and validates it with real test transactions. You receive a deployable Composer artifact and handover documentation, not a self-service zip from a storefront listing.
+What ongoing support and updates are included?
Every build includes a support window for defect fixes and configuration help after handover. Because the module follows Magento's payment service contracts and lives under app/code (no core edits), it is designed to survive routine 2.4.x patch upgrades. We offer optional ongoing maintenance to track HyperPay API changes, new payment brands, and Magento/Adobe Commerce version bumps — scoped per environment.
+Will it work with my headless / PWA Studio storefront?
Yes. The integration exposes order, payment and transaction data through Magento's REST and GraphQL layers, and the COPYandPAY/Server-to-Server flows can be driven from a decoupled frontend. If you're on PWA Studio or a custom headless stack, we scope the GraphQL and callback wiring as part of the build so the redirect, 3DS challenge and webhook reconciliation all complete correctly.
+Does it support recurring and subscription payments?
Yes. We implement HyperPay registration tokens so cards can be tokenized for card-on-file, one-click repeat purchases, and recurring/subscription billing. Raw card data stays with HyperPay's PCI-compliant infrastructure; Magento stores only the token reference, keeping sensitive PAN data off your servers.
Why Customers Trust ECOSIRE
SOC 2 Aligned
GDPR Compliant
Secure Stripe Payment
30-Day Money Back
Lifetime Updates
LGPL-3.0 License
Related Modules
Request a quote
HyperPay Payment Gateway
A build-to-order Magento 2 / Adobe Commerce payment integration that lets Saudi and Gulf merchants accept mada, Visa, Mastercard, Apple Pay and STC Pay through HyperPay — with 3D Secure 2, tokenized recurring payments, and refund/void from the admin. Built, installed and supported by ECOSIRE.
- mada domestic debit scheme support with its dedicated HyperPay entity ID, presented as a first-class Magento payment method for KSA shoppers
- Visa and Mastercard card payments via HyperPay COPYandPAY widget and Server-to-Server API
- Apple Pay integration with merchant validation and the Apple Pay JS session wired into Magento checkout
- STC Pay wallet support for Saudi customers as a separately configurable payment method