Il collegamento a Stripe permette di offrire pagamenti nel proprio ecommerce, ma la configurazione è completa soltanto quando incasso, ordine e conferme corrispondono. Questa guida aiuta a preparare l’account, scegliere le impostazioni dell’estensione e provare il percorso che useranno clienti e personale del negozio.
Indice della guida
Prepara account, negozio e accessi
Individua l’account Stripe della tua attività e chi può amministrarlo. Completa le richieste presenti nel servizio prima di considerare il negozio pronto. La documentazione di collegamento distingue i problemi dell’estensione da quelli di verifica dell’account, che vanno gestiti con Stripe. Un’installazione riuscita non risolve automaticamente una limitazione dell’account.
Controlla HTTPS, versioni di WooCommerce e WordPress, tema e personalizzazioni della cassa. Prepara una copia di prova e annota i metodi di pagamento già presenti. WooPayments e Stripe per WooCommerce sono integrazioni distinte: verifica il nome del plugin prima di seguire una procedura o sostituire il sistema esistente.
Se ci sono abbonamenti attivi, carte salvate o pagamenti autorizzati da acquisire, pianifica il passaggio con l’assistenza. Collegare un nuovo plugin non significa trasferire automaticamente tutte le operazioni e i rapporti di pagamento precedenti.
Collega l’estensione all’account corretto
Prendi come riferimento l’estensione Stripe documentata da WooCommerce. Verifica la provenienza del plugin, installalo nella configurazione di prova e apri WooCommerce → Impostazioni → Pagamenti. Avvia la configurazione Stripe e segui la procedura per creare o collegare l’account.
- Controlla il nome dell’attività e l’account selezionato durante l’autorizzazione.
- Completa il percorso sul servizio Stripe e torna al pannello del negozio.
- Leggi gli stati relativi a pagamenti, accrediti, webhook e sincronizzazione.
- Prepara il collegamento dell’ambiente di test e verifica quale modalità è attiva.
Le etichette dipendono dalla versione dell’estensione. Se l’account è già associato ad altre piattaforme, leggi le indicazioni mostrate prima di scollegarlo: potresti interrompere un’integrazione operativa. Conserva le credenziali nei sistemi previsti e non inserirle nelle note degli ordini o negli screenshot inviati per assistenza.
Scegli i metodi e prova la cassa effettiva
La guida alle impostazioni distingue metodi di pagamento e opzioni generali dell’estensione. Abilita ciò che è utile al tuo negozio e disponibile per account, paese e valuta. La presenza di Stripe non implica che ogni metodo sia mostrato a tutti i clienti.
Controlla come i campi si inseriscono nella tua pagina di pagamento. La documentazione sull’esperienza di checkout presenta diverse configurazioni: tema, tipo di cassa ed estensioni possono influenzare il risultato. Prova il percorso da smartphone senza essere autenticato come amministratore.
Parti dalle carte e completa un ordine rappresentativo. Per Apple Pay e Google Pay su WooCommerce servono ulteriori controlli di disponibilità e compatibilità. Nei prodotti personalizzati verifica che il pagamento rapido non lasci il negozio senza le informazioni necessarie alla lavorazione.
Simula acquisti riusciti, rifiuti e autenticazione
Attiva la modalità di prova seguendo la guida ai test dell’estensione. Usa i dati di pagamento di test forniti dalla documentazione, dopo aver verificato l’ambiente selezionato. Non usare carte reali per simulare esiti nell’ambiente di prova e non lasciare attivo il test sul negozio che deve ricevere vendite.
La prova non termina con il messaggio nel browser. Per ogni caso annota numero d’ordine, importo, esito atteso ed esito osservato. Questa checklist può essere usata insieme a chi gestisce il negozio:
- Pagamento riuscito: totale corretto, transazione associata e conferma dell’ordine.
- Pagamento rifiutato: messaggio comprensibile e possibilità di riprovare senza ordini o addebiti duplicati.
- Autenticazione richiesta: completamento o interruzione del passaggio aggiuntivo e stato coerente nel negozio.
- Carrello completo: variante, coupon, consegna e importo finale corretti.
- Comunicazioni: email ricevute e informazioni sufficienti per la preparazione della merce.
Esempio ipotetico: un prodotto da 48 euro con 6 euro di spedizione e 5 euro di sconto deve produrre un totale di 49 euro. Se il pagamento è corretto ma manca soltanto l’email, verifica il percorso delle conferme WooCommerce non ricevute.
Verifica come Stripe comunica l’esito al negozio
I webhook sono notifiche con cui Stripe invia eventi al sito. La documentazione dell’estensione indica che nelle versioni moderne vengono configurati durante il collegamento. Controlla gli stati nelle sezioni Live e Test: ciascun ambiente deve avere una configurazione coerente.
Se il browser del cliente si chiude prima della pagina finale, il negozio deve comunque poter ricevere e gestire la comunicazione del pagamento. Dopo cambi di dominio, hosting o protezioni, verifica che questi messaggi raggiungano il sito. Un tecnico può confrontare registri del plugin, eventi e riferimenti della transazione senza affidarsi soltanto alla schermata mostrata al cliente.
Non creare notifiche aggiuntive o eliminare collegamenti alla cieca. Prima identifica quali endpoint appartengono al negozio e quali ad altri servizi. Nel caso di un ordine dubbio, cerca la transazione già esistente prima di chiedere al cliente di pagare nuovamente.
Distingui pagamento, stato dell’ordine e accredito
Una transazione riuscita, la preparazione dell’ordine e il trasferimento dei fondi al conto bancario sono passaggi differenti. Se il pagamento è stato soltanto autorizzato, occorre valutarne l’acquisizione secondo la configurazione scelta. Leggi lo stato effettivo della transazione, non soltanto il nome assegnato all’ordine nel sito.
La guida agli stati degli ordini spiega come Stripe interagisce con WooCommerce. Un ordine in lavorazione può essere coerente con un pagamento acquisito e merce ancora da spedire. Non cambiare lo stato a “Completato” come tentativo di risolvere un problema di comunicazione.
Per controllare una vendita usa numero d’ordine, riferimento della transazione, importo e valuta. Se manca l’accredito sul conto, controlla separatamente lo stato e la programmazione degli accrediti in Stripe. Se invece il cliente non riesce a pagare, parti dalla guida ai pagamenti WooCommerce non riusciti e dal codice d’errore registrato.
Verifica il rimborso e la sua registrazione
L’estensione può avviare il rimborso dall’ordine WooCommerce. La procedura ufficiale dei rimborsi Stripe distingue i pagamenti acquisiti dalle sole autorizzazioni: se la somma non è stata acquisita, va gestita l’autorizzazione secondo il percorso previsto, non un rimborso di denaro già incassato.
Prima di confermare, controlla ordine, importo e operazione già eseguita. Un cambio manuale dello stato o una registrazione manuale del rimborso non dimostrano che il denaro sia stato restituito. Verifica l’esito nel gateway e conserva il riferimento per evitare di avviare una seconda operazione.
Gestisci separatamente rientro del prodotto e disponibilità di magazzino: un rimborso economico non implica sempre che la merce sia tornata vendibile. La guida a resi e rimborsi WooCommerce aiuta a organizzare questo passaggio con il personale.
Controlla la configurazione reale prima dell’apertura
Quando il collaudo è concluso, verifica account reale, modalità attiva, metodi abilitati e comunicazioni dell’ambiente operativo. Un test riuscito non conferma da solo la configurazione Live. Controlla inoltre che le copie di sviluppo non inviino ordini o messaggi ai sistemi usati dai clienti.
Se concordi una verifica con pagamento reale, considera che genera una transazione effettiva, soggetta alle condizioni del servizio. Comunica chiaramente chi la esegue e come verrà gestito l’eventuale rimborso. Le tariffe e i tempi applicabili vanno verificati nel proprio account e nelle condizioni Stripe.
Consegna a chi gestisce il negozio una procedura breve: come riconoscere un ordine pagato, dove cercare il riferimento Stripe e chi contattare per un’anomalia. Per un intervento di assistenza sono utili versione del plugin, momento dell’errore e numero d’ordine; non servono dati completi della carta del cliente.
Domande frequenti
Stripe e WooPayments sono lo stesso plugin?
No. Sono integrazioni distinte, con impostazioni e percorsi di gestione propri. Controlla quale estensione è installata e pianifica il passaggio se esistono ordini, carte salvate o abbonamenti da gestire.
Posso provare Stripe senza un pagamento reale?
Sì. L’estensione offre una modalità di test da usare con i dati di prova previsti da Stripe. Controlla l’ambiente e verifica anche transazioni rifiutate, autenticazione e registrazione degli ordini.
Devo configurare manualmente i webhook?
Le versioni moderne dell’estensione li configurano durante il collegamento. Verifica comunque gli stati di Live e Test e segui la documentazione per correggere eventuali problemi senza aggiungere endpoint duplicati.
Un ordine in lavorazione significa che il pagamento è fallito?
No. Può indicare un ordine pagato per cui occorre preparare o spedire la merce. Confronta stato della transazione Stripe, importo e note dell’ordine prima di intervenire.
Basta cambiare lo stato in Rimborsato per restituire il denaro?
No. Il rimborso deve essere avviato tramite il percorso del gateway e verificato nel suo esito. La sola modifica manuale dello stato non restituisce denaro al cliente.