Installa il plugin WordPress ufficiale "WooshPayment Checkout" sul tuo store WooCommerce. 2 minuti, zero codice. Intercetta il bottone "Procedi al pagamento" e redirige al checkout brandizzato.

Plugin WooCommerce — installazione 1-click

Il modo più veloce per collegare uno store WooCommerce a WooshPayment: installi il plugin ufficiale, lo attivi, fine. Niente snippet PHP nel theme, niente API key da generare, niente Code Snippets plugin in più.

Alternativa: se non puoi installare plugin sul tuo WP (server bloccato, multisite con restrizioni, ecc.), usa la guida classica via REST API key — leggermente più lunga ma stesso risultato finale.

Tutti gli screenshot di questa guida mostrano l'interfaccia WordPress admin (richiede credenziali admin di un'installazione WordPress che non possiamo includere qui). Sono rendering illustrativi del flusso reale di installazione del plugin.

Prerequisiti

WordPress 6.0+ con WooCommerce 7.0+ attivo
Permalink "Post name" o struttura simile abilitati (WP Admin → Impostazioni → Permalink → tutto tranne "Semplice"). Necessari per la WC Store API che il plugin chiama.
Permesso di installare plugin (ruolo Administrator)
Account WooshPayment con onboarding completato (slug tuo-slug.wooshpayment.com provisionato)

1. Scarica il plugin

Bottone diretto:

⬇ Scarica wooshpayment-checkout.zip

Lo zip è ~5 KB. Contiene un solo file PHP (~120 righe) + readme.txt. Nessuna dipendenza esterna, nessuna libreria di terze parti.

Il plugin è open-source (MIT). Puoi ispezionare il sorgente prima di installarlo: vedi il codice su GitHub (link in arrivo). In sintesi: 119 righe PHP, solo hook wp_enqueue_scripts su pagine cart/checkout, nessuna scrittura su DB, nessuna chiamata di rete dal server WP.

2. Caricalo su WordPress

Step 2.1 — Plugin → Aggiungi nuovo

WordPress Admin: pagina Plugin installati con bottone "Aggiungi nuovo plugin" evidenziato in alto per cominciare l'upload del nostro plugin

Vai su WordPress Admin → Plugin → Aggiungi nuovo plugin (link in alto a destra).

Step 2.2 — Carica plugin (non cercare)

WordPress Admin: pagina "Aggiungi plugin" con la tab "Carica plugin" evidenziata. Annotazione: non cercare nel marketplace, carica direttamente lo zip

In alto trovi due tab: "Cerca plugin" e "Carica plugin". Click Carica plugin — NON cercare nel marketplace.

Step 2.3 — Scegli il file e installa

WordPress Admin: form caricamento plugin con bottone "Scegli file" e wooshpayment-checkout.zip selezionato, bottone "Installa adesso" pronto

Click Scegli file → seleziona wooshpayment-checkout.zip (quello che hai scaricato al passo 1)
Click Installa adesso

Step 2.4 — Attiva il plugin

WordPress Admin: pagina "Installazione plugin in corso" con tre check verdi (Decompressione, Installazione, Plugin installato) + bottone "Attiva plugin" evidenziato in basso

WP decomprime + installa in ~3 secondi. Alla fine compare il bottone Attiva plugin — cliccalo.

Step 2.5 — Vedi il plugin nella lista

WordPress Admin: lista plugin con WooshPayment Checkout in cima, status verde "Attivato", versione 1.0.0. In sidebar Impostazioni → WooshPayment nuovo entry highlighted

Atterri sulla lista plugin con WooshPayment Checkout in cima, status verde Attivato. In sidebar trovi una nuova voce Impostazioni → WooshPayment.

3. Verifica che sia attivo

WordPress Admin: pagina Impostazioni → WooshPayment con 3 card verdi: "Plugin attivo e funzionante", "Store collegato a demo-store.wooshpayment.com", "Ultimo test: 2 minuti fa — checkout intercettato correttamente"

Vai su Impostazioni → WooshPayment (nuova voce nel menu Impostazioni).

Il plugin fa un ping al nostro server e mostra lo stato live:

🟢 Verde "Tutto OK": plugin attivo, store collegato, ultimo checkout intercettato correttamente
🟡 Giallo: plugin attivo ma nessun checkout recente (fai un test reale)
🔴 Rosso "Non connesso": il merchant non ha completato l'onboarding su wooshpayment.com (3 passi per risolvere mostrati nella pagina)

Se vedi il verde, tutto funziona. ✓

Se vedi un avviso "WooCommerce non è attivo", devi prima attivare WooCommerce. Il plugin WooshPayment non fa nulla finché WC non è attivo.

4. Test rapido

Apri il tuo store come visitatore (anche in incognito)
Aggiungi un prodotto al carrello → vai su /carrello/
Click Procedi al pagamento
Aspettative: vieni rediretto a tuo-slug.wooshpayment.com/checkout/... invece della pagina /checkout/ nativa WooCommerce
Il carrello è pre-caricato (prodotti, quantità, prezzi corretti)

