Connessione di Stripe

Accettazione di pagamenti online tramite Stripe: carte, Apple Pay, Google Pay.

1. Panoramica#

Stripe è una piattaforma di pagamento globale. Nel registro di Cenaly, Stripe è disponibile per la connessione in 46 paesi. L'integrazione Cenaly + Stripe consente di:

• 💳 Accettare pagamenti con carte (Visa, Mastercard, AmEx)
• 📱 Apple Pay / Google Pay — pagamento con un solo tocco
• 💰 Ricevere pagamenti sul vostro conto bancario
• 🔄 Gestire i rimborsi dal pannello di amministrazione
• 💵 Mance — l'ospite aggiunge la mancia al momento del pagamento
• 📊 Report — analisi finanziaria completa

2. Requisiti#

• ✅ Account Cenaly (il pagamento online è disponibile su qualsiasi piano, incluso quello gratuito)
• ✅ Account Stripe (registrazione gratuita su stripe.com)
• ✅ Conto bancario per i pagamenti (nella valuta del vostro paese)
• ✅ Documenti per la verifica (passaporto / ID, documenti societari)

Paesi supportati#

Stripe è disponibile per la connessione in 46 paesi:

3. Creazione dell'account Stripe#

Passo 1. Registrazione#

1. Andate su stripe.com → Start now
2. Inserite l'email e create una password
3. Confermate l'email

Passo 2. Verifica dell'attività#

Stripe richiederà:

La verifica richiede di solito 1–3 giorni lavorativi.

Passo 3. Ottenete le chiavi API#

1. Nella dashboard di Stripe: Developers → API keys
2. Copiate:
   • Publishable key (pk_live_...)
   • Secret key (sk_live_...)

4. Connessione a Cenaly#

Si collega il vostro account Stripe: il denaro dell'ospite va direttamente sul vostro saldo Stripe, Cenaly non lo trattiene.

