Gateway Terminal SumUp
Il gateway Terminal SumUp ti consente di accettare pagamenti con carta utilizzando i lettori di carte SumUp direttamente all'interno di WooCommerce POS. Questo gateway offre un'integrazione senza soluzione di continuità con il sistema di elaborazione pagamenti di SumUp per le transazioni di persona.
Caratteristiche
Integrazione Hardware
Collega i lettori di carte SumUp al tuo sistema POS tramite connessione internet
Elaborazione in Tempo Reale
Elaborazione dei pagamenti istantanea e completamento degli ordini
Transazioni Sicure
Elaborazione dei pagamenti conforme PCI tramite SumUp
Associamento Facile
Processo di associazione semplice con codici di associazione
Installazione
Scarica e Installa
- Visita la pagina dei rilasci di SumUp Terminal per WooCommerce
- Scarica l'ultima versione del file sumup-terminal-for-woocommerce.zip
- Nel tuo admin di WordPress, vai su
Plugin > Aggiungi Nuovo > Carica Plugin - Carica il file zip e attiva il plugin
Configura le Impostazioni di SumUp
- Naviga su
WP Admin > WooCommerce > Impostazioni > Pagamenti - Trova Terminal SumUp nella lista dei metodi di pagamento
- Clicca su Terminal SumUp per accedere alle impostazioni
- Inserisci la tua API Key di SumUp (disponibile dal tuo dashboard commerciante SumUp)
- Salva le impostazioni
Non è necessario abilitare il gateway Terminal SumUp nelle impostazioni di WooCommerce. Sarà abilitato specificamente per il POS in un passaggio successivo.
Associa il Tuo Terminal SumUp
- Nella stessa pagina delle impostazioni, trova la sezione Associa Lettore
- Sul tuo dispositivo SumUp, naviga sulla schermata di associazione per visualizzare il codice di associazione
- Inserisci il codice di associazione visualizzato sul tuo dispositivo SumUp
- Clicca su "Associa Lettore" per stabilire la connessione
- Attendi la conferma che il lettore è stato associato con successo
Il lettore deve essere associato con successo prima di poter elaborare i pagamenti. Assicurati che il processo di associazione sia completato prima di procedere.
Abilita in WooCommerce POS
- Vai su
WP Admin > WooCommerce POS > Impostazioni > Checkout - Trova il gateway Terminal SumUp nell'elenco
- Abilita il gateway per l'uso nel POS
- Salva le tue impostazioni
Utilizzo
Elaborazione Pagamenti
- Aggiungi Articoli: Aggiungi prodotti al tuo carrello nel POS
- Seleziona Gateway: Scegli "Terminal SumUp" come metodo di pagamento
- Inizia Pagamento: Clicca per avviare un nuovo pagamento sul tuo dispositivo SumUp
- Pagamento Cliente: Il cliente completa il pagamento sul terminal SumUp
- Completamento Automatico: L'ordine si completa automaticamente quando il pagamento viene rilevato
Controlli di Pagamento
Quando utilizzi il gateway Terminal SumUp, hai le seguenti opzioni:
- Inizia Nuovo Pagamento: Iniziare una richiesta di pagamento sul terminal collegato
- Annulla Pagamento: Annulla un pagamento attualmente in corso
- Stato del Pagamento: Monitora lo stato attuale del processo di pagamento
Gestione Ordini
- Aggiornamenti Automatici: Gli ordini sono automaticamente contrassegnati come completati dopo il pagamento riuscito
- Monitoraggio Pagamenti: Tutti i dettagli di pagamento sono registrati nelle note dell'ordine
- Generazione Ricevute: Le ricevute standard POS vengono generate dopo i pagamenti riusciti
Requisiti
Compatibilità Hardware
Questa implementazione utilizza il SDK JavaScript di SumUp, il che significa che funziona tramite applicazioni web ma richiede terminale connessi a internet solamente. I terminali Bluetooth non sono attualmente supportati.
Terminali Supportati (Connessi a Internet)
- SumUp Solo ✅ - terminale connesso via WiFi/Ethernet
Terminali Non Supportati (Bluetooth)
- SumUp Air ❌ - solo Bluetooth
- SumUp 3G ❌ - solo Bluetooth
Il supporto dei terminali Bluetooth sarà aggiunto alle applicazioni iOS e Android nel Q1 2026. Ciò consentirà il supporto per tutti i terminali certificati SumUp, compresi i modelli Air e 3G.
Risoluzione dei Problemi
Problemi Comuni
Il lettore non si associa
- Assicurati di utilizzare un terminale connesso a internet supportato (Solo)
- Verifica che il tuo dispositivo SumUp Solo sia connesso a WiFi e online
- Controlla che il dispositivo sia in modalità di associazione e che il codice di associazione sia inserito correttamente
- Conferma che il tuo account SumUp abbia accesso API abilitato
- Assicurati di una connessione internet stabile durante l'associazione
Pagamento non elaborato
- Verifica che il lettore sia correttamente associato
- Controlla che il tuo account SumUp sia attivo e in regola
- Assicurati che il dispositivo abbia batteria e connettività sufficienti
- Conferma che l'API key sia corretta e attiva
Ordine non completato
- Controlla la stabilità della connessione internet
- Verifica le impostazioni webhook nel tuo account SumUp
- Assicurati che il pagamento sia avvenuto con successo sul terminal SumUp
- Controlla i log degli errori di WordPress per problemi di comunicazione API
Limiti di Frequenza API
Il gateway è ottimizzato per ridurre le chiamate API e evitare limiti di frequenza:
- Lo stato del pagamento viene controllato in modo efficiente
- Le richieste API non necessarie vengono ridotte al minimo
- La logica di ripetizione automatica gestisce i fallimenti temporanei
Ottenere Aiuto
Per supporto tecnico:
- Visita il repository GitHub per segnalare problemi
- Controlla la documentazione per sviluppatori di SumUp per domande relative all'API
- Contatta il supporto SumUp per problemi relativi ad account e hardware
Screenshot
Gli screenshot verranno aggiunti in un aggiornamento futuro per mostrare:
- Configurazione della chiave API di SumUp e interfaccia di associazione del dispositivo
- Abilitazione del gateway nelle impostazioni di WooCommerce POS
- Flusso di elaborazione dei pagamenti nel checkout POS