Se vedi il checkout brandizzato → tutto funziona. Puoi proseguire con un pagamento di test (carta di test Whop 4242 4242 4242 4242).

Cosa fa il plugin (esattamente)

Solo su pagine carrello e checkout di WC, enqueue lo script wc-checkout-interceptor.js dal nostro CDN
Lo script intercetta il click sul bottone "Procedi al pagamento" e legge il carrello via WC Store API (/wp-json/wc/store/v1/cart)
POST a https://api.wooshpayment.com/api/checkout/create con i prodotti del cart
Riceve un checkoutUrl brandizzato e redirige il customer
Forward dei parametri utm_* per attribution Meta/TikTok/Google
Quando il pagamento va a buon fine su Whop, WooshPayment crea l'ordine reale su WooCommerce via REST (vedi prossimo paragrafo)

Catalogo, ordini, magazzino — tutto resta su WooCommerce

Il plugin non sostituisce WooCommerce. Resta tutto su WC:

Cosa	Dove gestito
Catalogo prodotti	WooCommerce (admin → Prodotti)
Magazzino / stock	WooCommerce
Ordini ricevuti	WooCommerce (admin → Ordini) — creati da WooshPayment via API key
Email transazionali ordine	WooCommerce
Plugin SEO (Yoast, RankMath)	WordPress
Tema / design del catalogo	WordPress / tuo tema
Solo il checkout finale	WooshPayment

Per creare automaticamente l'ordine su WC dopo il pagamento, WooshPayment ha bisogno di una Consumer Key + Consumer Secret della tua WC REST API. Generale una volta sola seguendo la guida WC integration — il plugin da solo non basta, perché lo script JS è solo per il redirect del bottone.

Riepilogo cosa serve per WooCommerce:

Plugin WooshPayment Checkout ← questa guida — intercetta il bottone checkout
Consumer Key + Secret della WC REST API ← guida classica — per ricevere gli ordini sul WC admin

Plugin senza Consumer Key = il checkout funziona ma WooCommerce non riceve gli ordini. Consumer Key senza plugin = WooCommerce riceve gli ordini, ma il bottone checkout porta al checkout nativo WC (no branded).

Servono entrambi.

Disinstallazione

WordPress Admin → Plugin
Trova WooshPayment Checkout → click Disattiva
(Opzionale) Click Elimina per rimuovere completamente

Il checkout WooCommerce nativo torna live immediatamente. Nessuna riga del catalogo / ordini viene toccata. Il plugin non scrive sul DB.

Aggiornamenti

Per ora gli aggiornamenti del plugin sono manuali: scarichi una nuova wooshpayment-checkout.zip, vai su Plugin, disattivi la vecchia, attivi la nuova.

In roadmap: pubblicazione sulla directory ufficiale WordPress.org per aggiornamenti automatici WP. Q3 2026.

Troubleshooting

"Carica plugin" non c'è — vedo solo "Aggiungi nuovo plugin → Cerca plugin"

Alcuni hosting WordPress (es. WordPress.com Business, alcuni managed) hanno disabilitato l'upload di plugin custom. Se è il tuo caso:

Chiedi al provider di abilitare l'upload (di solito è in piano enterprise)
Oppure estrai lo zip, carica i file via SFTP in /wp-content/plugins/wooshpayment-checkout/
Oppure usa la guida via REST API key senza plugin

Plugin attivato ma il bottone checkout non viene intercettato

Apri la console del browser (Cmd/Ctrl+Shift+I) sulla tua pagina carrello e controlla:

C'è una richiesta a https://api.wooshpayment.com/wc-checkout-interceptor.js? Se no → il plugin non sta enqueuando lo script. Verifica che il plugin sia attivo + che WooCommerce sia attivo.
Lo script ritorna 200? Se 403/500 → problema sul nostro lato, apri un ticket.
Console errori? Cerca messaggi [WooshPayment]. Probabili cause:
- fetch /wp-json/wc/store/v1/cart fallisce → WC Store API disabilitata. Vai in WooCommerce → Impostazioni → Avanzate → API legacy e verifica che le REST API siano abilitate.
- POST /api/checkout/create 401 → il tuo store non è ancora collegato su WooshPayment. Completa lo step 9 della guida WC integration (Consumer Key + Secret).

Plugin disattivato per sbaglio

Riattivalo da Plugin → WooshPayment Checkout → Attiva. Nessun re-setup necessario.

Multi-site WordPress

Il plugin funziona su WordPress multisite. Va attivato per ogni sito che ha WooCommerce. Solo i siti dove è attivo + WC presente verranno intercettati.

Prossimi step

Setup completo integrazione WooCommerce — Consumer Key, ordini, webhook
Configura Whop come processore — necessario per accettare carte sul checkout brandizzato
Brand del checkout — logo, colori, font del tuo subdomain

Domande? Apri un ticket o usa la chat in basso a destra del dashboard.