# 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[​](#features "Direct link to 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[​](#installation "Direct link to 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](https://github.com/wcpos/sumup-terminal-for-woocommerce/releases) 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[​](#usage "Direct link to Usage")

### Processing Payments[​](#processing-payments "Direct link to 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[​](#payment-controls "Direct link to 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[​](#order-management "Direct link to 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[​](#requirements "Direct link to 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[​](#hardware-compatibility "Direct link to 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[​](#supported-terminals-internet-connected "Direct link to 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)[​](#unsupported-terminals-bluetooth "Direct link to 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[​](#offline-payments "Direct link to 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[​](#troubleshooting "Direct link to Troubleshooting")

### Common Issues[​](#common-issues "Direct link to 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[​](#api-rate-limits "Direct link to 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[​](#getting-help "Direct link to Getting Help")

For technical support:

* Visit the [GitHub repository](https://github.com/wcpos/sumup-terminal-for-woocommerce) to report issues
* Check the [SumUp developer documentation](https://developer.sumup.com/) for API-related questions
* Contact SumUp support for account and hardware issues

## Screenshots[​](#screenshots "Direct link to 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
