FlowAlp

Guida al plugin WooCommerce

July 30, 2026

Guida passo passo a WooCommerce con FlowAlp Pay: attiva l'integrazione, installa e collega il plugin, configura i metodi e testa gli ordini.

Questa guida collega uno shop WooCommerce a FlowAlp Pay dall'inizio alla fine: attivazione dell'integrazione nella dashboard, installazione e collegamento del plugin, configurazione dei metodi di pagamento e verifica con un ordine di test. Il plugin offre supporto multi-valuta, icone dei metodi nel checkout, trasmissione del carrello, aggiornamenti di stato via webhook, configurazione del look & feel, impostazioni per singolo metodo, supporto alle subscription e sincronizzazione dei rimborsi.

Requisiti

  • Un'installazione aggiornata di WordPress e WooCommerce — la scheda del plugin indica l'intervallo di versioni testato
  • Un account FlowAlp Pay con accesso alla dashboard su https://pay.flowalp.com (crea il tuo account)
  • L'integrazione WooCommerce disponibile nella tua dashboard — la disponibilità dipende dalla configurazione del tuo account
  • Uno storefront raggiungibile pubblicamente via HTTPS con certificato valido

Passo 1 — Attiva l'integrazione in FlowAlp Pay

  1. Accedi a https://pay.flowalp.com e apri API & Plugins.
  2. Sotto Aggiungi integrazione e-commerce clicca Mostra tutte e aggiungi WooCommerce.
  3. Il pannello mostra l'API key emessa per questo collegamento e il tuo [instance name](/it/docs/flowalp-pay-instance-name/).
  4. Inserisci l'indirizzo dello shop — l'URL esatto dello storefront. Se lo shop sta in una sottodirectory, includi il percorso completo, ad es. https://mio-sito.example/shop.
  5. Decidi se i webhook falliti vanno ritentati: fino a 10 tentativi dopo 5 minuti, 15 minuti, 1 ora, 2 ore, 4 ore e poi ogni 24 ore.
  6. Clicca Attiva per concludere.

Inserisci l'URL dello shop con esattezza. Basta http:// al posto di https:// — o una sottodirectory mancante — per rompere l'elaborazione dei webhook e bloccare gli ordini.

Passo 2 — Installa il plugin in WordPress

  1. In WordPress vai su Plugin → Aggiungi plugin.
  2. Installa il plugin di pagamento WooCommerce per il tuo account FlowAlp Pay — il pannello di integrazione nella dashboard rimanda alla scheda corretta.
  3. Clicca Installa ora e poi Attiva.

La scheda del plugin compare con il nome tecnico dell'infrastruttura di pagamento alla base di FlowAlp Pay. Segui il link dalla dashboard per essere sicuro di installare il plugin giusto.

Passo 3 — Collega il plugin al tuo account

Apri WooCommerce → Impostazioni e passa alla scheda della piattaforma di pagamento aggiunta dal plugin. Seleziona la voce della piattaforma, inserisci il tuo instance name — il sottodominio dell'URL della tua pagina di pagamento, quindi demo-shop per demo-shop.pay.flowalp.com — e avvia la connessione. Vieni inoltrato al login FlowAlp Pay su https://login.pay.flowalp.com; dopo l'accesso, shop e account vengono collegati automaticamente.

Se la tua versione del plugin mostra campi manuali per le credenziali al posto della procedura guidata, incolla instance name e API key esattamente come li mostra il pannello di integrazione della dashboard.

Impostazione opzionaleScopo
Look & Feel Profile IDServe solo se il tuo account ha più profili look & feel; inserisci l'ID del profilo desiderato, altrimenti lascia vuoto
PrefixSolo per configurazioni piattaforma con più shop in un unico account: il prefisso indica a quale shop appartiene un riferimento ordine

Passo 4 — Abilita e configura i metodi di pagamento

  1. Vai su WooCommerce → Impostazioni → Pagamenti — ogni metodo di pagamento compare come voce separata.
  2. Abilita o disabilita i metodi dal menu con i tre puntini.
  3. Clicca Gestisci su un metodo per impostare titolo, descrizione e — dove previsto — il supporto alle subscription.
  4. Salva le modifiche.

