Quickstart in 5 minuti

Benvenuto in WooshPayment. In questa guida creiamo l'account, completiamo l'onboarding in 6 step e mandiamo un primo ordine di prova.

Cosa ti serve

• 5 minuti di tempo
• Uno store Shopify oppure WooCommerce con almeno un prodotto pubblicato
• Una mail valida
• Un account Whop con ruolo Proprietario sulla Company (lo creiamo allo step 4)

1. Crea l'account

1. Vai su wooshpayment.com/signup
2. Inserisci mail, password (min 8 caratteri) e nome dello store
3. Submit → atterri direttamente nell'onboarding

Cosa succede dietro le quinte:

• Generiamo uno slug univoco dal nome store (es. "My Brand" → my-brand)
• Provisioniamo {slug}.wooshpayment.com su Vercel con SSL automatico
• Inviamo la mail di verifica (link valido 24h)

2. Onboarding — 6 step

L'onboarding è lineare: ogni step deve essere completato per sbloccare il successivo.

Step 1 — Piattaforma

Scegli Shopify o WooCommerce.

• Shopify → clicca "Connetti Shopify", inserisci il tuo tuo-store.myshopify.com, autorizza l'app sul tuo Admin. Al rientro abbiamo accessToken + ScriptTag installato in automatico.
• WooCommerce → URL dello store + Consumer Key + Consumer Secret (generabili in WooCommerce → Impostazioni → Avanzate → REST API).

Guide dedicate: Shopify · WooCommerce.

Step 2 — Brand

• Logo (PNG/SVG, max 200KB, consigliato quadrato o orizzontale)
• Colore primario in formato esa (es. #0ea5e9) — applicato a bottoni e accenti
• Font dropdown

Preview live a destra.

Step 3 — Spedizioni

Definisci le fasce di spedizione (es. Standard 4,90€ 3-5gg, Express 9,90€ 24-48h, Gratis sopra 50€). Vengono mostrate al cliente in checkout.

Step 4 — Pagamenti

Due metodi disponibili:

• Whop Payments (richiesto) — carte, Apple Pay, Google Pay. Si attiva incollando la API Key Whop dalla pagina Integrazioni (vedi Setup Whop).
• Contrassegno (COD) — checkbox opzionale; il cliente paga al corriere.

Step 5 — Anteprima

Apri il checkout di prova nel tuo subdomain {slug}.wooshpayment.com. Verifica logo, colori, spedizioni, metodi di pagamento. Devi cliccare il link prima di poter procedere (anti-launch-blind).

Step 6 — Lancia

WooshPayment ti mostra l'istruzione finale (per Shopify lo ScriptTag è già installato automaticamente; non devi incollare nulla nel tema). Click "Vai alla dashboard" → onboarding chiuso.

3. Connetti Whop

Senza Whop puoi solo accettare COD. Per le carte:

1. Crea account su whop.com come Business, verifica email, crea una Company
2. In Whop → Developer → API Keys → "New key" con ruolo Proprietario
3. WooshPayment → Integrazioni → Whop → incolla la key (formato apik_…) → "Connetti Whop"
4. Risposta in ~1 secondo: badge "Connesso" + Business ID visibile

Guida completa: Setup Whop.

4. Manda un ordine di prova

1. Apri il tuo store (Shopify/Woo), aggiungi un prodotto al carrello, clicca "Checkout"
2. Il bottone viene intercettato dal nostro ScriptTag e ti porta su {slug}.wooshpayment.com/checkout/{token}
3. Completa il form (email, indirizzo, spedizione)
4. Paga con carta di test Whop: 4242 4242 4242 4242, data futura qualsiasi, CVV qualsiasi
5. L'ordine compare in Dashboard → Ordini; ricevi la notifica via email al merchant

Prossimi step

• Verifica Apple Pay (auto-registrato sul tuo Whop dopo lo step 3)
• (Opzionale) Mappa un dominio custom checkout.tuostore.com
• Attiva i pixel marketing GA4, GTM, Meta CAPI, TikTok
• Configura mercati & lingue se vendi multi-paese
• Spunta tutta la checklist pre-lancio

Problemi?

• Mail verifica non arriva → controlla Junk/Spam (specie Outlook/Hotmail); vedi Email non arriva
• Whop ritorna 401 → ruolo della API Key sbagliato, rigenera come Proprietario
• Bottone Checkout non redirige → vedi Script tag debug

Per supporto: noreply@wooshpayment.com (rispondiamo in 24h).