Pagamento fallisce

Se un cliente segnala "Non riesco a pagare" o vedi ordini bloccati in FAILED, qui sotto le cause più comuni.

1. Verifica lo stato dell'ordine

Dashboard → Ordini → seleziona ordine → guarda Stato Whop:

Stato	Significato	Azione
`PENDING`	Cliente non ha completato il pagamento	Aspetta o manda recovery mail
`PROCESSING`	Pagamento ricevuto, in elaborazione	Aspetta 5min, poi vedi sotto
`COMPLETED`	OK, ordine confermato	Niente da fare
`FAILED`	Pagamento rifiutato	Vedi sotto cause
`REFUNDED`	Rimborsato	Storico

2. Stato bloccato in PROCESSING

Se l'ordine resta PROCESSING per più di 5 minuti, il webhook di Whop probabilmente non è arrivato. Cause:

Whop webhook delivery best-effort (rare missed delivery)
WooshPayment API momentaneamente irraggiungibile (rarissimo)
Firma HMAC fallita (verifica WHOP_WEBHOOK_SECRET configurato)

Fix manuale:

Dashboard → Ordine → clicca "Verifica pagamento" (in alto a destra)
WooshPayment chiama l'API Whop direttamente, recupera lo stato reale
Se Whop dice "PAID" → l'ordine si aggiorna a COMPLETED
Se Whop dice "FAILED" → l'ordine si aggiorna a FAILED e il cliente NON viene addebitato

3. FAILED — cause comuni

Carta rifiutata dalla banca

Sintomo: cliente vede "Pagamento rifiutato" sull'iframe Whop. Cause:

Limiti carta superati
Fondi insufficienti
Banca blocca per acquisto in valuta estera
Carta scaduta / bloccata

Fix: cliente prova altra carta o contatta la sua banca.

3D-Secure cancellato

Sintomo: cliente vede schermata 3D-Secure (SMS code o app banking), poi clicca "Annulla". Fix: cliente refresha e rifa, completa il 3DS.

Indirizzo mismatch

Sintomo: il sistema dell'antifrode Whop blocca per inconsistenza tra paese carta e indirizzo spedizione. Fix: cliente usa stesso paese di emissione carta come indirizzo billing.

Apple Pay non funziona

Sintomo: bottone Apple Pay appare ma click non fa nulla, o errore generico. Cause:

Dominio non registrato su Whop Apple Pay (vedi Setup Apple Pay)
Carta del Wallet non supportata da Whop
Cliente non ha selezionato carta nel Wallet Fix: cliente passa a carta manuale; tu verifica registrazione dominio su Whop.

Amount mismatch

Sintomo: vedi log "AMOUNT_MISMATCH" o error 409 nelle logs. Cause: race condition rare tra shipping change e click "Paga". Il bug è risolto in Sprint 5 (vedi bug storici) ma può accadere ancora se cliente è velocissimo. Fix: cliente refresha e riprova. Il sistema lo gestisce con retry automatico.

4. Cliente paga ma ordine non sincronizzato su Shopify/WooCommerce

Sintomo: WooshPayment mostra COMPLETED, Shopify Admin non vede l'ordine.

Cause:

API scope Shopify perso/revocato
Webhook Shopify-side non installato
Quota WooCommerce REST API superata

Fix:

WooshPayment → Integrazioni → Shopify (o WooCommerce) → "Test connessione"
Se fail: reconnect (genera nuove credenziali)
Vai su WooshPayment → Ordini → ordine → "Risincronizza con store"

5. Logs

Per debug avanzato, Super admin → Logs:

Filtra per error level
Cerca il session_id (formato ch_xxx)
Vedi traceback completo

6. Quando contattare supporto

Se hai provato tutto e il problema persiste, manda email a hello@wooshpayment.com con:

Order ID (formato WP-XXXXXX)
Session ID Whop (ch_xxx) se disponibile
Email cliente
Screenshot del messaggio errore
Cosa hai già provato

Rispondiamo entro 24h (24/7 su piano Scale).

Tabella rapida — sintomo → fix

Sintomo cliente	Fix lato tuo
"La pagina checkout non carica"	Verifica DNS sottodominio, refresh cache CDN
"Vedo errore CORS"	Contatta supporto (rara, indica bug)
"Pagamento accettato ma niente conferma"	Verifica pagamento dal dashboard
"Carta rifiutata"	Cliente prova altra carta o paga con Apple Pay
"Apple Pay button assente"	Verifica registrazione dominio su Whop
"Riceve un addebito ma niente prodotto"	Verifica stato in WooshPayment → forza sync su store