Gestione Metodi di Pagamento

La piattaforma supporta metodi di pagamento POS (in cassa) e online (per ordini da app e web). La configurazione avviene dalla console di amministrazione nella sezione Configurazione > Pagamenti.

Metodi POS (Cassa)

I metodi POS sono sempre disponibili e non richiedono configurazione aggiuntiva:

Metodo	Codice	Descrizione
Contanti	CASH	Pagamento in contanti con calcolo resto
Carta	CARD	Pagamento elettronico tramite terminale POS
Misto	MIXED	Combinazione di piu metodi (es. parte contanti, parte carta)

In cassa, il flusso di pagamento si attiva tramite il tasto con azione UI_OPEN_PAYMENT. Il campo Metodo di pagamento del tasto (paymentType) stabilisce cosa succede al tocco:

Metodo del tasto	paymentType	Al tocco
Misto	mixed	Si apre la schermata di pagamento: l'operatore sceglie il metodo (e il terminale, se più di uno) e può dividere l'importo
Contanti	cash	L'intero totale si incassa subito in contanti e lo scontrino si stampa senza passare dalla schermata
Carta/POS	electronic	La transazione per l'intero totale parte subito sul terminale POS della postazione

Misto è il predefinito per i tasti nuovi. Anche un tasto senza paymentType si comporta come Misto.

Con Contanti o Carta/POS la schermata di pagamento si apre comunque quando:

• il documento è Scontrino + Fattura: è ammesso solo «Scontrino Segue Fattura»;
• per Contanti, il tenant obbliga alla cassa automatica e la postazione ne ha una;
• per Carta/POS, la postazione ha più terminali: l'operatore sceglie su quale incassare;
• per Carta/POS, la postazione non ha terminali configurati: compare un avviso e l'operatore sceglie un altro metodo;
• il terminale rifiuta la carta o la transazione viene annullata: la schermata mostra l'errore e si può riprovare o cambiare metodo.

I controlli che precedono il pagamento restano sempre attivi, anche con l'incasso immediato: varianti obbligatorie, codice fiscale per la Tessera Sanitaria, tavolo e coperti.

Terminali POS supportati

La cassa supporta l'integrazione con i seguenti terminali:

• SumUp Air: connessione Bluetooth, adatto a postazioni mobili
• Nexi — POS tradizionale (LAN): connessione via rete locale, con indirizzo IP e porta del terminale
• Nexi Cloud (SmartPOS): il pagamento arriva al terminale via internet, senza indirizzo IP né rete locale (vedi sotto)
• Ingenico: integrazione diretta via protocollo proprietario
• Stripe Terminal: per ambienti che utilizzano l'ecosistema Stripe
• Inserimento manuale: per registrare pagamenti carta senza integrazione diretta

La selezione del terminale avviene al momento del pagamento tramite il dialog di selezione dispositivo.

Nexi Cloud (SmartPOS)

Con Nexi Cloud la cassa o il kiosk inviano l'importo al terminale Nexi SmartPOS attraverso il cloud Nexi. Il terminale può stare su Wi-Fi o su rete mobile. Lo stesso terminale si può assegnare a più casse e a un kiosk: un solo pagamento alla volta, e chi arriva secondo legge «Terminale in uso da un'altra postazione».

Collegamento dell'account (una volta per punto vendita, da un amministratore):

1. In console apri Dispositivi > Terminali di pagamento e, nella scheda Nexi Cloud, premi Collega account Nexi.
2. Accedi con le credenziali Nexi del punto vendita e autorizza l'app.
3. Torni in console con l'account indicato come collegato e il nome dell'attività.

Un account Nexi si collega a un solo punto vendita, oppure a più negozi della stessa catena. Se l'account è già collegato a un altro punto vendita, la console mostra «Questo account Nexi è già collegato a un altro punto vendita»: per spostarlo, scollegalo prima dall'altro punto vendita, oppure chiedi all'assistenza.

Aggiunta del terminale:

1. Premi Aggiungi terminale e scegli il tipo Nexi SmartPOS — cloud.
2. Scegli il terminale dall'elenco, dove compare con il suo Terminal ID (TID): è il numero che trovi sul terminale e nei documenti Nexi. Se Nexi sostituisce il terminale fisico, il nuovo viene ritrovato da solo con lo stesso TID.
3. Assegnalo alle postazioni (casse e kiosk) che lo usano.

Sul kiosk, nelle impostazioni hardware, scegli il tipo Nexi SmartPOS — cloud. Il terminale è quello assegnato al kiosk in console.

Durante il pagamento:

