WWooshPayment docs
Iniziare

Quickstart guidato

Crea il tuo primo checkout brandizzato WooshPayment, connetti lo store e manda un ordine pilota prima del traffico.

4 min di lettura

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

  • Uno store Shopify oppure WooCommerce con almeno un prodotto pubblicato
  • Una mail valida
  • Un account Whop se vuoi accettare carte o wallet idonei; se parti solo con Contrassegno puoi collegarlo dopo

La configurazione Demo non richiede un piano live attivo. Dopo il signup atterri sulla schermata di verifica email (/verify-email-pending): clicca il link ricevuto via email per iniziare l'onboarding. Se la mail non arriva, usa "Rinvia email di verifica" e controlla Spam/Promozioni.

1. Crea l'account

  1. Vai su wooshpayment.com/signup
  2. Inserisci mail, password (min 8 caratteri) e nome dello store
  3. Submit → controlla la mail e clicca il link di verifica
  4. Dopo la verifica entri nell'onboarding

Se l'accesso pubblico e' chiuso, usa il link invito ricevuto dal team WooshPayment: il token viene verificato anche dal backend durante la registrazione.

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 → crea una dev-app nel tuo Shopify Dev Dashboard, incolla dominio tuo-store.myshopify.com, Client ID e Client Secret, poi autorizza l'app sul tuo Admin. Al rientro abbiamo accessToken + ScriptTag installato, poi va verificato con un test reale dal carrello sul tema live.
  • WooCommerce → installa il plugin ufficiale, poi incolla URL dello store + Consumer Key + Consumer Secret (generabili in WooCommerce → Impostazioni → Avanzate → REST API).

Guide dedicate: Shopify · WooCommerce.

Step 2 — Brand

  • Logo URL pubblico, se vuoi mostrare il logo nel checkout
  • Colore primario e colore secondario/accento in formato esa (es. #0ea5e9) — applicati a bottoni e accenti
  • Lingua checkout: automatica dal browser oppure forzata
  • Badge di fiducia, banner e recensioni da mostrare nel checkout

Preview live a destra.

Step 3 — Spedizioni

Definisci le fasce di spedizione in EUR base (es. Standard 4,90€ 3-5gg, Express 9,90€ 24-48h, Gratis sopra 50€). Se il checkout usa un mercato non-EUR, tariffe e soglie vengono convertite automaticamente nella valuta del cliente.

Step 4 — Pagamenti

Due metodi disponibili:

  • Whop Payments — richiesto se vuoi accettare carte o wallet idonei. I wallet appaiono solo quando Whop, dominio checkout, browser e device li supportano. Whop è pronto solo dopo API key, Product ID e webhook secret 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 — Controllo finale

WooshPayment ti mostra il controllo finale: per Shopify lo ScriptTag deve risultare installato e verificato con un click reale dal carrello live; per WooCommerce il plugin deve risultare attivo e aver intercettato almeno un checkout. Dopo il piano live puoi segnare il setup come verificato e andare alla dashboard.

3. Connetti Whop

Puoi saltare questo passaggio se parti solo con Contrassegno. Collegalo prima di attivare carte o wallet:

  1. Crea account su whop.com come Business, verifica email, crea una Company
  2. In Whop → Developer → API Keys → "New key" con ruolo Amministratore oppure Proprietario
  3. WooshPayment → Integrazioni → Whop → incolla API key (apik_…), Product ID (prod_…) e webhook secret (ws_…)
  4. La dashboard mostra stato verde se Whop è pronto, stato amber se manca Product ID o webhook secret

La chiave deve ereditare un ruolo Company sufficiente. Se l'endpoint /v5/company di Whop ritorna 401 "does not have permission to access this route", rigenera la chiave come Amministratore o Proprietario.

Setup guidato: Collegare Whop. Guida completa con Product ID: 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 dallo ScriptTag Shopify oppure dal plugin WooCommerce e ti porta su {slug}.wooshpayment.com/checkout/{token}
  3. Completa il form (email, indirizzo, spedizione)
  4. Se Whop è pronto in produzione, fai un piccolo pagamento reale dal carrello live. Usa una carta test solo se il supporto ha abilitato esplicitamente la sandbox Whop sul tuo merchant. Se stai testando COD, scegli Contrassegno e completa l'ordine senza carta.
  5. L'ordine compare in Dashboard → Ordini; ricevi la notifica via email al merchant

Prossimi step

Sei pronto per il traffico solo dopo l'ordine pilota: il bottone "Checkout" deve reindirizzare al checkout brandizzato, l'ordine deve comparire nello store e devi verificare email, pixel/CAPI e dashboard ordine.

Problemi?

  • Mail verifica non arriva → controlla Junk/Spam (specie Outlook/Hotmail); vedi Email non arriva
  • Whop ritorna 401 → ruolo della API Key troppo basso, rigenera come Amministratore o Proprietario
  • Bottone Checkout non redirige → per Shopify vedi Script tag debug; per WooCommerce verifica plugin ufficiale e REST API

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