Pagamenti Stripe

1Cosa offre alla tua app#

Permette alle app che generi di incassare denaro vero (paywall, upgrade 'Pro', pulsanti di acquisto) tramite Stripe Checkout.

È il TUO account Stripe: le tue chiavi, il tuo denaro, pagato direttamente a te. AppMint non trattiene commissioni e non ha alcuna responsabilità sui pagamenti (niente Stripe Connect). Colleghi Stripe UNA volta nelle Impostazioni; ogni app che generi lo riutilizza: descrivi solo cosa vendere, senza reinserire le chiavi.

L'AI scrive tutto il codice dei pagamenti. La tua chiave segreta non viene mai inclusa nell'app: resta nel tuo backend Supabase.

2Prima collega Supabase (obbligatorio)#

I pagamenti Stripe richiedono un server sicuro che custodisca la tua chiave segreta e confermi i pagamenti: quel server è il tuo progetto Supabase. Quindi collega e attiva prima Supabase (Impostazioni → BACKEND - SUPABASE): il capitolo '🗄️ Supabase Backend (Connect It Once)' all'inizio di questa guida ti accompagna passo passo.

Se Supabase non è attivo vedrai 'Stripe keys saved, but payments also need Supabase active'. AppMint invia il tuo segreto Stripe alle tue funzioni Supabase in automatico durante la distribuzione: non viene mai inserito nell'app generata.

3Ottieni le tue chiavi Stripe (inizia in modalità test)#

Su un computer:

1. Apri la Stripe Dashboard e resta in modalità test / sandbox mentre sviluppi (Stripe ora chiama l'ambiente di test «sandbox»; i vecchi account mostrano un interruttore Test/Live). Qui non avvengono addebiti reali.
2. Vai su Developers → API keys.
3. Copia la 'Publishable key' (inizia con pk_test_…) e rivela + copia la 'Secret key' (inizia con sk_test_…).

Usa la Secret key standard (sk_…), non una Restricted key (rk_…): AppMint convalida e invia il segreto sk_. Non serve alcuna approvazione come commerciante per creare e provare l'intero flusso prima di attivare i pagamenti live.

Apri le chiavi API di Stripe →

4Collega Stripe in AppMint#

Apri AI Studio → Impostazioni → scorri fino a 'PAYMENTS - STRIPE (OPTIONAL)' → 'CONNECT STRIPE (YOUR ACCOUNT)':

1. Per ora lascia 'Live mode' disattivato (disattivato = Test).
2. Incolla la tua chiave pubblicabile nel campo pk_test_….
3. Incolla la tua chiave segreta nel campo sk_test_… (viene conservata cifrata su questo dispositivo).
4. Attiva 'Enable Stripe payments for generated apps'.
5. Tocca 'Validate & save Stripe keys'. AppMint controlla il formato, verifica che entrambe le chiavi siano della stessa modalità e verifica il segreto con Stripe. Se va a buon fine vedrai '● Connected (TEST)'.

5Cosa configura AppMint per te#

Quando crei un'app con pagamenti, AppMint si occupa in automatico di tutta la parte tecnica: non devi toccare le dashboard di Supabase o Stripe:

• Invia la tua STRIPE_SECRET_KEY alle tue Supabase Edge Functions (cifrata, solo lato server).
• Distribuisce una funzione 'create-checkout' (avvia una sessione Stripe Checkout) e una funzione 'stripe-webhook' (conferma i pagamenti).
• Registra il webhook su Stripe e salva il suo segreto di firma.
• Crea una tabella 'entitlements' così l'app sa chi ha pagato.

La chiave pubblicabile (pk_) è l'unico valore Stripe incluso nell'app: questa chiave può essere pubblica senza rischi.

6Descrivi il tuo paywall: lo crea l'AI#

Di' semplicemente cosa vuoi, in italiano semplice. L'AI aggiunge il pulsante di acquisto, la chiamata al checkout e protegge le funzioni a pagamento per te:

• 'Addebita 5 $ una tantum per sbloccare il tema Pro.'
• 'Un abbonamento da 9 $/mese che rimuove gli annunci.'
• 'Vendi un PDF scaricabile a 19 $.'

Non incolli mai chiavi o prezzi nella chat come configurazione, ma solo l'intento. L'accesso si sblocca solo dopo che Stripe conferma il pagamento tramite webhook, mai da un flag «pagato» lato client, quindi non può essere falsificato.

7Prova un pagamento da capo a fondo#

In modalità Test non si muove denaro reale. Esegui il flusso completo:

1. Apri la tua app e tocca il pulsante di acquisto/upgrade.
2. Nella pagina di Stripe Checkout, paga con la carta di prova:

 4242 4242 4242 4242, any future expiry, any CVC, any ZIP.

1. Torni all'app e la funzione a pagamento si sblocca.
2. Controlla la Stripe Dashboard (modalità Test) → Payments: vedrai l'addebito di prova.

Se si sblocca, il tuo webhook e i diritti di accesso sono configurati correttamente.

4242 4242 4242 4242   exp: any future date   CVC: any 3 digits

8Passa al live quando sei pronto#

1. Attiva il tuo account Stripe per i pagamenti live (Stripe Dashboard → 'Activate' / completa i dati dell'attività).
2. In Stripe, passa dalla sandbox/modalità test alla modalità live e copia le tue chiavi LIVE (pk_live_… e sk_live_…) da Developers → API keys.
3. In AppMint → Impostazioni → Pagamenti: attiva 'Live mode', incolla le chiavi pk_live_/sk_live_ e tocca 'Validate & save'. Il badge diventa '● Connected (LIVE)'.
4. Ricrea la tua app.

AppMint impedisce di mescolare chiavi test e live, e cambiare modalità ripunta il segreto distribuito: test e live non coesistono mai su una stessa app, quindi non puoi pubblicare per sbaglio chiavi di test.

9Se qualcosa non funziona#

• 'Stripe keys saved, but payments also need Supabase active' → attiva prima Supabase (passaggio 2).

• «Hai selezionato TEST ma le chiavi sono LIVE» (o viceversa) → l'interruttore della modalità deve corrispondere al prefisso delle tue chiavi (pk_test/sk_test oppure pk_live/sk_live).

• 'Stripe rejected the key' → la chiave segreta è sbagliata o revocata. Copiala di nuovo da Developers → API keys.

• Il pagamento riesce ma la funzione resta bloccata → il webhook non è arrivato a Supabase. Ricrea/ridistribuisci così AppMint registra di nuovo il webhook e verifica che il progetto Supabase dell'app sia quello che hai collegato.

• Impossibile attivare un account live → Stripe NON accetta commercianti in alcuni paesi (inclusa l'India). La modalità di prova funziona ovunque per sviluppare; per i pagamenti live lì servirebbe un paese supportato da Stripe o un altro provider.