Integrazione WooCommerce
Connetti uno store WooCommerce a WooshPayment via REST API. Funziona con WordPress 6.0+ e WooCommerce 8.0+.
L'integrazione WooCommerce usa la REST API ufficiale. Funziona con WordPress 6.0+ e WooCommerce 8.0+. Lo store deve essere su HTTPS.
Setup consigliato WooCommerce ⚡ — Servono due pezzi:
- Plugin WordPress ufficiale per intercettare il bottone "Procedi al pagamento" senza toccare il theme.
- Consumer Key + Consumer Secret REST API per creare l'ordine reale su WooCommerce dopo il pagamento.
Questa pagina copre le chiavi REST API. Per il plugin: Vedi installazione plugin.
Gli step lato WordPress / WooCommerce admin mostrano rendering illustrativi (servirebbero credenziali admin di un'installazione WordPress che non possiamo includere qui). Lo step 2 è uno screenshot reale della Dashboard WooshPayment.
1. Genera le API key in WooCommerce
- WordPress Admin → WooCommerce → Impostazioni → Avanzate → REST API
- "Aggiungi chiave"
- Descrizione:
WooshPayment - Permessi: Lettura/Scrittura (
Read/Write) - Salva — copia Consumer Key e Consumer Secret (mostrati una sola volta)
Conserva le chiavi in un password manager. Se le perdi, devi rigenerarle e WooshPayment smetterà di creare ordini fino al re-input.
2. Connetti su WooshPayment
- Dashboard → Integrazioni → WooCommerce (oppure onboarding step "Piattaforma" se sei al primo setup)
- Sezione "WooCommerce" → compila:
- URL store: es.
https://mio-store.it(senza slash finale) - Consumer Key: incolla
- Consumer Secret: incolla
- URL store: es.
- Click Collega WooCommerce → WooshPayment fa un ping su
/wp-json/wc/v3/products?per_page=1per validare le chiavi
Le credenziali sono cifrate at rest (AES-256-GCM).
3. Redirect del bottone checkout
Per intercettare il bottone checkout WooCommerce usa il plugin WordPress ufficiale. Il plugin legge il carrello reale via WC Store API, normalizza prezzi/valuta/coupon, conserva prodotti e varianti, e redirige a {slug}.wooshpayment.com.
Le REST API key da sole servono a creare l'ordine su WooCommerce dopo il pagamento, ma non intercettano il bottone checkout. Per il prodotto pubblico WooshPayment il redirect WooCommerce supportato è il plugin ufficiale. Se il tuo hosting non permette plugin custom, contatta il supporto prima del lancio: serve una integrazione custom validata caso per caso.
4. Verifica
- Apri lo store in incognito
- Aggiungi prodotto → vai al carrello
- Clicca "Procedi al checkout"
- Dopo plugin attivo, REST keys valide, piano attivo e Whop/COD pronto, devi atterrare su
{tuo-slug}.wooshpayment.com/checkout/... - Completa pagamento di test
- Verifica ordine in WooCommerce → Ordini con stato
Elaborazione - Verifica anche email cliente/merchant, evento pixel/CAPI e ordine in Dashboard → Ordini prima di mandare traffico
Sync degli ordini
A pagamento confermato chiamiamo POST /wp-json/wc/v3/orders:
- Stato di default:
processing(configurabile) - Note ordine:
Pagato via WooshPayment (session: ch_xxx) payment_method:woopay(oppurecodse contrassegno)- Email cliente: WooshPayment manda la conferma ordine brandizzata; eventuali email WooCommerce dipendono dalle impostazioni/plugin del tuo store
Compatibilità
| Plugin | Compatibile |
|---|---|
| WooCommerce Subscriptions | Solo prodotti one-time. Subscription in roadmap. |
| WooCommerce Bookings | Non supportato |
| Polylang / WPML | Sì |
| WooCommerce PDF Invoices | Sì |
| WooCommerce Stripe | Disabilita: WooshPayment usa Whop, non Stripe |
Problemi frequenti
"401 Unauthorized" dopo connect
- Verifica che il sito sia HTTPS — non ci connettiamo a HTTP
- Riapri WooCommerce → REST API e controlla che la chiave non sia stata revocata
- Verifica che il permesso sia "Lettura/Scrittura (
Read/Write)" (non solo "Lettura")
Prezzi diversi tra WooCommerce e WooshPayment
Spesso è problema di IVA. WooshPayment rispetta display_prices_including_tax di WooCommerce. Verifica in WooCommerce → Impostazioni → Generale → Tasse.
"Carrello non valido" lato cliente
I prezzi sono cambiati fra add-to-cart e checkout. Il cliente refresha il carrello e riprova.