Stripe incassa i pagamenti con carta degli ordini online direttamente su un unico account Stripe: quello a cui appartengono le chiavi dell'integrazione, di norma quello del ristorante. Stripe versa poi gli importi sul conto bancario di quell'account. OrderTiger non trattiene alcuna commissione su Stripe; gli eventuali costi di OrderTiger vengono addebitati a parte nelle fatture del ristorante.
Per trattenere una quota di ogni pagamento su Stripe, o per incassare i pagamenti per conto dei ristoranti, usa invece Stripe Connect.
Configurazione#
- In Vista Azienda, apri Finanze → Integrazione Pagamenti e fai clic su + nella scheda Stripe.
- Lascia selezionato Stripe in cima al modulo (non Stripe Connect).
- Compila i campi qui sotto e fai clic su Salva.
- In Vista Punto Vendita, apri Finanze → Metodi di Pagamento, aggiungi o modifica il metodo di pagamento Carta e scegli questa integrazione come processore di pagamento.
| Campo | A cosa serve |
|---|---|
| Nome Identificativo | Un nome a tua scelta per l'integrazione, mostrato negli elenchi e quando la scegli su un metodo di pagamento. |
| Chiave Pubblica | La chiave pubblicabile di Stripe (pk_live_… o pk_test_…), che trovi in Stripe in Sviluppatori → Chiavi API. |
| Chiave Segreta | La chiave segreta di Stripe (sk_live_… o sk_test_…) dello stesso account. È nascosta: fai clic sull'icona a forma di occhio per vederla. |
| Segreto di firma del webhook | Facoltativo. Lascialo vuoto: al salvataggio OrderTiger crea il proprio webhook su questo account Stripe e compila il campo per te. |
| Liquidazione Automatica Pagamenti | Attivo: la carta viene addebitata non appena il cliente paga. Disattivo: l'importo viene solo bloccato sulla carta e addebitato quando l'ordine viene accettato. Nelle sedi che confermano gli ordini in automatico l'addebito è sempre immediato. |
| Abilita Apple Pay / Abilita Google Pay | Offre questi wallet al checkout. Apple Pay richiede anche la verifica del dominio in Stripe. |
| ID Commerciante iOS | L'ID commerciante Apple Pay usato dall'app di ordinazione per iOS. Visibile solo ai super admin. |
Come un ordine con carta risulta pagato#
Quando il cliente paga, l'ordine resta in Carta in attesa finché Stripe non conferma il pagamento. Stripe lo conferma chiamando il webhook di OrderTiger; a quel punto l'ordine risulta pagato e compare in Ordini in diretta.
- Il webhook viene creato automaticamente sull'account Stripe quando salvi l'integrazione, in ascolto dell'evento
charge.succeeded. In Stripe lo trovi in Sviluppatori → Webhook. - Il suo segreto di firma viene salvato in Segreto di firma del webhook. Con un segreto salvato, OrderTiger accetta solo le conferme di pagamento che portano la firma di Stripe. Senza, la conferma viene accettata senza questo controllo.
- Se al salvataggio il webhook esisteva già, viene riutilizzato e il campo resta vuoto: Stripe fornisce il segreto di un webhook solo quando lo crea. Copialo dal webhook in Stripe (Mostra) e incollalo nel campo, oppure elimina il webhook in Stripe e salva di nuovo l'integrazione.
Rimborsi#
I rimborsi si fanno da Ordini, con il pulsante di rimborso sull'ordine. Il rimborso esce dallo stesso account Stripe che ha incassato il pagamento e torna sulla carta del cliente.
- Non c'è nessuna commissione da ripartire: l'intero rimborso esce da quell'account.
- Stripe non restituisce la propria commissione di elaborazione della carta in caso di rimborso.
- Per gli ordini di un'azienda di tipo Portale il modulo di rimborso chiede Il commerciante è responsabile di questo rimborso?. Con Stripe semplice il denaro esce sempre da questo account Stripe; la risposta decide solo come il rimborso appare nelle fatture: un rimborso a carico del commerciante viene detratto dai guadagni del ristorante, uno a carico della piattaforma no.
- Un rimborso può essere parziale; gli importi rimborsati finora sono elencati sotto l'ordine.
Risoluzione dei problemi#
| Problema | Cosa controllare |
|---|---|
| Un ordine pagato resta in Carta in attesa e non arriva mai in Ordini in diretta | La conferma di Stripe non è arrivata. In Stripe, verifica che in Sviluppatori → Webhook ci sia il webhook di OrderTiger e controlla i suoi invii recenti. Se manca, salva di nuovo l'integrazione per crearlo. |
| Segreto di firma del webhook è ancora vuoto dopo il salvataggio | Il webhook esisteva già. Incolla il suo segreto da Stripe, oppure elimina il webhook in Stripe e salva di nuovo. |
| I pagamenti non vanno a buon fine con un errore di autenticazione | Chiave Segreta e Chiave Pubblica devono provenire dallo stesso account Stripe e dalla stessa modalità (entrambe di test o entrambe live). |