Skip to main content
Version: 2.x

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​

1

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.

2

Configure SumUp Settings

  1. Navigate to WP Admin > WooCommerce > Settings > Payments
  2. Find SumUp Terminal in the payment methods list
  3. Click on SumUp Terminal to access settings
  4. Enter your SumUp API Key (available from your SumUp merchant dashboard)
  5. Save the settings
note

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.

No webhook to set up

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.

3

Pair Your SumUp Terminal

  1. On the same settings page, locate the Pair Reader section
  2. 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
  3. Enter the pairing code displayed on your SumUp device
  4. Click "Pair Reader" to establish the connection
  5. 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.

Important

The reader must be successfully paired before you can process payments. Ensure the pairing process is completed before proceeding.

4

Enable in WCPOS

  1. Go to WP Admin > POS > Settings > Checkout
  2. Find the SumUp Terminal gateway in the list
  3. Enable the gateway for use in the POS
  4. Save your settings

Usage​

Processing Payments​

  1. Add Items: Add products to your cart in the POS and press Checkout
  2. 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
  3. Start Payment: Press Send to send the amount to your SumUp device
  4. Customer Payment: Customer completes payment on the SumUp terminal
  5. 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​

SumUp Account: Active SumUp merchant account
API Access: SumUp API key from your merchant dashboard
Compatible Hardware: SumUp card reader device
WCPOS: Pro version required for POS checkout
Stable Connection: Reliable internet connection for API communication

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:

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