WWooshPayment docs
Checkout

Mercati e lingue

Configura mercati multi-paese con currency, lingua del checkout e adeguamento prezzi per zona geografica.

3 min di lettura

TLDR: Dalla pagina Dashboard → Mercati & Lingue definisci dei "Mercati" (gruppo di paesi) con una lingua, una valuta e un eventuale aggiustamento prezzo. Il checkout serve il cliente nella lingua del suo Market.

Dove

Dashboard → Mercati & Lingue (/dashboard/markets).

Vengono creati 3 Mercati di default al primo accesso:

  • Europa (IT, DE, FR, ES, PT, NL, BE, AT, CH, PL, SE, DK, NO, FI, CZ, RO, HU, GR, SK, HR, BG, SI, LT, LV, EE, LU, MT, CY, IE) — EUR, lingua it, attivo
  • United Kingdom (GB) — GBP, lingua en, disattivo
  • North America (US, CA) — USD, lingua en, disattivo

Puoi modificarli, attivarli/disattivarli, o aggiungerne di nuovi.

Cosa puoi configurare per ogni Market

CampoNote
NomeEtichetta interna, non vista dal cliente
PaesiLista codici ISO 3166-1 alpha-2 (IT, DE, ecc.)
CurrencyUna tra le 21 supportate: EUR, USD, GBP, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, AED, SAR, CNY, JPY, BRL, MXN, AUD, CAD
Lingua19 lingue (vedi sotto)
Price adjustment+10% markup o -15% sconto sul prezzo base. 0 = nessun aggiustamento
ActiveSwitch on/off senza eliminare

Lingue supportate

19 lingue per il checkout:

  • EU/Western: Italiano, English, Deutsch, Français, Español, Português, Nederlands, Polski, Svenska, Dansk, Norsk, Suomi
  • CEE: Čeština, Română, Magyar, Ελληνικά
  • Asia/MENA: العربية, 中文, 日本語

La lingua mostrata al cliente in checkout è determinata dal Market che matcha il suo paese (basato sull'IP geolocation + opzione "cambia lingua" manuale).

Come funziona la selezione del Market

  1. Cliente atterra sul checkout
  2. Geolocation IP determina il paese di partenza
  3. Cerchiamo nel tuo elenco Market il primo Market active che contiene quel paese
  4. Applichiamo currency, lingua e price adjustment di quel Market
  5. Se nessun Market matcha, fallback al Market default del merchant (o EUR/it)

Price adjustment

Esempio pratico:

  • Market Europa con priceAdjustment: 0 → prezzo prodotto invariato
  • Market North America con priceAdjustment: +20% → prezzo prodotto in checkout aumentato del 20% (per coprire costi spedizione/dazi)
  • Market Black Friday EU con priceAdjustment: -15% → sconto applicato automaticamente solo per quei paesi (utile per testare promo geografica)

Tasse / IVA

La gestione IVA per paese si configura separatamente in Dashboard → Checkout sezione "Tasse":

  • Label IVA (default IVA)
  • Prices include tax (sì/no)
  • Default rate (es. 22)
  • Rate per paese (mappa IT → 22, DE → 19, ecc.)

La sincronizzazione automatica IVA per tutti i paesi UE è in roadmap. Oggi devi compilare manualmente la mappa dei rate per i paesi che ti interessano.

Limitazioni attuali

  • Niente Country Picker UI per il cliente in checkout — la selezione Market è automatica via IP. Roadmap: dropdown manual override.
  • I prezzi del catalogo restano espressi nella currency base impostata sul tuo store (Shopify/Woo). Il price adjustment lavora al runtime in checkout, non sul catalogo del tuo store.
  • Pesatura non c'è ancora: se un prodotto pesa diverso per paese, il calcolo spedizione resta lineare.

Domande frequenti

Posso usare lo stesso Market per più paesi con currency diverse?

No, una currency per Market. Crea due Market separati se serve.

Cosa succede se il paese del cliente non è in nessun Market?

Cliente viene servito col Market di default del merchant (di solito Europa EUR/it).

Posso disattivare temporaneamente un Market senza eliminarlo?

Sì, switch active: false. Niente perdita di config.