Magento 2 Tap Payments Gateway

核心功能

Unified GCC payment method exposing KNET, mada, Benefit, international cards and Apple Pay in a single Magento checkout selection

Tap hosted redirect flow and embedded card form (Tap web SDK / card-sdk) rendered as a Magento UI checkout component for in-page entry

Saved cards and tokenization via the Tap Customer/Token APIs so returning shoppers pay without re-entering card details (PCI scope minimized — card data never touches your server)

Apple Pay through Tap with domain verification and the Apple Pay JS session handled by the module

Full payment lifecycle mapped to Magento gateway commands (authorize, capture, sale, void, refund) via CommandPool and di.xml

Full and partial refunds and captures issued directly from Magento admin Credit Memos and Invoices, synced to Tap

Signed webhook controller that verifies Tap callbacks, updates order state through OrderRepositoryInterface service contracts, and is idempotent against retries

Encrypted API credentials in system.xml / core_config_data with sandbox and live toggles, plus admin ACL resources from acl.xml

Multi-store, multi-website and multi-currency aware (KWD, SAR, AED, BHD) with per-store-view enable/disable and method title

Configurable payment action (authorize-only vs authorize+capture), min/max order totals and allowed-country / specific-currency rules

Order status mapping (pending, processing, payment_review) and automatic invoice generation on successful capture

Structured debug logging to var/log plus a payment transactions audit trail viewable per order

Works on Magento Open Source and Adobe Commerce; clean upgrade-safe module under app/code with no core hacks

Sandbox-first delivery with a documented test plan covering KNET test cards, mada, Benefit and Apple Pay flows

按需定制，全程代劳

无需自行搭建——由 ECOSIRE 构建、安装并提供支持的可用应用。

您下单

以一次性构建价格开始。我们在启动时与您共同确定范围。

我们构建与安装

ECOSIRE 在您的 Magento 2 上构建、配置并安装。

上线 + 支持

约 2–4 周内上线，并提供上线后的支持期。

关于此产品

This is a build-to-order Magento 2 payment integration for Tap Payments, engineered and installed by ECOSIRE on your own Magento Open Source or Adobe Commerce store. It is not an instant Marketplace download — we build the module against your store version, theme and checkout, then hand over a clean, upgrade-safe codebase under app/code/Ecosire/TapPayments.

The module is built on Magento's payment method facade and gateway command pool (Magento\Payment\Model\Method\Adapter, CommandPoolInterface, ValidatorPoolInterface), wired through di.xml so authorize, capture, refund and void map to discrete gateway commands. Configuration lives in system.xml with encrypted credentials in core_config_data, and all admin actions are gated by ACL resources in acl.xml.

Shoppers get a unified GCC checkout: KNET, mada, Benefit, international cards and Apple Pay, using either Tap's hosted redirect or the embedded card form (Tap's card-sdk / web SDK) rendered as a Magento UI checkout component. Saved cards and tokenization let returning customers pay in one tap. Webhooks are received by a custom controller that validates Tap signatures and updates order state via service contracts and the OrderRepositoryInterface, with idempotency to survive retries.

Operationally, your team issues full and partial refunds and captures directly from the admin (Credit Memo / Invoice), with every call logged. We deliver REST/webhook handling, Magento 2 multi-store and multi-currency support (KWD, SAR, AED, BHD), debug logging, and a sandbox-first rollout. Because we build it to order, the module fits your Magento version, your one-page or multi-step checkout, and your reconciliation needs — and ECOSIRE supports it after go-live.

你得到什么

A custom Magento 2 module (Ecosire_TapPayments) delivered as source under app/code, installed on your store by ECOSIRE

di.xml / system.xml / acl.xml / webapi/webhook wiring configured for your Magento version and theme

Sandbox configuration and a documented end-to-end test plan (KNET, mada, Benefit, cards, Apple Pay, refunds)

Production go-live: live Tap credentials wired, Apple Pay domain verified, webhooks registered and verified

Admin runbook covering refunds, captures, reconciliation and the debug/log locations

Post-launch support window with bug fixes and Magento/Tap compatibility assistance

这是给谁的

Kuwait & Bahrain ecommerce merchant

A Magento Open Source store in Kuwait or Bahrain that must accept KNET and Benefit (the dominant local debit rails) alongside cards, and wants a single checkout option rather than several disconnected plugins.

KSA / UAE Adobe Commerce retailer

A multi-store Adobe Commerce merchant across Saudi Arabia and the UAE needing mada, Apple Pay and multi-currency (SAR, AED) with admin-side refunds and reconciliation that survives platform upgrades.

Agency or in-house Magento lead

A technical lead who wants a clean, ACL-gated, upgrade-safe gateway module built to Magento standards (service contracts, gateway commands, no core edits) that their team can maintain and audit.

Magento 2 Tap Payments Gateway 如何比较

标准	伊科西尔	定制建造	竞争对手	Magento 2 原生
KNET, mada, Benefit and Apple Pay in one unified checkout method	包含	部分支持	部分支持	不包括在内
Built and installed against your exact Magento version, theme and checkout	包含	包含	不包括在内	不包括在内
Saved cards / tokenization with minimal PCI scope	包含	部分支持	部分支持	不包括在内
Full and partial refunds and captures from Magento admin	包含	部分支持	包含	不包括在内
Clean upgrade-safe module (service contracts, gateway commands, no core hacks)	包含	部分支持	部分支持	不包括在内
Vendor support and post-launch compatibility fixes for your install	包含	不包括在内	部分支持	不包括在内
Instant self-service download with no build wait	不包括在内	不包括在内	包含	包含

关于Magento 2 Tap Payments Gateway的常见问题

How long until the Tap Payments gateway is live on my store?

This is build-to-order, so we install on your Magento environment after purchase rather than shipping an instant download. Typical delivery is about 1 to 2 weeks: a few days to build and wire the module against your Magento version and theme, a sandbox round where you test KNET, mada, Benefit, cards and Apple Pay, then production go-live once your live Tap credentials and Apple Pay domain verification are in place. Timeline depends on your store's customizations and how quickly Tap activates your live account.

What ongoing support and updates do I get after launch?

Every build includes a post-launch support window for bug fixes and for compatibility issues against Magento and Tap API changes. Because the module is delivered as clean source under app/code with no core hacks, it survives standard Magento upgrades; if a major Magento or Tap SDK change requires adjustment, ECOSIRE handles it. We also provide an admin runbook so your team can manage refunds, captures and reconciliation independently, and you can engage us for extended maintenance beyond the included window.

Does this work on both Magento Open Source and Adobe Commerce?

Yes. The module is built on standard Magento payment APIs (the payment method adapter, gateway command pool, service contracts and UI checkout components), which are shared between Magento Open Source and Adobe Commerce. We build against your specific version (typically 2.4.x) and confirm compatibility with your checkout, whether default multi-step, one-page, or a third-party checkout.

How are refunds and saved cards handled?

Refunds (full and partial) and captures are issued directly from the Magento admin via Credit Memos and Invoices, which call the Tap API and update the order automatically. Saved cards use Tap tokenization: the card is stored as a token against the Tap customer, so returning shoppers can pay in one tap. Raw card data never touches your server, which keeps your PCI scope minimal.

Will it support KNET, mada, Benefit and Apple Pay in one checkout?

Yes. The module exposes a single Tap Payments method in checkout that routes to KNET, mada, Benefit, international cards or Apple Pay depending on what the shopper selects and what your Tap account is enabled for. You can use Tap's hosted redirect, the embedded in-page card form, or both. Method visibility, allowed currencies and per-store-view settings are configurable in the admin.