WWooshPayment docs
Integrazione store

WooCommerce Subscriptions — stato attuale

WooshPayment supporta i prodotti one-time WooCommerce. Le subscriptions ricorrenti sono in roadmap. Ecco cosa funziona e cosa no oggi.

3 min di lettura

Roadmap Q3. L'integrazione completa con WooCommerce Subscriptions (rinnovi brandizzati, retry da WooshPayment, mapping Woo product → Whop access pass) è in lavorazione. Oggi supportiamo solo il primo pagamento di un subscription product; i rinnovi non passano dal nostro checkout.

TLDR: WooCommerce Subscriptions (plugin a pagamento di Woo) gestisce il primo pagamento via WooshPayment ma i rinnovi automatici non passano dal nostro checkout — vanno direttamente al gateway sottostante (Whop) e il cliente non vede il tuo branding. Sotto trovi i workaround per i casi più comuni.

Cosa funziona ✓

  • Primo pagamento di un prodotto subscription → passa da WooshPayment normalmente, l'ordine parent viene creato in Woo, Whop registra il payment method
  • Trial gratuiti (es. 14 giorni free) — primo pagamento €0.00, attivazione Subscription nel pannello Woo
  • Subscription a pagamento singolo (es. corso 6 mesi pagato upfront) — è di fatto un ordine one-time, funziona al 100%
  • Aggiornamento metodo di pagamento — il cliente clicca "Update payment method" su Woo → atterra su un mini-checkout WooshPayment dove cambia carta

Cosa NON funziona ✗

  • Rinnovi automatici ricorrenti (es. mensile €29) — questi NON passano dal checkout WooshPayment. Whop addebita la card on file e crea un ordine renewal in Woo via webhook diretto. Il cliente non vede il tuo branding.
  • Cambio piano (upgrade/downgrade) — vengono gestiti server-to-server fra Whop e Woo, fuori dal checkout.
  • Failed renewal → retry — anche questo è interno Whop, il cliente riceve mail Whop default (no branding).

Workaround

Workaround 1 — email transazionali brandizzate sui renewal

Anche se il pagamento ricorrente non passa dal checkout, puoi comunque mandare email brandizzate ai clienti quando un renewal avviene:

  1. Dashboard WooshPayment → Webhooks → aggiungi endpoint sul tuo backend Woo
  2. Eventi: subscription.renewed, subscription.failed
  3. Sul tuo backend Woo, ricevi il webhook e manda mail via Resend con il template che preferisci

Esempio Node:

app.post('/webhooks/woopay', (req, res) => {
  const { event, subscriptionId, customer } = req.body
  if (event === 'subscription.renewed') {
    sendBrandedRenewalEmail(customer.email, subscriptionId)
  }
  res.sendStatus(200)
})

Vedi Webhook custom.

Sotto ogni email Whop default puoi forzare un link al tuo dominio dove il cliente atterra in una pagina account brandizzata. In Whop Dashboard → Settings → Email templates → aggiungi footer:

Gestisci il tuo abbonamento su https://tuostore.com/account/subscriptions

Su Woo, la pagina /account/subscriptions è già brandizzata col tema → l'esperienza percepita migliora.

Workaround 3 — Scale plan: payment retry da WooshPayment

A partire dal piano Scale, abbiamo in roadmap un endpoint POST /api/subscriptions/:id/retry che ti permette di triggerare manualmente un retry passando dal nostro checkout brandizzato. ETA: Q3 2026. Se ti serve prima, scrivici — facciamo accesso early per merchant Scale.

Setup consigliato

Per un negozio Woo con subscriptions miste (prodotti one-time + abbonamenti):

  1. Tieni WooCommerce Subscriptions plugin attivo
  2. Connetti WooCommerce a WooshPayment normalmente (vedi Integrazione WooCommerce)
  3. Connetti Whop dal pannello WooshPayment — Whop diventa il gateway
  4. Per ogni prodotto subscription crea su Whop il corrispondente "Access Pass" con frequenza identica (mensile/annuale/etc.)
  5. Mapping prodotti: dashboard WooshPayment → Subscriptions → "Link Woo product to Whop access pass" (UI in arrivo Q2; oggi via API)

Domande frequenti

Posso disabilitare i rinnovi automatici e fare addebiti manuali? Sì. Nel pannello Whop imposta il prodotto come "one-time" e gestisci tu su Woo il flag "Manual renewal". Ogni mese mandi al cliente un link al checkout WooshPayment per il nuovo addebito. Più lavoro ma 100% brandizzato.

Cosa succede ai clienti già subscribed quando passo a WooshPayment? I rinnovi proseguono col gateway precedente (Stripe diretto / PayPal). Nuovi clienti dopo lo switch usano WooshPayment + Whop. Esiste una procedura di migration → contattaci.

Funziona con WooCommerce Memberships? Sì, totalmente. Memberships è un altro plugin (controllo accessi) e non interferisce con il flow di pagamento.