Setup Whop

Whop è il processore di pagamento di WooshPayment. Gestisce carte, Apple Pay, Google Pay, antifrode e payout sul tuo conto bancario.

Perché Whop

	Whop	Stripe diretto
Setup time	5 min	30+ min con verifica documenti
Apple Pay	Incluso, no Apple Developer	Richiede certificato Apple ($99/anno)
Costo	5% + $0.30/txn	2.9% + $0.30/txn
Payout	Settimanale (mensile su nuovi account)	Giornaliero
Verifica documenti	Solo per payout >$500/mese	Subito al primo dollaro
Disponibile in Italia	✅	✅

Quando scegliere Whop: stai partendo, vuoi setup rapido, non vuoi gestire Apple Developer Account. Quando scegliere Stripe (roadmap): hai già volumi alti e ti pesa il 5%.

1. Crea account Whop

1. Vai su whop.com e crea account come "Business" (non Personal)
2. Verifica email
3. Crea una Company (nome del tuo brand)
4. Compila i dati legali base (richiesti per payout sopra i $500/mese)

2. Connetti su WooshPayment

1. WooshPayment dashboard → Pagamenti → Whop
2. Clicca "Connetti Whop"
3. Sarai reindirizzato su Whop OAuth
4. Autorizza WooshPayment → ti reindirizza con whopApiKey salvata (crittata at rest con AES-256)

Alternativa manuale:

• Su Whop → Impostazioni → API → crea una Company API Key con scope read_company + manage_checkouts + manage_payments
• Su WooshPayment incolla la API Key

3. Verifica funzionamento

1. Apri il tuo checkout (es. tuo-slug.wooshpayment.com/checkout/...) con prodotto di test
2. Compila email + indirizzo
3. Nel iframe Whop usa carta di test:
   • Numero: 4242 4242 4242 4242
   • Scadenza: qualsiasi data futura (es. 12/30)
   • CVV: 123
   • ZIP: 00100
4. Clicca Paga
5. Devi vedere "Ordine confermato" e ricevere mail

Se vedi "Carta rifiutata": verifica che sull'account Whop sia attivo il modo test (Settings → Test mode).

4. Configura webhook

WooshPayment riceve notifiche pagamento via webhook. Whop le configura automaticamente, ma per verifica:

1. Whop → Settings → Webhooks
2. Devi vedere un endpoint https://api.wooshpayment.com/webhooks/whop/payment-update
3. Eventi sottoscritti: invoice_paid, membership_activated, payment_failed

Se mancano, clicca Aggiungi webhook con i parametri sopra e verifica firma HMAC con secret generato da Whop (lo salviamo come WHOP_WEBHOOK_SECRET).

5. Payout

1. Whop → Settings → Payouts
2. Aggiungi conto bancario (IBAN)
3. Verifica via micro-deposito (1-2 giorni)
4. Payout settimanale di default (puoi cambiare a giornaliero dopo 30 giorni di storico)

Fee dettagliate

Voce	Costo
Transazione carta UE	5% + €0.30
Transazione carta US	5% + $0.30
Apple Pay / Google Pay	Stesso prezzo carta
Chargeback	$15 (rimborsato se vinci la disputa)
Refund	Free
Payout SEPA	Free
Payout SWIFT international	$15
Conversione valuta	2% sopra spot

Apple Pay attivazione

WooshPayment attiva automaticamente Apple Pay per ogni nuovo merchant. Vedi guida dedicata: Setup Apple Pay.

Domande frequenti

Posso usare Stripe invece di Whop?

Non ancora. È in roadmap per Q3 2026 (Sprint 12).

Whop chiede di verificare la mia identità — cosa serve?

Per payout > $500/mese Whop richiede:

• Copia documento (passaporto o carta identità)
• Indirizzo (bolletta o estratto conto)
• Per società: visura camerale

Cosa succede a un chargeback?

1. Whop ti notifica via email
2. Hai 7 giorni per fornire evidenze (tracking, comunicazioni cliente, ecc.)
3. Carica le evidenze su Whop Disputes
4. Whop e il network carta decidono in 30-90 giorni

Whop supporta pagamenti ricorrenti?

Sì, ma WooshPayment non li espone ancora. In roadmap.

Prossimi step

• Setup Apple Pay
• Gestire refund
• Webhook personalizzati