Skip to main content
Version: 1.x

SumUp Terminal Gateway

The SumUp Terminal gateway enables you to accept card payments using SumUp card readers directly within WooCommerce POS. 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
  • Automatic Detection: Orders complete automatically when payment is detected
  • Secure Transactions: PCI-compliant payment processing through SumUp
  • Easy Pairing: Simple device pairing process with pairing codes
  • Web-based SDK: Uses SumUp's JavaScript SDK for web application compatibility

Installation​

Step 1: Download and Install​

  1. Visit the SumUp Terminal for WooCommerce releases page
  2. Download the latest sumup-terminal-for-woocommerce.zip file
  3. In your WordPress admin, go to Plugins > Add New > Upload Plugin
  4. Upload the zip file and activate the plugin

Step 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.

Step 3: Pair Your SumUp Terminal​

  1. On the same settings page, locate the Pair Reader section
  2. On your SumUp device, navigate to the pairing screen 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
Important

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

Step 4: Enable in WooCommerce POS​

  1. Go to WP Admin > WooCommerce 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
  2. Select Gateway: Choose "SumUp Terminal" as the payment method
  3. Start Payment: Click to initiate a new payment on your SumUp device
  4. Customer Payment: Customer completes payment on the SumUp terminal
  5. Automatic Completion: The order automatically completes when payment is detected

Payment Controls​

When using the SumUp Terminal gateway, you have the following 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
  • WooCommerce POS: Free or Pro version installed and activated
  • Stable Connection: Reliable internet connection for API communication

Hardware Compatibility​

Connectivity Requirements

This implementation uses SumUp's JavaScript SDK, which means it works through web applications but requires internet-connected terminals only. Bluetooth terminals are not currently supported.

Supported Terminals (Internet-Connected)​

  • SumUp Solo ✅ - WiFi/Ethernet connected terminal

Unsupported Terminals (Bluetooth)​

  • SumUp Air ❌ - Bluetooth only
  • SumUp 3G ❌ - Bluetooth only
Future Support

Bluetooth terminal support will be added to the iOS and Android applications in Q1 2026. This will enable support for all SumUp certified terminals including the Air and 3G models.

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 WooCommerce POS settings
  • Payment processing workflow in the POS checkout