Connessione Stripe
MGX ora supporta la configurazione rapida dei pagamenti Stripe tramite Supabase Edge Functions.
Requisiti
Prima di integrare Stripe, assicurati di avere:
- Un'applicazione MGX funzionante.
- Il progetto MGX è già connesso a un progetto Supabase. (Scopri di più su Supabase.)
- Prodotti creati e prezzi corrispondenti nella tua dashboard Stripe.
Nota: la modalità anteprima non può essere utilizzata per testare la funzionalità di pagamento. Distribuisci la tua app MGX e passa Stripe alla Modalità Test per verificare l'integrazione.
Carta di test:
- Numero della carta:
4242 4242 4242 4242 - Data di scadenza: qualsiasi data futura
- CVC: qualsiasi numero di 3 cifre
Configurazione dei pagamenti Stripe
Collega Supabase
- Fai clic sul pulsante Supabase in alto a destra in MGX
- Segui le Guide Connessione Supabase per selezionare il tuo progetto Supabase di destinazione
- Una volta connesso, puoi configurare le impostazioni di pagamento tramite Supabase
Descrivi i requisiti del tuo abbonamento in linguaggio naturale
- Esempio: crea un sistema di pagamento che supporti tre piani di abbonamento a $4.99 a settimana, $14.99 al mese e $149.99 all'anno.
Dopo l'invio, l'Agente MGX genererà i pulsanti di configurazione. Dovrai compilare almeno due campi.
Fai clic sul pulsante
Add Stripe Secret Key
- Inserisci la tua chiave segreta Stripe nel campo STRIPE_SECRET_KEY.
- Per ogni piano, inserisci il corrispondente ID prezzo Stripe nel campo che termina con PRICE_ID.
Puoi recuperare qui la tua chiave segreta Stripe: https://dashboard.stripe.com/test/apikeys
Vai a Catalogo prodotti > Prodotti, ottieni l'ID prezzo utilizzando uno dei seguenti metodi:
- Nell'elenco "Pricing", fai clic sul pulsante “More” a destra del prezzo corrispondente, quindi fai clic su "Copy Price ID".
Puoi fare clic direttamente sul nome del prezzo per aprire la pagina dei dettagli, quindi copiare l'ID prezzo mostrato nell'angolo in alto a destra.
Infine, incolla accuratamente ogni ID prezzo nel campo di input corrispondente.
Nota: per privacy e sicurezza, non incollare mai direttamente la tua chiave segreta nella chat di MGX. L'esposizione potrebbe consentire l'accesso non autorizzato al tuo account Stripe. Usa invece il pulsante "Add API Key" di MGX per archiviarla in modo sicuro.
Fai clic sul pulsante
Add Stripe Webhook Secret Key
- Inserisci la tua Webhook Secret Key
Come trovare la Webhook Secret Key:
In Stripe, fai clic su “Developers” nell'angolo in basso a sinistra, quindi seleziona l'opzione Webhooks.
Nella pagina Webhooks, fai clic sul pulsante "Add destination".
Seleziona gli eventi webhook che corrispondono alle esigenze del tuo progetto:
checkout.session.async_payment_failedcheckout.session.async_payment_succeededcheckout.session.completedcheckout.session.expired
Dopo aver fatto clic su "Continue", seleziona "Webhook endpoint."
Inserisci l'URL dell'endpoint da Supabase.
Come trovare l'URL del tuo endpoint Supabase:
Fai clic su
View Edge Functionin MGX.
Fai clic per selezionare l'edge function con il suffisso
_webhookcorrispondente.
Nel pannello Details dell'edge function corrispondente, copia l'Endpoint URL e incollalo nella Stripe Event Destination.
Testa la tua Integrazione
Usa la Modalità Test di Stripe per testare i pagamenti.
Dettagli della carta di test:
- Numero della carta: 4242 4242 4242 4242
- Qualsiasi data di scadenza futura
- Qualsiasi CVC di 3 cifre
FAQ
Perché non posso testare i pagamenti in Modalità Anteprima?
La Modalità Anteprima viene eseguita in un ambiente locale, che non fornisce un URL Webhook accessibile pubblicamente. Devi distribuire la tua app per ricevere gli eventi Stripe.
Come faccio a passare alla Modalità Produzione?
Puoi disattivare la Modalità Test nella Dashboard Stripe e usare la tua Secret Key live e il tuo Webhook Secret live.
Come posso verificare se un pagamento di test è andato a buon fine?
Dopo aver completato un pagamento di test, vai alla pagina Payments in Stripe per visualizzare i record della tua transazione di test.