Gateway SumUp Terminal
Il gateway SumUp Terminal consente di accettare pagamenti con carta utilizzando i lettori di carte SumUp direttamente in WCPOS. Questo gateway offre un'integrazione completa con il sistema di elaborazione pagamenti di SumUp per le transazioni in presenza.
Funzionalità
Integrazione hardware
Collega i lettori di carte SumUp al sistema POS tramite connessione internet
Elaborazione in tempo reale
Elaborazione istantanea dei pagamenti e completamento degli ordini
Transazioni sicure
Elaborazione dei pagamenti conforme allo standard PCI tramite SumUp
Abbinamento semplice
Procedura di associazione semplice tramite codici di abbinamento
Installazione
Installare SumUp Terminal per WooCommerce
Installare da WP Admin > POS > Impostazioni > Estensioni, oppure scaricare l'ultimo file zip del plugin (non il file zip o tarball del codice sorgente GitHub) dalla pagina delle release su GitHub e caricarlo tramite Plugin > Aggiungi Nuovo > Carica plugin.
Configurare le impostazioni di SumUp
- Navigare in
WP Admin > WooCommerce > Impostazioni > Pagamenti - Individuare SumUp Terminal nell'elenco dei metodi di pagamento
- Fare clic su SumUp Terminal per accedere alle impostazioni
- Inserire la propria chiave API SumUp (disponibile nel pannello di controllo esercente SumUp)
- Salvare le impostazioni
Non è necessario abilitare il gateway SumUp Terminal nelle impostazioni di WooCommerce. Verrà abilitato specificamente per il POS in un passaggio successivo.
Associa il tuo SumUp Terminal
- Nella stessa pagina delle impostazioni, individua la sezione Associa lettore
- Sul dispositivo SumUp, accedi alla schermata di associazione per visualizzare il codice di abbinamento
- Inserisci il codice di abbinamento visualizzato sul dispositivo SumUp
- Fai clic su "Associa lettore" per stabilire la connessione
- Attendi la conferma che il lettore è stato associato correttamente
Il lettore deve essere associato correttamente prima di poter elaborare i pagamenti. Assicurati che il processo di associazione sia completato prima di procedere.
Attiva in WCPOS
- Vai su
WP Admin > POS > Impostazioni > Pagamento - Trovare il gateway SumUp Terminal nell'elenco
- Abilitare il gateway per l'utilizzo nel POS
- Salvare le impostazioni
Utilizzo
Elaborazione dei pagamenti
- Aggiungere articoli: aggiungere i prodotti al carrello nel POS
- Selezionare il gateway: scegliere "SumUp Terminal" come metodo di pagamento
- Avviare il pagamento: fare clic per avviare un nuovo pagamento sul dispositivo SumUp
- Pagamento del cliente: il cliente completa il pagamento sul terminale SumUp
- Completamento automatico: l'ordine viene completato automaticamente quando il pagamento viene rilevato
Controlli di pagamento
Quando si utilizza il gateway SumUp Terminal, sono disponibili le seguenti opzioni:
- Avvia nuovo pagamento: Avvia una richiesta di pagamento sul terminale collegato
- Annulla pagamento: Annulla un pagamento attualmente in corso
- Stato del pagamento: Monitora lo stato attuale del processo di pagamento
Gestione degli ordini
- Aggiornamenti automatici: Gli ordini vengono automaticamente contrassegnati come completati al termine di un pagamento riuscito
- Tracciamento dei pagamenti: Tutti i dettagli del pagamento vengono registrati nelle note dell'ordine
- Generazione ricevute: Le ricevute POS standard vengono generate dopo i pagamenti riusciti
Requisiti
Compatibilità hardware
Questa implementazione utilizza il JavaScript SDK di SumUp, il che significa che funziona tramite applicazioni web ma richiede solo terminali connessi a internet. I terminali Bluetooth non sono attualmente supportati.
Terminali supportati (connessi a internet)
- SumUp Solo ✅ - Terminale connesso tramite WiFi/Ethernet
Terminali non supportati (Bluetooth)
- SumUp Air ❌ - Solo Bluetooth
- SumUp 3G ❌ - Solo Bluetooth
Il supporto per i terminali Bluetooth è previsto in una futura versione dell'app iOS e Android. Una volta disponibile, consentirà il supporto per tutti i terminali certificati SumUp, inclusi i modelli Air e 3G.
Risoluzione dei problemi
Problemi comuni
Il lettore non si associa
- Assicurarsi di utilizzare un terminale supportato con connessione a internet (solo Solo)
- Verificare che il dispositivo SumUp Solo sia connesso al WiFi e online
- Controllare che il dispositivo sia in modalità di associazione e che il codice di associazione sia stato inserito correttamente
- Verificare che l'account SumUp abbia l'accesso API abilitato
- Assicurarsi di avere una connessione internet stabile durante l'associazione
Pagamento non elaborato
- Verificare che il lettore sia correttamente associato
- Verificare che l'account SumUp sia attivo e in regola
- Assicurarsi che il dispositivo abbia batteria sufficiente e connettività
- Verificare che la chiave API sia corretta e attiva
Ordine non completato
- Verificare la stabilità della connessione internet
- Verificare le impostazioni webhook nell'account SumUp
- Assicurarsi che il pagamento sia andato a buon fine sul terminale SumUp
- Controllare i log degli errori di WordPress per problemi di comunicazione API
Limiti di frequenza API
Il gateway è ottimizzato per ridurre le chiamate API ed evitare i limiti di frequenza:
- Lo stato del pagamento viene verificato in modo efficiente
- Le richieste API non necessarie vengono ridotte al minimo
- La logica di ripetizione automatica gestisce gli errori temporanei
Assistenza
Per supporto tecnico:
- Visitare il repository GitHub per segnalare problemi
- Consultare la documentazione per sviluppatori SumUp per domande relative alle API
- Contattare il supporto SumUp per problemi relativi all'account e all'hardware
Schermate
Le schermate verranno aggiunte in un aggiornamento futuro per mostrare:
- Configurazione della chiave API SumUp e interfaccia di associazione del dispositivo
- Abilitazione del gateway nelle impostazioni WCPOS
- Flusso di elaborazione del pagamento nella cassa POS