Stripe su Lovable: dalla modalità test ai pagamenti veri
Sintesi dell'articoloCome passare Stripe dalla sandbox di prova ai pagamenti veri su un'app fatta con Lovable, senza addebiti per sbaglio.
Di Simone Zucaro, socio e sviluppatore full-stack di nuvola
In breve
Per incassare davvero su Lovable completi l'account Stripe, ricrei prodotti e prezzi in modalità live, inserisci la chiave live con il modulo Update Stripe secret key, fai usare a Lovable gli ID dei prezzi live e provi un acquisto reale sull'app pubblicata.
Nella sandbox di Stripe il pagamento va sempre a buon fine, e l'app sembra pronta. Quando arriva il primo cliente vero, spesso qualcosa si ferma.
Qui trovi i passaggi per portare Stripe ai pagamenti veri su un'app fatta con Lovable.
Perché in test funziona e dal vivo no
Stripe tiene separati l'ambiente di prova, che chiama sandbox, e quello dal vivo, che chiama live. Funzionano in modo simile, e il cambio riguarda soprattutto le chiavi. Quello che hai creato in prova però resta in prova, compresi prodotti, prezzi e coupon.
Una cosa da sapere subito riguarda l'anteprima di Lovable, che non ha un ambiente di prova separato. Con la chiave live inserita, ogni pagamento fatto nell'anteprima addebita davvero la carta.
Prima di cominciare
- Un account Stripe con i dati della tua attività completi. Stripe li chiede prima di farti accettare pagamenti veri, e cambiano in base al paese e al tipo di attività.
- Un backend collegato all'app, cioè Lovable Cloud oppure un tuo progetto Supabase.
- Il login degli utenti, ma solo se vendi abbonamenti.
- Il connettore Stripe abilitato. Sui piani Business ed Enterprise lo trovi in Connectors, sotto Admin settings e App + chat connectors.
Controlla anche che l'app funzioni con la carta di prova 4242 4242 4242 4242, una scadenza futura e un CVC qualsiasi di tre cifre. Se il pagamento non passa nella sandbox, dal vivo andrà peggio.
Come passare ai pagamenti veri, passo per passo
Controlla quale Stripe stai usando
Apri Payments dal menu More del progetto. Se hai collegato il tuo account vedi l'etichetta Self-managed Stripe. I passaggi qui sotto valgono per questo caso.
Completa l'account Stripe
Inserisci i dati dell'attività e il conto su cui ricevere i soldi, seguendo le richieste della dashboard di Stripe.
Ricrea prodotti e prezzi in modalità live
Passa alla modalità live e crea di nuovo ogni prodotto con il suo prezzo. Segnati gli ID dei prezzi, perché ti servono fra poco.
Crea una chiave live limitata
In Stripe apri la pagina API keys in modalità live e crea una chiave con limitazioni, con i soli permessi che servono all'app. Una chiave così inizia con rk_live_. Lovable rifiuta quelle che iniziano con pk_, che sono pubbliche.
Inserisci la chiave nel modulo giusto
Chiedi in chat di aggiornare la chiave e aspetta il modulo Update Stripe secret key. Incolla la chiave solo lì, perché la documentazione di Lovable vieta di scriverla nei messaggi della chat.
Fai usare a Lovable gli ID live
Chiedi di sostituire gli ID dei prezzi di prova con quelli live, elencandoli uno per uno accanto al nome del prodotto.
Prova con un acquisto vero
Sull'app pubblicata compra il prodotto più economico con una tua carta. Controlla che il pagamento compaia in Stripe, poi rimborsalo dalla dashboard.
I webhook, se ti servono
Un webhook è un avviso che Stripe manda alla tua app quando succede qualcosa, per esempio un pagamento riuscito. Di default Lovable non li usa. Ti servono se l'app deve reagire a eventi che arrivano dopo il pagamento.
Chiedi a Lovable la funzione
Fatti creare la funzione che riceve gli avvisi e fatti dare il suo indirizzo.
Crea la destinazione su Stripe
Nella dashboard apri la sezione Webhook, che può trovarsi sotto Developers o in Workbench. Crea una destinazione di eventi con quell'indirizzo e scegli gli eventi, come payment_intent.succeeded.
Copia il segreto di firma
Inizia con whsec_ e serve a verificare che l'avviso arrivi davvero da Stripe. Aggiungilo quando Lovable te lo chiede, e trattalo come una password anche in chat.
La destinazione creata in prova resta in prova, quindi per la modalità live ne serve una nuova. Stripe avverte che gli avvisi possono arrivare in ritardo, doppi o fuori ordine, e la funzione deve reggere tutti e tre i casi.
Gli errori più comuni
Cosa resta fuori dal codice
Incassare davvero vuol dire anche mostrare condizioni di vendita, gestire il recesso quando è previsto ed emettere i documenti fiscali. Sono decisioni da prendere con il commercialista prima del primo incasso, perché lo strumento non le prende per te.
Nuvola non è affiliata a Lovable o Stripe. I nomi appartengono ai rispettivi proprietari e qui servono solo a indicare gli strumenti.