Troubleshooting checkout live
Come leggere il monitor checkout live e distinguere abbandoni normali da problemi tecnici SDK, iframe, webhook o integrazione store.
Il monitor Checkout live serve per capire cosa sta succedendo mentre il traffico arriva: utenti sul prodotto, utenti sul checkout, tentativi di pagamento, ordini completati e possibili problemi tecnici.
Non ogni checkout senza ordine e' un bug. Molti clienti abbandonano per scelta, carta rifiutata, wallet chiuso, prezzo, spedizione o metodo di pagamento non disponibile. Usa questa pagina per separare i casi normali dai segnali tecnici.
1. Lettura rapida
| Segnale | Cosa significa | Azione |
|---|---|---|
| Utente attivo su prodotto | Ha cliccato o aperto il carrello/store | Nessuna azione |
| Utente attivo su checkout | Ha raggiunto il checkout WooshPayment | Guarda se procede al pagamento |
| Ordine completato | Whop/COD ha chiuso correttamente | Nessuna azione |
| Conversion rate basso ma senza errori tecnici | Probabile abbandono commerciale | Rivedi prezzo, spedizione, trust, metodi pagamento |
| Eventi tecnici ripetuti | Possibile problema SDK/iframe/integrazione | Segui la checklist sotto |
2. Problema tecnico vs abbandono normale
Considera normale:
- cliente chiude il wallet o 3DS;
- carta rifiutata dalla banca;
- cliente non trova PayPal/Klarna e lascia il checkout;
- utente apre il checkout e non compila i dati;
- sessione scade dopo inattivita.
Considera tecnico:
- iframe Whop non diventa ready;
- errore
payment not ready, iframe null/ref, SDK submit non disponibile; init-paymentoprepare-paymentfalliscono prima del submit;- click Paga resta bloccato senza sheet, iframe, decline visibile o pagamento su Whop;
- Whop mostra pagato ma WooshPayment resta pending per webhook mancante.
3. Checklist quando vedi eventi tecnici
- Apri Dashboard → Ordini e filtra gli ordini tecnici.
- Controlla se la sessione ha eventi iframe/SDK prima del click Paga.
- Se il pagamento non e' mai partito, puoi far riprovare il cliente: non c'e' rischio doppio addebito.
- Se Whop mostra un pagamento
open,incompleteopending, aspetta o aggiorna stato prima di far riprovare. - Se Whop mostra
paidma WooshPayment non completa, chiedi backfill con session token e Whop payment id.
4. Shopify
Per Shopify il redirect dal cart passa dallo ScriptTag.
Se il checkout non si apre:
- Dashboard → Impostazioni o Integrazioni → verifica installazione Shopify.
- Se lo stato e' rosso, clicca Reinstalla o completa di nuovo OAuth.
- Apri il tema Shopify e clicca Checkout da cart normale e cart drawer.
- Se ancora non intercetta, usa Script tag debug.
5. WooCommerce
Per WooCommerce il redirect dal cart passa dal plugin ufficiale WooshPayment Checkout.
Se il checkout non si apre:
- WordPress → Plugin → verifica che WooshPayment Checkout sia attivo.
- WordPress → Impostazioni → WooshPayment → controlla l'health-check.
- Dashboard → Integrazioni → WooCommerce → verifica URL store e REST keys.
- Prova sia carrello classico sia block cart.
- Se la REST API fallisce, rigenera Consumer Key + Consumer Secret con permessi Read/Write.
6. Quando non usare fallback hosted
Il fallback hosted e' un paracadute tecnico, non un secondo checkout da usare sempre.
Non usarlo quando:
- carta rifiutata;
- 3DS o wallet chiuso dal cliente;
- cliente ha abbandonato per scelta;
- pagamento gia presente su Whop.
Ha senso solo quando il pagamento non e' partito davvero e il preflight conferma che non c'e' rischio doppio addebito.