WWooshPayment docs
Integrazione store

Integrazione Shopify

Connetti il tuo store Shopify a WooshPayment, installa lo script di redirect e mappa il dominio.

2 min di lettura

L'integrazione Shopify usa OAuth per leggere il catalogo e creare ordini, e uno script tag per redirigere il bottone "Checkout" al tuo dominio WooshPayment.

Requisiti

  • Store Shopify attivo (qualsiasi piano, anche Basic $29/mese)
  • Permessi di Admin sullo store
  • Account WooshPayment creato (vedi Quickstart)

1. Avvia l'integrazione

  1. Dalla dashboard WooshPayment vai su Integrazioni → Shopify
  2. Clicca "Connetti Shopify"
  3. Inserisci il tuo myShopName.myshopify.com (puoi trovarlo in Shopify Admin → impostazioni → domini)
  4. Verrai reindirizzato su Shopify per autorizzare WooshPayment

2. Autorizza i permessi

WooshPayment richiede questi scope:

ScopeCosa fa
read_productsLegge titoli, prezzi, varianti del catalogo
write_ordersCrea l'ordine su Shopify dopo pagamento confermato
read_customersAuto-fill indirizzo per clienti registrati
write_script_tagsInstalla lo script di redirect del bottone Checkout

Clicca "Installa app" in Shopify. Sarai rimandato su WooshPayment con connessione confermata.

Nessun permesso write_products né write_customers: WooshPayment legge ma non modifica mai il tuo catalogo né i tuoi clienti.

3. Lo script di redirect

Una volta autorizzato, WooshPayment installa automaticamente un piccolo script (~3KB) sul tuo store.

Quando un cliente clicca "Checkout" dal carrello Shopify, lo script:

  1. Cattura il carrello (line items + totale + currency)
  2. Crea una sessione WooshPayment tramite POST /api/checkout/create
  3. Redirige a https://{tuo-slug}.wooshpayment.com/checkout/{token}

Lo script è sicuro: nessun dato cliente viene tracciato fino al checkout WooshPayment.

4. Verifica funzionamento

  1. Apri il tuo store Shopify in incognito
  2. Aggiungi un prodotto al carrello
  3. Clicca "Check out"
  4. Devi atterrare su {tuo-slug}.wooshpayment.com/checkout/...
  5. Completa un ordine di test (carta Whop test 4242 4242 4242 4242)
  6. Verifica che l'ordine appaia anche su Shopify Admin → Ordini con tag WooshPayment

5. Cosa succede dopo pagamento

Quando il pagamento è confermato da Whop:

  1. Ordine Shopify creato con stato paid
  2. Inventario decrementato secondo le linee acquistate
  3. Cliente Shopify creato/aggiornato (se opt-in marketing)
  4. Email di conferma mandata da WooshPayment (puoi disabilitare se preferisci le email Shopify native)
  5. Tag "WooshPayment" + nota con l'ID sessione e link al super admin

Errori comuni

Script tag non installato

Se vedi cliente atterrare sul checkout Shopify standard invece che WooshPayment:

  • Vai su Shopify Admin → App → WooshPayment → Disinstalla
  • Torna su WooshPayment, riconnetti
  • Ricarica lo store con Cmd+Shift+R

Ordini non sincronizzati

Se l'ordine appare in WooshPayment ma non in Shopify:

  • Vai su /super-admin/sessions → trova la sessione
  • Clicca "Verifica pagamento" per forzare il sync
  • Se persiste, controlla che lo scope write_orders sia ancora attivo

"Carrello non valido"

Cliente vede errore in checkout WooshPayment:

  • Probabilmente i prezzi del prodotto sono cambiati tra add-to-cart e checkout
  • Cliente deve refresh-are il carrello e riprovare
  • Per evitare: usa "Prezzo bloccato 30 minuti" su Shopify

Disinstallare

  1. Shopify Admin → App → WooshPayment → Disinstalla: revoca i permessi, l'app non funziona più
  2. Lo script tag viene rimosso automaticamente
  3. I dati WooshPayment rimangono per 30 giorni (puoi richiedere cancellazione immediata via GDPR)

Prossimi step