CartModules: Tap Payments Gateway
Accept online payments from customers across the GCC region and beyond using Tap Payments — the leading payment gateway for the Middle East.
Supported Countries
- UAE (United Arab Emirates)
- Saudi Arabia
- Kuwait
- Bahrain
- Oman
- Qatar
Supported Payment Methods
- KNET — Kuwait's national debit network
- mada — Saudi Arabia's national payment network
- Benefit — Bahrain's debit card network
- Apple Pay — Tap-powered Apple Pay for supported devices
- Visa / Mastercard / AMEX — International credit and debit cards
Supported Currencies
AED, SAR, KWD, BHD, OMR, QAR, USD, EUR, GBP
Key Features
- Dual Checkout Modes — Choose between redirect (hosted page) or inline (embedded popup) checkout
- On-Site Payment — Inline mode keeps customers on your store during payment
- Apple Pay — Accept Apple Pay payments via inline checkout
- Google Pay — Accept Google Pay payments via inline checkout
- Secure hosted payment page — customers pay on Tap's PCI DSS Level 1 compliant page (SAQ A)
- Server-to-server webhook notifications for reliable order status updates
- Configurable order status mapping for captured, failed, and initiated payments
- Idempotent callback processing — prevents duplicate order updates
- Charge ID verification — validates the returning charge matches the original
- Sandbox/live toggle via secret key (sk_test_* / sk_live_*)
- Structured payment logging with sensitive data stripped
- Compatible with CS-Cart and Multi-Vendor (all editions)
Checkout Modes
- Redirect (Default) — Customer is redirected to Tap's secure hosted payment page
- Inline (Embedded Popup) — Tap's goSell.js opens a popup directly on your checkout page. Customer pays without leaving your store.
How It Works
- Customer completes checkout and selects Tap Payments
- A charge is created via the Tap API and the customer is redirected to the Tap hosted payment page (or inline popup appears)
- Customer enters payment details on Tap's secure page (KNET, mada, Benefit, card, or Apple Pay)
- After payment, the customer is redirected back to your store
- The addon verifies the charge status via the Tap API and updates the order accordingly
- A webhook notification provides a server-side backup to ensure no payment is missed
Requirements
- CS-Cart or Multi-Vendor 4.x
- A Tap Payments merchant account (tap.company)
- Your Tap secret API key (sk_test_* for sandbox, sk_live_* for production)
- SSL certificate on your store (HTTPS)
Installation
- Upload the addon ZIP via the CS-Cart admin panel (Add-ons → Upload & install)
- Go to Administration → Payment methods → Add payment method
- Select "Tap Payments Gateway" as the processor
- Enter your Tap secret key and configure the currency and status mappings
- Save and activate
