CartModules: SumUp Payment Gateway
Accept Card Payments via SumUp in Your CS-Cart Store
Integrate SumUp — one of Europe's leading payment platforms — directly into your CS-Cart or Multi-Vendor store. Customers pay with their credit or debit card through SumUp's secure hosted checkout page. Multi-currency support for EUR, GBP, USD, CHF, and 9 other European currencies.
Key Features
- Dual Checkout Modes — Choose between redirect (hosted page) or inline (embedded Card Widget) checkout
- On-Site Payment — Inline mode keeps customers on your store during payment
- Google Pay — Accept Google Pay in inline mode on supported devices
- SumUp Hosted Checkout — Customers pay via SumUp's secure hosted payment page
- Redirect-Based Flow — No card data touches your server (PCI SAQ A compliant)
- Multi-Currency — EUR, GBP, USD, CHF, PLN, SEK, NOK, DKK, CZK, HUF, BGN, RON, HRK
- Automatic Order Updates — Checkout status verified via API on customer return
- Configurable Order Statuses — Map SumUp statuses (PAID, FAILED) to any CS-Cart order status
- OAuth2 Bearer Authentication — Secure API communication using SumUp's official auth
- Idempotent Callbacks — Duplicate callbacks are safely ignored
- Secure by Default — SSL verification enabled, sensitive data stripped from logs
Requirements
- CS-Cart or Multi-Vendor 4.x
- PHP 7.1 or higher
- SumUp merchant account with API credentials (API Key and Merchant Code)
- Store currency set to a supported currency
Supported Currencies
EUR, GBP, USD, CHF, PLN, SEK, NOK, DKK, CZK, HUF, BGN, RON, HRK
How It Works
- Customer selects SumUp at checkout and clicks "Place Order"
- The addon creates a checkout session via SumUp's REST API
- Customer is redirected to SumUp's hosted checkout page to pay with their card
- After payment, customer is redirected back to your store
- The addon verifies the checkout status and updates the order accordingly
Checkout Modes
- Redirect (Default) — Customer is redirected to SumUp's secure hosted checkout page
- Inline (Embedded) — SumUp Card Widget JS SDK renders an embedded payment form directly on your checkout page, with support for Google Pay
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Go to Administration > Payment methods and create a new payment method
- Select "SumUp Payment Gateway" as the processor
- Enter your API Key and Merchant Code from the SumUp developer portal
- Configure order status mappings as desired
- Save and test before going live
Countries & Currencies
This addon is designed for merchants across Europe and other regions where SumUp operates. SumUp supports card payments in 13 currencies across 30+ countries. Ensure your store's currency matches your SumUp merchant account region.
