WWooshPayment docs
Account & Billing

Dominio custom (checkout.tuostore.com)

Mappa il checkout WooshPayment al tuo dominio (checkout.tuostore.com) invece del default. Disponibile a tutti i merchant, senza gating piano.

3 min di lettura

TLDR: il default è {slug}.wooshpayment.com. Puoi rimpiazzarlo con checkout.tuostore.com aggiungendo un CNAME nel tuo DNS. SSL automatico via Vercel. Disponibile a tutti i merchant, senza gating piano.

Perché farlo

  • Trust — clienti vedono il tuo dominio durante il pagamento, non un terzo party
  • Brand consistency — la tab del browser mostra il tuo URL
  • Sicurezza percepita — alcuni clienti rifiutano di pagare su domini sconosciuti

Lo svantaggio: 5 minuti di DNS setup + propagazione DNS lato registrar.

Prerequisito

  • Accesso DNS del tuo dominio (GoDaddy, Cloudflare, Aruba, Namecheap, ecc.)
  • Decisione: il subdomain che vuoi (consigliato checkout, ma anche pay o store vanno bene)

Non usare il dominio apex (tuostore.com) o www.tuostore.com: quelli devono restare sul tuo Shopify/Woo. Usa un sottodominio dedicato.

Setup step-by-step

1. Aggiungi il dominio in WooshPayment

  1. Dashboard → Impostazioni → "Dominio checkout personalizzato"
  2. L'input ha il prefisso checkout. fisso (badge grigio non editabile): scrivi solo il root del tuo dominio (es. tuostore.com)
  3. Click "Aggiungi dominio"
  4. Compare un riquadro ambra con il record DNS da aggiungere al tuo provider

Se incolli per sbaglio https://checkout.tuostore.com/ il form normalizza automaticamente a tuostore.com. Se inserisci solo l'apex senza sottodominio (tuostore.com), il backend lo trasforma in checkout.tuostore.com.

2. Aggiungi il CNAME sul tuo DNS

Record da aggiungere:

CampoValore
TipoCNAME
Nome / Hostcheckout (solo questa parte, non il dominio intero)
Valore / Targetcname.vercel-dns.com. (col punto finale se il provider lo accetta)
TTL600 (10 min) o il default del provider

Esempi rapidi:

GoDaddy: Domini → DNS → Aggiungi → Tipo CNAME, Nome checkout, Valore cname.vercel-dns.com., TTL 1 ora.

Cloudflare: DNS → Add record → CNAME, Name checkout, Target cname.vercel-dns.com, Proxy status DNS only (grigio) — l'arancione/proxied rompe l'SSL.

Aruba: Pannello DNS → Gestione zona DNS → aggiungi CNAME come sopra.

Namecheap: Domain List → Manage → Advanced DNS → Add new record → CNAME, Host checkout, Value cname.vercel-dns.com., TTL Automatic.

3. Verifica in WooshPayment

Torna in Dashboard → Impostazioni → "Dominio checkout personalizzato" → click "Verifica DNS".

Tempi tipici di propagazione:

  • 5-30 minuti se il TTL del tuo DNS è basso
  • Fino a 24 ore worst case

Quando passa a "Verificato" (badge verde):

  • DNS risolve correttamente a Vercel
  • SSL Let's Encrypt emesso automaticamente
  • HTTPS forzato
  • Il tuo checkout è già live su checkout.tuostore.com
  • Apple Pay tenta auto-registrazione del nuovo dominio sul tuo Whop (vedi Apple Pay)

4. Nessuna azione sullo script tag

Lo script tag installato su Shopify NON cambia. Il backend WooshPayment risolve automaticamente il checkoutUrl al dominio custom quando lo stato è verified.

Limitazioni

  • Solo HTTPS — niente HTTP. Vercel forza HTTPS sempre.
  • No path-based — non puoi mappare tuostore.com/checkout. Deve essere sottodominio dedicato.
  • No wildcard — un dominio = un subdomain specifico.
  • CAA records — se il tuo DNS ha un CAA che limita le CA, aggiungi letsencrypt.org come CA permessa.

Rimozione

Dashboard → Impostazioni → "Dominio checkout personalizzato" → bottone "Rimuovi dominio". Il checkout torna a {slug}.wooshpayment.com immediatamente. Rimuovi anche il CNAME dal DNS per evitare puntamenti orfani.

Troubleshooting

Verifica resta in "In attesa" oltre 1 ora

dig CNAME checkout.tuostore.com
  • Attesa: ;; ANSWER SECTION: checkout.tuostore.com. 600 IN CNAME cname.vercel-dns.com.
  • Se non vedi risposta CNAME: il record non si è propagato. Controlla il pannello DNS e il TTL precedente del record.
  • Se vedi puntamento diverso (es. Shopify Inc.): hai messo il CNAME nella zona DNS sbagliata.

Errore "SSL handshake failed"

  • Probabile CAA record restrittivo. Aggiungi 0 issue "letsencrypt.org".
  • Oppure stai usando Cloudflare con proxy ON → switch a "DNS only".

Il cliente vede ancora {slug}.wooshpayment.com

  • Apri il checkout in incognito: i browser cachano 301
  • Controlla nella dashboard che lo stato sia "Verificato" (verde), non "In attesa"

Apple Pay non funziona sul dominio custom

L'auto-registrazione su Whop scatta al verified. Se il bottone Apple Pay non compare su Safari dopo qualche minuto, vai sul tuo Whop dashboard → Settings → Apple Pay → aggiungi manualmente checkout.tuostore.com. Vedi Apple Pay.