Il modo più semplice: accedi con Stripe
Nessuna chiave da scovare, niente da incollare. Accedi a Stripe, approvi Coin Moebius e torni dopo circa un minuto. Coin Moebius conserva solo l'ID del tuo account Stripe, mai le tue chiavi, e Stripe ci informa nel momento in cui cambia qualcosa sul tuo account.
- Apri Provider e fai clic su Connect a provider
Nella dashboard Coin Moebius, seleziona Provider nel menu a sinistra, quindi fai clic su Connect a provider in alto a destra.
Coin Moebius → Fornitori → Connect a provider - Scegli Stripe
Digita Stripe nella casella di ricerca oppure scorri verso il basso e fai clic su di esso.
Connect a provider → Stripe - Assegnagli un nome, aggiungi le tue due pagine e salva
Assegna un soprannome alla connessione. Inserisci il tuo URL di successo (la pagina che un acquirente vede dopo aver pagato) e il tuo URL di annullamento (la pagina che vede se si ritira). Rimani sulla prima scheda, quindi fai clic su Save and connect with Stripe.
Nickname, URL di successo, URL di annullamento → Save and connect with Stripe Entrambi gli indirizzi devono iniziare con https://. Sono le uniche cose che digiti su questa schermata.
- Approva il Stripe
Stripe si apre. Accedi al tuo account Stripe o creane uno direttamente lì se non ne hai ancora uno, quindi approva Coin Moebius. Stripe mostra quale account stai per utilizzare, quindi puoi verificarlo prima di dire sì.
Stripe → accedi o crea un account → approva Coin Moebius - Sei tornato e sei connesso
Stripe ti rimanda direttamente a Coin Moebius. Un segno di spunta verde significa che i pagamenti con carta sono pronti e la carta Stripe ora si trova nella pagina dei tuoi Fornitori contrassegnata con Verificato e Attivo.
Di nuovo in Coin Moebius: Stripe account collegato Fornitori → la tua carta Stripe: verificata, attiva Hai visto "Azione richiesta" invece del segno di spunta verde? Stripe non ha finito di svuotare il tuo conto per i pagamenti con carta. Completa ciò che Stripe chiede, torna indietro e fai clic su Verify sulla scheda Stripe.
L'altro modo: incolla le tue chiavi
Tutto da qui in giù è il percorso manuale. Configura un webhook nella dashboard Stripe, raccogli tre valori lì e incollali in Coin Moebius. Pianifica circa dieci minuti. Se hai effettuato l'accesso sopra, hai già finito e puoi saltare tutto questo.
Cosa ti serve
| Campo | Cosa fa |
|---|---|
| Publishable key (pk_…) | Chiave pubblica che apre il Checkout nel browser. Non segreta. |
| Secret key (sk_…) | Ci permette di creare la sessione di Checkout così l'addebito passa per il tuo account. Segreta. |
| Webhook signing secret (whsec_…) | Conferma che un webhook provenga davvero da Stripe. Segreta. |
| URL di conferma / URL di annullamento | Dove arriva il cliente dopo aver pagato o essersi tirato indietro. |
Solo il percorso chiave ne ha bisogno. Se hai effettuato l'accesso con Stripe sopra, non c'è nulla da riscuotere. Stripe mantiene chiavi separate per la modalità Test e Live (pk_test_ / sk_test_ contro pk_live_ / sk_live_), ciascuna con il proprio segreto di firma del webhook. Coin Moebius è presente sia nelle schede Live che in quelle Test, quindi puoi verificare le chiavi di prova e aggiungere chiavi live in un secondo momento senza reinserire tutto.
Perché chiediamo ogni campo
Publishable key
Identifica il tuo account quando il checkout si apre nel browser del cliente. Pubblica per natura.
Secret key
La metà privata che autorizza la creazione dell'addebito, così il pagamento passa per il tuo account.
Webhook signing secret
Dimostra che un webhook in arrivo provenga davvero da Stripe, così nessuno può falsificare un evento "pagato". È un valore separato dalla secret key.
URL di conferma e annullamento
Impostazioni semplici: dove arriva il cliente dopo aver pagato o essersi tirato indietro. Non segrete.
Configurazione
- Usa la modalità test (gratuita)
Un account Stripe è gratuito, e la modalità test funziona prima dell'attivazione. Accedi su dashboard.stripe.com e attiva la modalità Test (angolo in alto). Configura prima in test, poi ripeti in live.
- Copia le tue chiavi
Vai su Developers → API keys e copia la Publishable key e la Secret key.
Stripe → Developers → API keys - Aggiungi il webhook
- Developers → Webhooks → Add endpoint.
- Imposta l'URL dell'endpoint sull'indirizzo del webhook del tuo progetto (sotto).
- Seleziona gli eventi. Per pagamenti una tantum: checkout.session.completed, charge.refunded, charge.dispute.created. Se vendi abbonamenti, anche: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Gli eventi extra sono innocui, ignoriamo ciò che non usiamo.
- Copia il Signing secret dell'endpoint (whsec_…). Test e live hanno ciascuno il proprio.
https://api.coinmoebius.com/webhook/stripe/<your project id>Stripe → Developers → Webhooks → Add endpoint - Testa
Le carte di test funzionano solo in modalità test e non addebitano mai una carta reale. Usa una scadenza futura qualsiasi, un CVC qualsiasi, un codice postale qualsiasi.
Risultato Carta Riesce 4242 4242 4242 4242 Richiede autenticazione 4000 0025 0000 3155 Rifiutata 4000 0000 0000 9995 - Collega nella dashboard
Aggiungi provider → Stripe. Inserisci la publishable key, la secret key, il webhook signing secret, l'URL di conferma e l'URL di annullamento. Usa le chiavi di test per verificare il flusso, poi modifica il provider e sostituisci con le chiavi live.
Dopo aver collegato
Effettua un pagamento prima di andare in diretta:
- Hai effettuato l'accesso con Stripe? Il tuo account è attivo, quindi acquista un prodotto da un dollaro con la tua carta e rimborsalo successivamente da Stripe. Chiavi di prova incollate? Ogni pagamento è un pagamento di prova, quindi utilizza una carta di prova dall'alto.
- Crea un prodotto e metti il pulsante di acquisto su una pagina (un file HTML locale va bene) puntato sul tuo progetto.
- Completa il checkout con una carta di test di quelle sopra.
- Apri la scheda Transazioni. Quando lo stato della nuova riga raggiunge succeeded, le tue chiavi e il webhook funzionano entrambi da capo a fondo.
Se hai utilizzato chiavi di prova, modifica il fornitore, scambia le tue chiavi live e riceverai pagamenti reali.
Risoluzione dei problemi
Inizia con Verify. Nella dashboard, fai clic su Verify sulla scheda Stripe. Chiede a Stripe informazioni sul tuo account o controlla le tue chiavi e restituisce un messaggio specifico se qualcosa non va.
Ho effettuato l'accesso con Stripe e ho ricevuto il messaggio "Account collegato. Azione richiesta".
Il tuo account Stripe è collegato ma Stripe non lo ha ancora autorizzato per i pagamenti con carta. Apri Stripe, completa ciò che richiede (solitamente dettagli aziendali o un conto bancario), quindi fai clic su Verify sulla carta Stripe in Coin Moebius.
La scheda Stripe riporta Disconnesso.
Coin Moebius è stato rimosso dal tuo account Stripe, solitamente dalla pagina Applicazioni autorizzate in Stripe. Apri la carta, scegli Edit e fai clic su Reconnect per approvarla nuovamente.
Verifica dice che il formato della chiave è sbagliato.
Le secret key iniziano con sk_test_ o sk_live_ (le chiavi ristrette iniziano con rk_). Il webhook signing secret inizia con whsec_. Ricopia il valore giusto nel campo giusto.
Verifica dice che Stripe ha rifiutato la chiave.
Ricopia la secret key da Developers → API keys, e assicurati di non abbinare una chiave di test a un webhook secret live o viceversa.
Il pagamento si completa ma l'ordine resta in sospeso.
Il webhook non arriva. Conferma che l'URL dell'endpoint corrisponda esattamente, che tu abbia selezionato checkout.session.completed, e che un pagamento di prova stia colpendo il tuo endpoint in modalità test (test e live sono endpoint separati).
La verifica della firma fallisce.
Ogni endpoint Stripe ha il proprio signing secret. Copia il whsec_ dalle impostazioni di questo endpoint, non di un altro.
Conferma da capo a fondo.
Stripe non ha un pulsante di simulazione. Nella dashboard di Stripe, reinvia un evento recente al tuo endpoint, o crea un PaymentIntent di test, poi guarda l'ordine aggiornarsi.
Buono a sapersi
Accesso effettuato con Stripe. Non sono presenti chiavi o segreti webhook da copiare, archiviare o ruotare. Stripe comunica a Coin Moebius quando il tuo account cambia. Per interrompere il collegamento, fare clic su Disconnect sulla scheda Stripe o rimuovere Coin Moebius in Applicazioni autorizzate in Stripe.
Ruotare le chiavi. Hai incollato le tue chiavi? Utilizza la chiave segreta o il segreto del webhook in qualsiasi momento, quindi incolla il nuovo valore. I campi segreti rimangono vuoti durante la modifica in modo da poter inserire una chiave ruotata.
Attivazione. Le chiavi live funzionano solo quando il tuo account è attivato per i pagamenti. Le chiavi di test funzionano subito.
Domande? Join our Discord