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

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

受注生産、すべておまかせ

自分での設定は不要 — ECOSIRE が構築・インストール・サポートする実働アプリです。

ご注文

一回限りの構築料金から始めます。キックオフで一緒に範囲を決めます。

構築とインストール

ECOSIRE がお客様の Magento 2 上で構築・設定・インストールします。

本番稼働 + サポート

約2〜4週間で稼働し、リリース後のサポート期間が付きます。

この製品について

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.

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.

得られるもの

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

これは誰のためのものですか

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.

HyperPay Payment Gateway の比較方法

基準	エコシエール	カスタムビルド	競合他社	Magento 2 標準機能
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	付属	部分的なサポート	部分的なサポート	部分的なサポート

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.