Aprite App Store → categoria «Finanza» → scheda Stripe → «Configura» — il blocco di connessione si aprirà come modale direttamente nello store. Funziona anche il percorso abituale: Sedi → scheda della sede → scheda «Pagamenti» (sezione «Pagamento dell'ospite»), pulsante «Collega» accanto alla scheda Stripe.

Procedura guidata di connessione (consigliata)#

La procedura guidata passo passo (≈10 minuti) accompagna attraverso l'intero processo, mostrando dove cliccare nella dashboard di Stripe:

1. Scegliete la modalità — di test o di produzione. La modalità in Stripe e l'interruttore «Test / Produzione» in Cenaly devono coincidere.
2. Copiate le chiavi — Developers → API keys: la Secret key (sk_test_… / sk_live_…) è obbligatoria, la Publishable key (pk_…) è facoltativa.
3. Aggiungete il webhook — Developers → Webhooks → Add endpoint, e nel campo Endpoint URL incollate l'indirizzo del webhook di Cenaly che la procedura guidata fornisce con il pulsante «Copia». Senza webhook Stripe non comunicherà che l'ordine è pagato, e l'ordine potrebbe restare nello stato «in attesa».
4. Scegliete gli eventi — nel blocco «Select events» aggiungete obbligatoriamente checkout.session.completed (è proprio quello che conferma il pagamento dell'ordine), e per i metodi di pagamento differiti anche checkout.session.async_payment_succeeded e checkout.session.async_payment_failed. Poi premete «Add endpoint». Senza questi eventi il webhook è creato, ma non comunicherà il pagamento.
5. Copiate il Webhook signing secret (whsec_…) — campo facoltativo, ma con esso si attiva la verifica della firma delle notifiche.
6. Collegate — i valori inseriti vengono inviati al backend protetto.

Modulo breve#

Se sapete già dove si trova tutto in Stripe, aprite il modulo di connessione inline e compilate gli stessi campi: Secret key, Webhook signing secret (opz.), Publishable key (opz.) più l'interruttore della modalità.

5. Configurazione dei metodi di pagamento#

Carte bancarie#

Attivate automaticamente al collegamento di Stripe:

• Visa / Mastercard — tutti i paesi
• American Express — la maggior parte dei paesi
• Diners Club / Discover — in modo selettivo

Apple Pay e Google Pay#

In Cenaly non esistono interruttori dedicati: il pagamento avviene sulla pagina hosted di Stripe Checkout, quindi i wallet si attivano dal lato Stripe.

• Google Pay — funziona subito dopo il collegamento di Stripe (Android, Chrome).
• Apple Pay — Stripe richiede di verificare il dominio: Settings → Payment methods → Apple Pay → Add new domain. Dopo la verifica il pulsante comparirà su iOS/Safari.

Altri metodi#

Tramite Stripe Dashboard è possibile attivare:

Attivate i metodi desiderati in Stripe Dashboard → Settings → Payment methods.

6. Mance#

Configurazione#

1. Sedi → scheda della sede → tab «Generale» → interruttore «Mance».
2. Come funziona:

Come lo vede l'ospite#

Al momento del pagamento, dopo la scelta dei piatti:

Il tuo ordine: 45₾

Aggiungere una mancia?
[ 10% (4.50₾) ] [ 15% (6.75₾) ] [ 20% (9.00₾) ] [ Altro importo ]
[ Senza mancia ]

TOTALE: 49.50₾   [Paga →]

Report sulle mance#

Sezione Finanze:

• tab «Panoramica» — importo totale delle mance per il periodo con confronto rispetto al precedente;
• tab «Vendite» — mance suddivise per cameriere.

7. Pagamenti sul vostro conto#

Come Stripe versa il denaro#

L'ospite paga → Stripe trattiene → Dopo T+2 giorni → Denaro sul vostro conto

Configurazione della pianificazione#

In Stripe Dashboard → Settings → Payouts:

• Giornaliero (consigliato)
• Settimanale (giorno specifico della settimana)
• Mensile

8. Commissioni Stripe#

9. Rimborsi#

Il rimborso tramite Stripe si avvia da due punti — a seconda di come è stato gestito l'ordine.

Rimborsi dell'e-commerce (RMA)#

1. Sezione Resi → scheda della richiesta.
2. Scegliete la modalità di rimborso: sul metodo di pagamento originale (Stripe), con carta regalo (store credit) o con cambio.
3. Selezionate gli articoli (rimborso totale o parziale) e decidete se restituire la merce a magazzino.
4. Il denaro parte direttamente dalla pagina; sulla carta dell'ospite arriva di solito entro 5–10 giorni lavorativi.

Rimborsi in cassa#

Nel POS il rimborso si effettua su ricevuta — totale o parziale, è previsto anche il cambio con rivendita. Il turno cassa deve essere aperto.

Nella scheda dell'ordine nella sezione Ordini sono visibili i badge dei rimborsi effettuati con link alla richiesta.

10. Sicurezza#

PCI DSS#

• Cenaly non conserva i dati delle carte — tutto è gestito da Stripe
• Stripe è certificato PCI Level 1 (livello massimo)
• I dati delle carte sono cifrati e tokenizzati

3D Secure#

• Verifica automatica 3D Secure per le carte EU (SCA/PSD2)
• Riduce frodi e chargeback
• Per l'ospite: conferma nell'app della banca

Radar (protezione dalle frodi)#

Stripe Radar blocca automaticamente le transazioni sospette:

• Schema di acquisti insolito
• Carte in blacklist
• Anomalie di geolocalizzazione

11. Test#

Prima di attivare in produzione, testate:

Carte di test Stripe#

CVV: qualsiasi 3 cifre. Data: qualsiasi futura. ZIP: qualsiasi.

Come testare#

1. Al collegamento selezionate l'interruttore «Modalità test» (ogni provider ha il proprio).
2. Usate le chiavi di test (pk_test_..., sk_test_...) — e il webhook creato nella stessa modalità test di Stripe.
3. Effettuate un ordine di test → pagate con una carta di test.
4. Verificate lo stato dell'ordine nella sezione Ordini — deve diventare «Pagato».
5. Quando tutto funziona — ricollegate il provider con le chiavi di produzione in modalità «Produzione».

12. Provider alternativi#

Per i paesi senza Stripe o come integrazione aggiuntiva — già pronti per la connessione:

Altri 94 provider (Adyen, PayTR, ЮKassa, LiqPay, Mercado Pago, Razorpay e altri) sono già presenti nell'elenco, ma visualizzati in grigio — l'integrazione è ancora in fase di test. La panoramica completa è nella sezione Pagamenti.

Connessione di qualsiasi provider: App Store → categoria «Finanza» → scheda del provider → «Configura», oppure tramite il percorso abituale Sedi → scheda della sede → scheda «Pagamenti».

13. Domande frequenti#

Quando riceverò il denaro?#

Entro 2 giorni lavorativi dal pagamento (T+2). Il primo pagamento può richiedere 7–14 giorni (finché Stripe verifica l'account).

L'ospite vuole pagare in contanti — come procedere?#

I metodi «in contanti» e «carta al ritiro» sono sempre disponibili e non richiedono un provider di pagamento — l'ospite li seleziona al checkout e il cassiere effettua il regolamento. In questo caso Stripe non viene utilizzato; la ricevuta viene emessa alla cassa, se è collegato un registratore fiscale (vedi Fiscalizzazione).

È possibile collegare sia Stripe che BOG iPay?#

Sì. Nella scheda «Pagamenti» è possibile attivare più provider contemporaneamente — al checkout l'ospite vedrà un pulsante per ciascuno, contrassegnato dal nome del provider.

Stripe ha bloccato l'account — cosa fare?#

1. Controllate l'email — Stripe invia il motivo
2. Di solito è richiesta una verifica aggiuntiva
3. Contattate Stripe Support: support.stripe.com
4. Durante il blocco è possibile utilizzare un provider alternativo

Come ridurre al minimo la commissione?#

• Incentivate il pagamento con carte EU (1,5% invece del 2,9%)
• Utilizzate SEPA per importi elevati (0,35€ fissi)
• Con un volume d'affari elevato (>100K€/mese) — richiedete a Stripe un piano personalizzato

14. Supporto#

• Stripe: support.stripe.com
• Cenaly: support@cenaly.com → oggetto «Stripe / Pagamento»
• Stripe Status: status.stripe.com (verifica della funzionalità)