Scegliere un'integrazione
July 30, 2026
Guida alla scelta dell'integrazione FlowAlp Pay: confronta pay link e codici QR, plugin per shop, checkout ospitato via API e integrazione completa.
FlowAlp Pay offre quattro percorsi di integrazione, ordinati qui da zero codice a controllo completo: pay link e codici QR, plugin, checkout ospitato pilotato dalla Merchant API e integrazione API completa. Tutti i percorsi condividono lo stesso account, gli stessi metodi di pagamento, la stessa dashboard e la stessa reportistica — e puoi combinarli liberamente. Questa guida ti aiuta a scegliere il punto di partenza giusto.
Confronto rapido
| Integrazione | Sviluppo richiesto | Ideale per | Dove funziona |
|---|---|---|---|
| Pay link e codici QR | Nessuno | Fatture, donazioni, vendite via e-mail o social, pagamenti QR di persona | Creati dalla dashboard, condivisi come link o codice QR |
| Plugin | Minimo (installazione e configurazione) | Shop su piattaforme e-commerce, CMS o gestionali supportati | Dentro il tuo sistema shop |
| Checkout ospitato via API (Gateway) | Integrazione backend | Carrelli e app custom con importi dinamici e redirect controllati | Il tuo backend lo crea; il cliente paga sulla pagina ospitata |
| Integrazione API completa | Massimo | Tokenization, pre-authorization, subscription e operazioni post-pagamento custom | Il tuo backend gestisce l'intero ciclo di vita |
Pay link e codici QR — senza codice
Crea un link di pagamento o un codice QR dalla dashboard, imposta importo e causale e condividilo via e-mail, chat, fattura o stampa. Il cliente paga sulla tua pagina di pagamento ospitata sul dominio del tuo tenant. È il modo più rapido per incassare il primo pagamento. Vedi Pay link e codici QR.
Plugin — poco codice
Se la tua piattaforma è supportata, preferisci un plugin a uno sviluppo custom: il flusso di pagamento è già implementato e mantenuto, e la configurazione si limita a collegare instance e API key. Parti da queste panoramiche:
- Integrazioni e-commerce — inclusa la guida WooCommerce
- Integrazioni CMS
- Software gestionali
- Altre integrazioni
Checkout ospitato via Merchant API (Gateway)
Usa un Gateway quando il tuo backend genera ordini con importi dinamici e vuoi redirect controllati di successo, fallimento e annullamento — mentre la pagina di pagamento resta ospitata da FlowAlp Pay. Il flusso tipico:
- Il tuo backend crea un Gateway (Creare un Gateway) con importo, valuta e il riferimento del tuo ordine.
- Il cliente paga sulla pagina di pagamento ospitata — come redirect oppure incorporata via iFrame o modale (panoramica embedding del checkout).
- Il tuo server riceve un webhook e lo verifica (Configurare i webhook).
- Aggiorni l'ordine solo dopo la conferma lato server.
Integrazione API completa
Oltre al checkout ospitato, la Merchant API permette di addebitare metodi di pagamento salvati (tokenization), riservare e incassare importi (pre-authorization), gestire pagamenti ricorrenti (subscription) e amministrare rimborsi e annullamenti con la Transaction API (addebito, capture, rimborso e annullamento). Parti dalla panoramica della Merchant API.
Come decidere
- Nessuno sviluppatore disponibile o pagamenti occasionali: usa pay link e codici QR.
- Usi una piattaforma shop standard: usa un plugin.
- Hai un checkout, un carrello o un'app tua: crea Gateway via API.
- Ti servono carte salvate, prenotazioni o abbonamenti: pianifica una integrazione API completa.
Il redirect del browser verso la pagina di successo non è una prova di pagamento. Qualunque percorso tu scelga, conferma ogni pagamento lato server tramite webhook (con verifica della firma) o una lettura via API prima di evadere l'ordine.
Hai deciso? Configura il tuo instance name e le credenziali API, poi invia la tua prima richiesta API. Se non sviluppi, passa direttamente a pay link e codici QR.