Stripe Connect incassa i pagamenti con carta di un ristorante tramite l'account Stripe della piattaforma, con il ristorante come account connesso. Permette alla piattaforma di trattenere una commissione su ogni pagamento — la commissione dell'applicazione — e di ripartire i rimborsi tra piattaforma e ristorante.
Configurazione#
- Il ristorante collega il proprio account Stripe alla piattaforma. Il suo ID account (
acct_…) compare nella dashboard Stripe della piattaforma in Account connessi. - In Vista Azienda, apri Finanze → Integrazione Pagamenti, fai clic su + nella scheda Stripe e scegli Stripe Connect in cima al modulo.
- Compila i campi qui sotto — le chiavi sono quelle della piattaforma — e fai clic su Salva.
- In Vista Punto Vendita, apri Finanze → Metodi di Pagamento e scegli questa integrazione sul metodo di pagamento Carta.
I primi campi sono gli stessi di Stripe: Nome Identificativo, Chiave Pubblica, Chiave Segreta, Segreto di firma del webhook, Liquidazione Automatica Pagamenti, Abilita Apple Pay, Abilita Google Pay e ID Commerciante iOS. Stripe Connect aggiunge:
| Campo | A cosa serve |
|---|---|
| Tipo di Account | Standard (il ristorante ha un proprio account Stripe completo) o Express (un account più leggero gestito dalla piattaforma). |
| Account Connect | L'ID dell'account connesso del ristorante, acct_…. |
| Tipo di Addebito | Addebiti Diretti o Addebiti di Destinazione — vedi sotto. |
| Commissione Carta | Una percentuale del valore dei prodotti dell'ordine aggiunta alla commissione dell'applicazione, per ribaltare i costi della carta. |
| Commissione Carta Fissa | Un importo fisso aggiunto alla commissione dell'applicazione su ogni pagamento. |
| Sottrarre Costo Consegna, Sottrarre Mancia Autista, Sottrarre Mancia, Sottrarre Costo Servizio | Se attivo, l'intero importo va alla piattaforma: viene aggiunto alla commissione dell'applicazione invece di restare al ristorante. Usalo quando è la piattaforma a gestire la consegna o ad applicare il costo del servizio. |
| Importo Commissione Applicazione Fissa | Un importo fisso aggiunto alla commissione dell'applicazione su ogni pagamento. |
| Commissione Percentuale | La commissione della piattaforma, in percentuale. |
| Regola Commissione | Su cosa si applica la commissione: Totale (l'intero importo pagato dal cliente), oppure una qualsiasi combinazione di Subtotale (i prodotti), Costo Servizio, Costo Consegna, Mancia, Tasse e Mancia Autista. |
Addebiti diretti e addebiti di destinazione#
| Addebiti Diretti | Addebiti di Destinazione | |
|---|---|---|
| Dove viene effettuato il pagamento | Sull'account connesso del ristorante | Sull'account della piattaforma, poi girato al ristorante |
| Nome sull'estratto conto della carta del cliente | Quello del ristorante | Quello del ristorante |
| Chi paga la commissione di elaborazione della carta di Stripe | Il ristorante | La piattaforma |
| Come viene pagata la piattaforma | La commissione dell'applicazione viene trasferita dal ristorante alla piattaforma | La piattaforma trattiene la commissione dell'applicazione e gira il resto |
| Chi vede il pagamento in Stripe | Il ristorante per intero; la piattaforma vede la propria commissione | La piattaforma per intero; il ristorante vede l'importo girato |
| Uso tipico | Account Standard: ristoranti con una propria attività su Stripe | Account Express: la piattaforma gestisce i pagamenti per il ristorante |
La commissione dell'applicazione#
La commissione dell'applicazione viene calcolata per ogni ordine al momento del pagamento ed è la somma di:
- Commissione Percentuale × ciò che copre la Regola Commissione;
- Commissione Carta × il valore dei prodotti dell'ordine;
- Commissione Carta Fissa e Importo Commissione Applicazione Fissa;
- ogni importo il cui interruttore Sottrarre … è attivo (costo di consegna, mancia autista, mancia, costo del servizio).
Subtotale è il valore dei prodotti al netto degli sconti quando il piano di utilizzo della sede applica la commissione dopo gli sconti (l'impostazione abituale), altrimenti al lordo.
Esempio. Un ordine con una lasagna ($32,00, scontata a $22,40) e tre tiramisù ($42,00), con $5,72 di imposta sulle vendite e $11,10 di mancia, costa al cliente $81,22. Con una Commissione Percentuale di 8 su Subtotale e nient'altro impostato, la commissione dell'applicazione è 8% × $64,40 = $5,15. Su tasse e mancia non si applica commissione.
Come un ordine con carta risulta pagato#
Come con Stripe, l'ordine resta in Carta in attesa finché Stripe non conferma il pagamento tramite il webhook di OrderTiger. Per Stripe Connect il webhook viene creato sull'account Stripe della piattaforma con Eventi da: Account connessi, così riceve i pagamenti effettuati sugli account dei ristoranti. Il suo segreto di firma viene salvato in Segreto di firma del webhook al momento della creazione.
Rimborsi#
I rimborsi si fanno da Ordini, con il pulsante di rimborso sull'ordine. Per un ordine pagato con Stripe Connect, il modulo di rimborso chiede Il commerciante è responsabile di questo rimborso? — selezionato per impostazione predefinita. La risposta decide chi paga il rimborso.
| A carico del commerciante (selezionato) | A carico della piattaforma (non selezionato) | |
|---|---|---|
| Cliente | Riceve indietro l'importo rimborsato | Riceve indietro l'importo rimborsato |
| Ristorante | Paga il rimborso, comprese le commissioni di elaborazione della carta di Stripe | Trattiene l'importo originale meno la commissione dell'applicazione originale, come se l'ordine non fosse stato rimborsato. Con gli addebiti diretti paga comunque la commissione di elaborazione della carta di Stripe, come su qualsiasi vendita |
| Piattaforma | Restituisce la propria quota della commissione dell'applicazione | Paga l'intero rimborso e trattiene la propria commissione dell'applicazione |
| Fatture | Il rimborso è incluso e detratto dai guadagni del ristorante | Il rimborso non è incluso: l'ha già pagato la piattaforma |
Per un rimborso a carico del commerciante, la quota della commissione dell'applicazione della piattaforma è la commissione dell'applicazione × il rimborso ÷ il totale dell'ordine; un rimborso totale restituisce l'intera commissione dell'applicazione. Un rimborso a carico della piattaforma lascia invariata la commissione dell'applicazione.
Esempio — l'ordine da $81,22 qui sopra, con la sua commissione dell'applicazione di $5,15. Per semplicità la commissione di elaborazione della carta di Stripe non è considerata.
| Rimborso della lasagna ($22,40) | Rimborso dell'intero ordine ($81,22) | |
|---|---|---|
| A carico del commerciante: quota della commissione dell'applicazione restituita | $5,15 × 22,40 ÷ 81,22 = $1,42 | $5,15 |
| A carico del commerciante: al ristorante restano | $76,07 − $22,40 + $1,42 = $55,09 | $0,00 |
| A carico del commerciante: alla piattaforma restano | $5,15 − $1,42 = $3,73 | $0,00 |
| A carico della piattaforma: al ristorante restano | $81,22 − $5,15 = $76,07 | $81,22 − $5,15 = $76,07 |
| A carico della piattaforma: alla piattaforma restano | $5,15 − $22,40 = −$17,25 | $5,15 − $81,22 = −$76,07 |
Senza alcun rimborso al ristorante sarebbero rimasti $81,22 − $5,15 = $76,07 e alla piattaforma $5,15.
Risoluzione dei problemi#
| Problema | Cosa controllare |
|---|---|
| Un ordine pagato resta in Carta in attesa | Nella dashboard Stripe della piattaforma, verifica che in Sviluppatori → Webhook ci sia il webhook di OrderTiger con Eventi da: Account connessi e controlla i suoi invii recenti. |
| La commissione dell'applicazione non è quella che ti aspettavi | Controlla le caselle di Regola Commissione: Totale applica la commissione su tutto ciò che paga il cliente, tasse e mancia comprese. |
| I pagamenti non vanno a buon fine con un errore sull'account | Account Connect deve essere un account connesso dell'account della piattaforma a cui appartengono le chiavi, nella stessa modalità (test o live). |