WWooshPayment docs
Risoluzione problemi

Shopify si è disconnesso

Dashboard mostra "Shopify non connesso" o gli ordini non vengono creati su Shopify. Procedura guidata di re-OAuth e verifica post-riconnessione.

3 min di lettura

TLDR: il token OAuth Shopify può scadere o essere revocato (cambio password store, app disinstallata). Riconnetti dalla pagina Impostazioni, poi fai un test reale dal carrello e verifica l'ordine store.

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

Dopo la riconnessione, ripeti comunque il test reale dal carrello prima del traffico.

Cosa succede agli ordini sospesi

Se durante il periodo di disconnessione hai ordini pagati su WooshPayment ma non sincronizzati su Shopify (manca l'Ordine store in dashboard), WooshPayment prova il recupero automatico con il cron di riconciliazione: legge lo stato pagamento da Whop, riusa la chiave idempotente della sessione e ritenta la creazione dell'ordine store senza creare duplicati.

Per sessioni ancora PENDING o PROCESSING, apri Dashboard → Ordini → ordine e usa Verifica pagamento: il backend interroga Whop direttamente e, se trova un pagamento riuscito, aggiorna lo stato. Se l'ordine resta COMPLETED senza Ordine store dopo riconnessione e dopo il prossimo giro di reconcile, mandaci il session token: serve controllare l'errore Shopify/Woo specifico.

Verifica post-riconnessione

  1. Crea un ordine di test (€0,50) dal tuo store
  2. Verifica che appaia in Shopify Admin → Ordini dopo la conferma Whop e il sync ordine store WooshPayment
  3. Verifica che WooshPayment Dashboard → Ordini lo mostri COMPLETED con Ordine store valorizzato

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 brevemente l'elaborazione webhook/sync ordine
  • 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: Dashboard → Integrazioni → WooCommerce → re-inserisci URL store, Consumer Key e Consumer Secret. In alternativa puoi rifarlo dallo step "Piattaforma" dell'onboarding se stai ripartendo da zero.