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. L'operatore seleziona il metodo e, per pagamenti elettronici, il terminale da utilizzare.
Terminali POS supportati
La cassa supporta l'integrazione con i seguenti terminali:
- SumUp Air: connessione Bluetooth, adatto a postazioni mobili
- Nexi SmartPOS: connessione Wi-Fi, per postazioni fisse
- 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.
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:
- Dalla console admin, accedere a Configurazione > Pagamenti > Stripe
- Collegare l'account Stripe del ristorante (Connected Account)
- Completare la verifica dell'account su Stripe
- 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
L'account Stripe del ristorante deve avere chargesEnabled: true per poter ricevere pagamenti. Verificare lo stato dalla dashboard Stripe.
Satispay
Per abilitare Satispay:
- Accedere a Configurazione > Pagamenti > Satispay
- Impostare
abilitato: true - Inserire le credenziali API fornite da Satispay Business
PayPal
Per abilitare PayPal:
- Accedere a Configurazione > Pagamenti > PayPal
- Impostare
abilitato: true - Configurare Client ID e Secret dell'app PayPal Business
Contrassegno
Il pagamento alla consegna non richiede integrazione con provider esterni:
- Accedere a Configurazione > Pagamenti > Contrassegno
- 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:
- Dalla console admin, accedere a Configurazione > Pagamenti > Buoni Pasto
- Aggiungere i tipi di buono accettati (es. Ticket Restaurant, Sodexo, Edenred)
- 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