# 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. 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. 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 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[​](#payment-controls "Direct link to 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[​](#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") 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)[​](#supported-terminals-internet-connected "Direct link to Supported Terminals (Internet-Connected)") * **SumUp Solo** ✅ - WiFi/Ethernet connected terminal ### Unsupported Terminals (Bluetooth)[​](#unsupported-terminals-bluetooth "Direct link to Unsupported Terminals (Bluetooth)") * **SumUp Air** ❌ - Bluetooth only * **SumUp 3G** ❌ - Bluetooth only Future Support Bluetooth terminal support is planned for a future iOS and Android app release. When available, this will enable support for all SumUp certified terminals including the Air and 3G models. ## 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