• Annulla chiede al terminale di interrompere l'operazione. Se la carta era già stata presentata, l'annullo non ha effetto e il pagamento si conclude normalmente.
• Se il terminale è spento o non raggiunge internet, dopo circa mezzo minuto la cassa avvisa che il terminale non ha ricevuto la richiesta. In questo caso non c'è alcun addebito.
• Se l'esito non arriva, la cassa mostra Esito non accertato. Prima di ripetere il pagamento o di cambiare metodo, controlla sul terminale se l'importo è stato incassato.

Pagamenti da verificare: la scheda Nexi Cloud elenca gli incassi che richiedono un controllo. Sono quelli con esito non accertato, quelli addebitati dopo che la cassa aveva chiuso l'operazione e quelli riusciti ma mai registrati da una cassa che si è spenta. Dopo il controllo premi Verificato.

La ricevuta del pagamento la stampa il terminale. Sullo scontrino fiscale il pagamento compare come Carta.

Metodi Online

I metodi online si abilitano dalla configurazione del tenant, nella sezione pagamenti dell'AppConfig. Ogni metodo richiede le proprie credenziali.

Stripe (Carte di Credito/Debito)

Stripe e il provider principale per pagamenti online. La piattaforma utilizza Stripe Connect per gestire i pagamenti multi-tenant:

1. Dalla console admin, accedere a Configurazione > Pagamenti > Stripe
2. Collegare l'account Stripe del ristorante (Connected Account)
3. Completare la verifica dell'account su Stripe
4. Configurare i parametri:
   • stripeConnectId: ID dell'account collegato (assegnato automaticamente)
   • applicationFeePercent: commissione piattaforma in percentuale (default: 3%)
   • applicationFeeFixed: eventuale importo fisso aggiuntivo in centesimi
   • defaultCurrency: valuta predefinita (default: EUR)
   • statementDescriptor: descrizione che appare sull'estratto conto del cliente (max 22 caratteri)
   • receiptEmailEnabled: invio ricevuta via email al cliente

caution

L'account Stripe del ristorante deve avere chargesEnabled: true per poter ricevere pagamenti. Verificare lo stato dalla dashboard Stripe.

Satispay

Per abilitare Satispay:

1. Accedere a Configurazione > Pagamenti > Satispay
2. Impostare abilitato: true
3. Inserire le credenziali API fornite da Satispay Business

PayPal

Per abilitare PayPal:

1. Accedere a Configurazione > Pagamenti > PayPal
2. Impostare abilitato: true
3. Configurare Client ID e Secret dell'app PayPal Business

Contrassegno

Il pagamento alla consegna non richiede integrazione con provider esterni:

1. Accedere a Configurazione > Pagamenti > Contrassegno
2. Impostare abilitato: true

Il pagamento viene registrato con stato pending e confermato manualmente dal fattorino o dall'operatore.

Apple Pay e Google Pay

Apple Pay e Google Pay sono estensioni di Stripe e si abilitano nella stessa sezione:

• applePay.abilitato: abilita Apple Pay (richiede Stripe attivo)
• googlePay.abilitato: abilita Google Pay (richiede Stripe attivo)

Questi metodi appaiono automaticamente nell'app cliente quando il dispositivo li supporta.

Buoni Pasto

I buoni pasto si gestiscono tramite la modale dedicata in cassa (azione UI_OPEN_MODAL con modalKey: MEAL_VOUCHER_SELECT). Per configurare i buoni pasto accettati:

1. Dalla console admin, accedere a Configurazione > Pagamenti > Buoni Pasto
2. Aggiungere i tipi di buono accettati (es. Ticket Restaurant, Sodexo, Edenred)
3. Per ogni tipo, specificare il valore nominale e l'eventuale commissione

In cassa, l'operatore seleziona il tipo di buono e il sistema gestisce automaticamente il resto da pagare con altro metodo.

Stati del Pagamento

Ogni pagamento attraversa i seguenti stati:

Stato	Descrizione
pending	In attesa di pagamento
processing	Pagamento in elaborazione dal provider
completato	Pagamento concluso con successo
fallito	Pagamento non riuscito
annullato	Pagamento annullato dall'operatore
rimborsato	Pagamento rimborsato

FAQ

Posso accettare pagamenti misti (parte contanti, parte carta)? Si. Selezionare il metodo MIXED in cassa. Il sistema permette di suddividere l'importo tra piu metodi e calcola automaticamente il resto.

Come verifico lo stato di un pagamento online? Dalla console admin, nella sezione Pagamenti, e possibile cercare per ID ordine o periodo e visualizzare lo stato aggiornato in tempo reale.

Le commissioni Stripe vengono dedotte automaticamente? Si. La piattaforma trattiene la applicationFee configurata e trasferisce il netto al Connected Account del ristorante tramite Stripe Connect.

Vedi Anche

• Layout Cassa -- configurazione tasti pagamento
• Catalogo Prodotti -- prezzi e IVA degli articoli
• Template Stampe -- personalizzazione scontrini di pagamento