Panoramica dell'embedding del checkout
July 30, 2026
Confronta le opzioni di embedding del checkout FlowAlp Pay: redirect, iFrame, modal window e app mobile, con consigli su quando usarle.
Dopo aver creato un Gateway tramite la Merchant API o configurato una pagina di pagamento nella dashboard, decidi tu come i tuoi clienti vedono il checkout FlowAlp Pay. Hai quattro modalità di presentazione: redirect a pagina intera, iFrame incorporato, modal window e flusso in-app per le app mobile.
Le quattro opzioni
Redirect: il cliente viene indirizzato alla pagina di pagamento ospitata su https://<instance>.pay.flowalp.com e torna poi al tuo URL di successo, errore o annullamento. È la scelta più robusta e l'impostazione consigliata per le integrazioni API, perché ogni metodo di pagamento gira nel suo ambiente nativo.
L'embedding iFrame mostra il modulo di pagamento direttamente nel layout della tua pagina: ideale per siti marketing e tool in cui il checkout deve sembrare parte della pagina.
La modal window apre il modulo in un overlay: il cliente non lascia mai il tuo sito. Tecnicamente si comporta come un iFrame con una cornice già pronta.
L'integrazione nelle app mobile carica la pagina di pagamento in una WebView o in un browser in-app e restituisce il risultato alla tua app tramite eventi e deep link.
Confronto
| Modalità | Esperienza del cliente | Ideale per | Attenzione a |
|---|---|---|---|
| Redirect | Lascia temporaneamente il tuo sito e torna tramite gli URL di redirect | Integrazioni API, plugin per shop, la maggior parte dei checkout in produzione | Il solo ritorno non prova il pagamento: conferma lato server |
| iFrame | Modulo incorporato nel layout della tua pagina | Landing page, siti marketing, dashboard | Alcuni metodi di pagamento non funzionano dentro un frame |
| Modal window | Overlay sulla pagina, il sito resta visibile | Checkout rapidi avviati da un pulsante | Stesse limitazioni dei metodi di pagamento dell'iFrame |
| App mobile | WebView o browser in-app nella tua app | App native iOS e Android o ibride | Servono deep link per un ritorno pulito |
Limitazioni dei metodi di pagamento in modalità embedded
Non tutti i metodi di pagamento possono girare in un iFrame o in una modal window. PayPal e Coinbase rifiutano del tutto i contesti embedded, mentre PostFinance viene disattivato quando il browser blocca i cookie di terze parti (comportamento predefinito su iOS e macOS). Google Pay funziona solo se il frame ha l'attributo allow="payment *".
Se un metodo interessato deve restare disponibile, aggiungi &breakIframe=true all'URL incorporato: la pagina di pagamento esterna si aprirà in una nuova scheda del browser.
Come scegliere
- Sviluppi con la Merchant API e vuoi la massima compatibilità: usa il redirect.
- Incorpori una pagina di pagamento o un modulo donazioni in un sito esistente: usa l'iFrame.
- Vuoi un checkout immediato senza uscire dalla pagina: usa la modal window.
- Distribuisci un'app nativa o ibrida: segui la guida all'integrazione mobile.
Conferma i pagamenti lato server
Qualunque modalità tu scelga, la schermata di successo o il redirect sono solo segnali di interfaccia. Conferma sempre lo stato finale tramite i webhook — idealmente con la verifica della firma — oppure recuperando la transazione via API prima di evadere un ordine.
Prossimo passo: crea un Gateway e collega la modalità di presentazione che preferisci — la guida iFrame è un buon punto di partenza.