This app integrates SumUp card terminals into ERPNext and allows card payments directly in the POS.
When a card payment is selected, the amount is sent to a SumUp terminal. After successful payment, the result is sent back to ERPNext and the POS sale is completed. In the event of a refund or return, the amount will also be automatically refunded for any previous SumUp payments.
Trademark notice: SumUp is a registered trademark of SumUp Payments Limited. This project is not affiliated with SumUp.
| ERPNext | Frappe | Support Status |
|---|---|---|
| v16 Beta | v16 Beta | Testing... |
| v15 | v15 | ✅ Supported |
The app can be installed directly via Frappe Cloud:
- Open the Frappe Cloud dashboard at https://frappecloud.com/dashboard/#/sites
- Click "New Site" to create a new site
- In the step "Select apps to install":
- Choose the desired Frappe/ERPNext version
- Enable the app
ERPNext SumUp
- Complete the wizard to create the site
Once ERPNext is installed, add the app to your bench environment:
bench get-app https://github.com/Rocket-Quack/erpnext_sumup.git --branch version-15Install requirements:
bench setup requirementsInstall the app on a site:
bench --site yoursite.com install-app erpnext_sumupRun migrations:
bench --site yoursite.com migrate- After installation, open the SumUp Integration
- Open SumUp Settings:
- Enable SumUp
- Enter API Key, Merchant Code and Affiliate Key
- Click Test Connection to fetch the merchant currency
- (Optional) Click Validate Merchant Code to verify correct keys and merchant
- Pair a terminal:
- Go to SumUp Terminal list
- Click Pair Terminal
- Start the SumUp Solo device and select **Cloud API** as the connection
- Generate a pairing code
- Enter the pairing code shown on the terminal and a name for the terminal to be used for administration purposes
- After successful connection, the terminal is listed. If necessary, the status can be updated manually using the Refresh Status button. The status is automatically updated at regular intervals.
- Mark a payment method for SumUp and assign the terminal:
- Open POS Profile
- Select the payment method you want to use with SumUp (Checkbox)
- Set the SumUp Terminal to be used for the POS profile
- Use in POS:
- As soon as a payment for SumUp has been selected, the workflows are triggered and the payment is forwarded to the terminal. If the payment is successful, the POS invoice is submitted directly.
Notes:
- SumUp Solo Cloud API How-to video on YouTube
- SumUp payments must cover the full invoice total.
- The POS invoice currency must match the SumUp merchant currency.
More detailed instructions can be found here:
Please create a ticket via Issues for:
- Bug Reports & Feature Requests
- Questions about general use
Development and maintenance are made possible by sponsors and voluntary support.
If you would like to support the project, you are welcome to do so via Ko-fi.
SumUp is a registered trademark of SumUp Payments Limited.
This project is an independent and unofficial integration and is not affiliated with SumUp. It is not operated, supported, or endorsed by SumUp.
The name SumUp is used only to describe technical compatibility with the respective services.
This app uses the Python package sumup v0.0.20 (tag v0.0.20). See THIRD_PARTY_NOTICE.md.
Copyright (C) 2026 RocketQuackIT
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
GNU GPL V3. See the LICENSE file for more information.