Un metodo compare nel checkout solo se è attivo anche sul tuo account FlowAlp Pay e supporta la valuta dello shop. Le dotazioni tipiche svizzere includono TWINT, Visa, Mastercard, American Express, PostFinance, Apple Pay, Google Pay, PayPal e Klarna — la disponibilità dipende dalla configurazione del tuo account; vedi metodi di pagamento.

Passo 5 — Esegui un ordine di test

  1. Passa alla modalità TEST come descritto in Testing per sviluppatori.
  2. Metti un prodotto nel carrello e vai al checkout.
  3. Seleziona un metodo di pagamento — WooCommerce reindirizza alla pagina di pagamento FlowAlp Pay.
  4. Paga con le carte o credenziali di test.
  5. Verifica i risultati: il browser torna alla pagina di conferma dello shop, l'ordine WooCommerce cambia stato, la transazione compare nella dashboard e il log dei webhook registra una risposta 200.

Subscription e pagamenti ricorrenti

Per vendere prodotti ricorrenti installa e attiva il plugin WooCommerce Subscriptions. Esistono due modelli di rinnovo: con il rinnovo automatico il metodo di pagamento salvato viene addebitato alla scadenza — solo alcuni metodi lo supportano. Con il rinnovo manuale il cliente riceve un'email con un link di pagamento per ogni rata in scadenza — funziona con tutti i metodi del tuo account. Se non vuoi affatto pagamenti ricorrenti, disattiva la funzione sotto WooCommerce → Impostazioni → Subscriptions. Approfondimento lato fatturazione: abbonamenti e pagamenti ricorrenti.

Rimborsi

Esegui i rimborsi totali o parziali nella dashboard FlowAlp Pay. Una volta completato lì, il rimborso viene comunicato automaticamente a WooCommerce e compare sull'ordine.

I rimborsi avviati dentro WooCommerce non vengono inoltrati a FlowAlp Pay: il cliente non riceverebbe i soldi. Rimborsa sempre dalla dashboard.

Risoluzione dei problemi

SintomoCausa probabile e rimedio
L'ordine resta *pending*, lo stato non si aggiornaL'indirizzo dello shop nel pannello di integrazione non coincide esattamente con lo storefront. Correggi schema (https://) e sottodirectory, poi controlla il log dei webhook nella dashboard.
Le chiamate webhook rispondono 404I permalink di WordPress impostati su *Semplice* possono rompere le route di callback. Attiva i permalink SEO-friendly sotto Impostazioni → Permalink e salva per rigenerare le regole di rewrite; assicurati inoltre che nessuna modalità manutenzione, basic auth o firewall blocchi l'endpoint.
Errori SSL nel log dei webhookLo shop deve essere raggiungibile via HTTPS con una catena di certificati valida e completa. Rinnova o ripara il certificato e mantieni l'URL dello shop su https://.
Metodo di pagamento assente nel checkoutAbilita il metodo sotto WooCommerce → Impostazioni → Pagamenti, verifica che sia attivo sul tuo account FlowAlp Pay e che supporti la valuta dello shop.
La connessione all'account fallisceControlla la grafia dell'instance name (il sottodominio della tua pagina di pagamento), ricopia l'API key dal pannello di integrazione e seleziona la voce di piattaforma corretta.

FAQ

  • Dove trovo instance name e API key? Nella dashboard sotto API & Plugins, dentro il pannello dell'integrazione WooCommerce — vedi anche credenziali API.
  • Posso testare senza addebitare denaro reale? Sì — usa la modalità TEST con le carte di test ed esegui almeno un pagamento riuscito e uno fallito.
  • Il plugin supporta più valute? Sì. Ogni metodo di pagamento deve però supportare la valuta in uso.
  • Il checkout resta dentro il mio shop? Il plugin usa il flusso di redirect verso la pagina di pagamento ospitata; per le varianti embedded su pagine personalizzate vedi la panoramica del checkout.
  • Un cliente o una subscription è sparita — l'ha cancellata il plugin di pagamento? No. Il plugin non modifica mai i dati cliente in WooCommerce; verifica il plugin Subscriptions o modifiche manuali degli utenti WordPress.

Prossimo passo: prima di accettare pagamenti reali, percorri la checklist di go-live.