Integrazione WooCommerce

L'integrazione WooCommerce usa la REST API ufficiale di WooCommerce. Funziona con WordPress 6.0+ e WooCommerce 8.0+.

1. Genera le API key in WooCommerce

1. WordPress Admin → WooCommerce → Impostazioni → Avanzate → REST API
2. Clicca "Aggiungi chiave"
3. Descrizione: WooshPayment
4. Permessi: Lettura/Scrittura
5. Salva — copia Consumer Key e Consumer Secret (vengono mostrati una sola volta)

2. Connetti su WooshPayment

1. Dashboard WooshPayment → Integrazioni → WooCommerce
2. Inserisci:
   • URL store: es. https://mio-store.it (senza slash finale)
   • Consumer Key: incolla dal passo 1
   • Consumer Secret: incolla dal passo 1
3. Salva → WooshPayment testa la connessione (deve restituire 200 sul ping di /wp-json/wc/v3/products?per_page=1)

3. Installa il plugin di redirect

WooCommerce non supporta script-tag come Shopify. Devi installare il nostro plugin gratuito:

1. Su WooshPayment → Integrazioni → WooCommerce → Download plugin
2. Scarica woopay-checkout-redirect.zip
3. WordPress Admin → Plugin → Aggiungi nuovo → Carica plugin → seleziona lo zip
4. Attiva
5. Va su Impostazioni → WooshPayment → incolla il tuo slug (es. mio-store)
6. Salva

Il plugin sostituisce il bottone "Procedi al checkout" con un redirect a {slug}.wooshpayment.com.

4. Verifica

1. Apri il tuo store WooCommerce in incognito
2. Aggiungi prodotto → vai al carrello
3. Clicca "Procedi al checkout"
4. Devi atterrare su {tuo-slug}.wooshpayment.com/checkout/...
5. Completa pagamento di test
6. Verifica ordine in WooCommerce → Ordini con stato Elaborazione

Sync degli ordini

Quando il pagamento è confermato:

• WooshPayment crea l'ordine WooCommerce via POST /wp-json/wc/v3/orders
• Stato: processing (configurabile su completed se sei drop-shipper)
• Note ordine: Pagato via WooshPayment (session: ch_xxx)
• Email cliente: mandata da WooshPayment (puoi disabilitare WooCommerce email per non duplicare)

Compatibilità

Plugin	Compatibile
WooCommerce Subscriptions	⚠️ Solo prodotti one-time. Subscription in roadmap.
WooCommerce Bookings	❌ Non supportato
Polylang / WPML	✅
WooCommerce PDF Invoices	✅
WooCommerce Stripe	⚠️ Disabilitalo (WooshPayment usa Whop, non Stripe)

Problemi frequenti

"401 Unauthorized" dopo connect

• Verifica che il sito sia HTTPS (WooshPayment non si connette a HTTP)
• Riapri WooCommerce → Impostazioni → Avanzate → REST API e controlla che la chiave non sia stata revocata

Ordini creati con stato sbagliato

• Vai su WooshPayment → Integrazioni → WooCommerce → Impostazioni avanzate
• Cambia "Stato ordine post-pagamento" da processing a completed (per digital products) o on-hold (per drop-ship)

Prezzi diversi tra WooCommerce e WooshPayment

• Spesso = problema di IVA. WooshPayment rispetta display_prices_including_tax di WooCommerce
• Verifica WooCommerce → Impostazioni → Generale → Tasse

Prossimi step

• Setup Whop pagamenti
• Branding
• Personalizzare email transazionali