SumUp Terminal Gateway
The SumUp Terminal gateway enables you to accept card payments using SumUp card readers directly within WCPOS. This gateway provides seamless integration with SumUp's payment processing system for in-person transactions.
Features
Hardware Integration
Connect SumUp card readers to your POS system via internet connection
Real-time Processing
Instant payment processing and order completion
Secure Transactions
PCI-compliant payment processing through SumUp
Easy Pairing
Simple device pairing process with pairing codes
Installation
Install SumUp Terminal for WooCommerce
Install from WP Admin > POS > Settings > Extensions, or download the latest plugin zip asset (not the GitHub source-code zip or tarball) from the GitHub releases page and upload it via Plugins > Add New > Upload Plugin.
Configure SumUp Settings
- Navigate to
WP Admin > WooCommerce > Settings > Payments - Find SumUp Terminal in the payment methods list
- Click on SumUp Terminal to access settings
- Enter your SumUp API Key (available from your SumUp merchant dashboard)
- Save the settings
You do not need to enable the SumUp Terminal gateway in WooCommerce settings. It will be enabled specifically for the POS in a later step.
For a Solo over the cloud, the API key and a pairing code are all you need. The store tells SumUp where to send the result with each payment.
Pair Your SumUp Terminal
- On the same settings page, locate the Pair Reader section
- On your SumUp device, log out of any SumUp account, open the menu and go to Connections → Cloud API. It is the last item in the list, below Wi-Fi and Bluetooth. Tap Connect to display the pairing code
- Enter the pairing code displayed on your SumUp device
- Click "Pair Reader" to establish the connection
- Wait for confirmation that the reader has been successfully paired
Don’t see “Cloud API” on your SumUp Solo? Log out of your SumUp account on the reader, then check the menu again.
The reader must be successfully paired before you can process payments. Ensure the pairing process is completed before proceeding.
Enable in WCPOS
- Go to
WP Admin > POS > Settings > Checkout - Find the SumUp Terminal gateway in the list
- Enable the gateway for use in the POS
- Save your settings
Usage
Processing Payments
- Add Items: Add products to your cart in the POS and press Checkout
- Select Gateway: Tap the SumUp Terminal tile on the tender pane. A version of the extension without a tender-pane tile is on the Legacy tab instead
- Start Payment: Press Send to send the amount to your SumUp device
- Customer Payment: Customer completes payment on the SumUp terminal
- Automatic Completion: The sale completes when the payment is approved
Payment Controls
On the tender pane, the till shows each step of the payment and offers Cancel on terminal. On the Legacy tab, the payment page shows a Terminal picker with Send to terminal, Cancel and Try again.
Older versions of the extension use their own payment page on the Legacy tab, with these options:
- Start New Payment: Initiate a payment request on the connected terminal
- Cancel Payment: Cancel a payment currently in process
- Payment Status: Monitor the current status of the payment process
Order Management
- Automatic Updates: Orders are automatically marked as completed upon successful payment
- Payment Tracking: All payment details are recorded in the order notes
- Receipt Generation: Standard POS receipts are generated after successful payments
Requirements
Hardware Compatibility
Choose how the POS reaches the reader with POS connection on the gateway's settings page. One gateway uses one connection.
Internet-connected
- SumUp Solo ✅ - WiFi/Ethernet connected terminal, paired to the store (Solo over the cloud, the default). It works from every till, on the tender pane.
Bluetooth (iOS and Android apps)
- SumUp Solo Lite, Solo and Air ✅ - set POS connection to the Bluetooth reader option and enter the Affiliate Key. Then, in the app, go to Settings → Card readers and tap Open SumUp reader settings, which opens SumUp's own screen to sign in and choose the reader.
- A Bluetooth reader works only in the iOS and Android apps. With this connection, the SumUp tile is hidden on a web or desktop till.
- The Bluetooth option appears only when the installed WCPOS Pro supports readers that the app drives.
Offline Card Payments
With Offline card payments turned on, a Bluetooth Solo or Solo Lite can take card payments while the POS is offline. The reader approves them, and they can still be declined when they upload. SumUp must enable offline payments on your account first.
Older versions of the extension have no tender-pane tile: the gateway is on the Legacy tab and works with an internet-connected Solo only.
Troubleshooting
Common Issues
Reader won't pair
- Ensure you're using a supported internet-connected terminal (Solo only)
- Verify your SumUp Solo device is connected to WiFi and online
- Check that the device is in pairing mode and pairing code is entered correctly
- Confirm your SumUp account has API access enabled
- Ensure stable internet connection during pairing
Payment not processing
- Verify the reader is properly paired
- Check that your SumUp account is active and in good standing
- Ensure the device has sufficient battery and connectivity
- Confirm API key is correct and active
Order not completing
- Check internet connection stability
- Verify webhook settings in your SumUp account
- Ensure the payment was successful on the SumUp terminal
- Check WordPress error logs for API communication issues
API Rate Limits
The gateway is optimized to reduce API calls and avoid rate limiting:
- Payment status is checked efficiently
- Unnecessary API requests are minimized
- Automatic retry logic handles temporary failures
Getting Help
For technical support:
- Visit the GitHub repository to report issues
- Check the SumUp developer documentation for API-related questions
- Contact SumUp support for account and hardware issues
Screenshots
Screenshots will be added in a future update to show:
- SumUp API key configuration and device pairing interface
- Gateway enablement in WCPOS settings
- Payment processing workflow in the POS checkout