WWooshPayment docs
Risoluzione problemi

Shopify si è disconnesso

Dashboard mostra "Shopify non connesso" o gli ordini non vengono creati su Shopify. Procedura di re-OAuth in 2 minuti.

3 min di lettura

TLDR: il token OAuth Shopify può scadere o essere revocato (cambio password store, app disinstallata). Riconnetti dalla pagina Impostazioni in 2 minuti.

Sintomi

  • Dashboard → Impostazioni → "Connessione Shopify" mostra stato "Non connesso"
  • OnboardingBanner sopra al dashboard dice che lo Shopify non è collegato
  • Ordini WooshPayment marcati COMPLETED ma su Shopify Admin non appaiono
  • API call verso Shopify rigettate con 401

Caso "subito dopo OAuth"

Se hai appena completato l'OAuth ma sidebar/Impostazioni dicono "Non connesso":

Causa: la dashboard ha cachato in localStorage il vecchio merchant snapshot (pre-OAuth). Lo store è già aggiornato in DB ma il client non lo sa ancora.

Fix: Cmd+Shift+R (hard refresh). La store Zustand chiama refreshMerchant() al mount e recupera lo stato corretto da /api/merchant/me.

Questo bug è stato risolto: la dashboard ora chiama refreshMerchant() ad ogni mount del segment /dashboard/*. Se lo vedi ancora, è cache stale del browser → hard refresh basta.

Cause vere di disconnessione

CausaFrequenza
Merchant ha disinstallato l'app da Shopify AdminComune
Cambio password proprietario store ShopifyFrequente
Owner store ha revocato accesso da Settings → AppsFrequente
Shopify ha invalidato il token per securityRara

Procedura re-OAuth

  1. WooshPayment Dashboard → Impostazioni → Connessione Shopify
  2. Stato mostra "Non connesso"
  3. Inserisci il tuo tuo-store.myshopify.com (lo trovi in Shopify Admin → Impostazioni → Domini)
  4. Click "Avvia OAuth"
  5. Vieni reindirizzato su Shopify Admin con prompt OAuth (scope: read_products, write_orders, read_customers, write_script_tags, ecc.)
  6. Installa app
  7. Atterri di nuovo su WooshPayment con stato "Connesso"
  8. Lo ScriptTag viene reinstallato automaticamente

Tempo medio: 2 minuti.

Cosa succede agli ordini sospesi

Se durante il periodo di disconnessione hai ordini pagati su WooshPayment ma non sincronizzati su Shopify (shopifyOrderId: null), non c'è ancora un cron di backfill automatico.

Per ora: scrivici a noreply@wooshpayment.com con la lista degli ordini interessati e li sincronizziamo manualmente. Roadmap: bottone "Sync ordini pendenti" merchant-facing.

Verifica post-riconnessione

  1. Crea un ordine di test (€0,50) dal tuo store
  2. Verifica che appaia in Shopify Admin → Ordini entro 1 minuto
  3. Verifica che WooshPayment Dashboard → Ordini lo mostri COMPLETED con shopifyOrderId popolato

Prevenzione

Non disinstallare l'app a caso

Se devi solo aggiornare scope o riconnettere, parti dalla nostra dashboard (Impostazioni → Connessione Shopify → "Riavvia OAuth"). Disinstallare dall'admin Shopify revoca tutto e dovrai ricominciare.

Notifica al cambio password

Cambiando password dell'owner Shopify, l'access token NON viene revocato automaticamente per design, ma Shopify a volte invalida i token per anti-abuse. Se vedi un improvviso 401 dai webhook Shopify, è probabile sia successo questo.

Webhook Shopify app/uninstalled

Quando un merchant disinstalla WooshPayment da Shopify Admin, riceviamo app/uninstalled webhook su https://api.wooshpayment.com/webhooks/shopify/app-uninstalled. A quel punto marchiamo shopifyConnected: false. Se vuoi rientrare, riavvia l'OAuth.

Troubleshooting

Re-OAuth dice "Invalid shop"

Hai inserito un dominio Shopify che non esiste o è scritto male. Formato corretto: nome-negozio.myshopify.com, non nome-negozio.com.

Re-OAuth dice "App already installed"

Apri Shopify Admin → Apps → WooshPayment → verifica che sia veramente installata. Se sì, basta che tu autorizzi di nuovo da lì (link "Open app"). Se l'OAuth flow nostro fallisce con questo errore, è probabile che lo handoff token JWT sia scaduto: prova a fare logout/login su WooshPayment prima di riavviare l'OAuth.

Dopo re-OAuth, ordini ancora non sincronizzano

  • Aspetta 1-2 minuti (alcuni client cachano)
  • Verifica in dashboard che ordine sia COMPLETED e non PENDING
  • Se ancora fallisce → scrivici con session token

Equivalente WooCommerce

Per Woo, "disconnessione" significa:

  • Consumer key/secret REST API revocati su Woo
  • WordPress site URL cambiato
  • HTTPS scaduto sul tuo dominio Woo

Procedura: Impostazioni → Piattaforma e-commerce → scegli WooCommerce → re-inserisci credenziali consumer key/secret.