Überblick über die Checkout-Einbindung
July 30, 2026
Vergleichen Sie die Checkout-Einbindungen von FlowAlp Pay: Redirect, iFrame, Modal Window und Mobile Apps – mit Empfehlungen zur Auswahl.
Sobald Sie über die Merchant API ein Gateway erstellt oder im Dashboard eine Zahlungsseite eingerichtet haben, entscheiden Sie, wie Ihre Kundschaft den FlowAlp Pay Checkout sieht. Vier Darstellungsmodi stehen bereit: Redirect auf die gehostete Seite, eingebetteter iFrame, Modal Window und ein In-App-Flow für mobile Apps.
Die vier Optionen
Redirect führt die Kundin oder den Kunden auf die gehostete Zahlungsseite unter https://<instance>.pay.flowalp.com und anschliessend zurück zu Ihrer Success-, Failed- oder Cancel-URL. Das ist die robusteste Variante und der empfohlene Standard für API-Integrationen, weil jede Zahlungsmethode in ihrer nativen Umgebung läuft.
Das iFrame-Embedding rendert das Zahlungsformular direkt in Ihrem Seitenlayout – passend für Marketing-Sites und Tools, bei denen sich der Checkout wie ein Teil der Seite anfühlen soll.
Das Modal Window öffnet das Formular in einem Overlay, die Kundschaft verlässt Ihre Website nie. Technisch verhält es sich wie ein iFrame mit fertigem Rahmen.
Die Mobile-App-Integration lädt die Zahlungsseite in einer WebView oder einem In-App-Browser und meldet das Ergebnis über Events und Deep Links an Ihre App zurück.
Vergleich
| Modus | Kundenerlebnis | Am besten für | Zu beachten |
|---|---|---|---|
| Redirect | Verlässt Ihre Site kurz und kehrt über Redirect-URLs zurück | API-Integrationen, Shop-Plugins, die meisten Produktiv-Checkouts | Die Rückkehr allein beweist keine Zahlung – serverseitig bestätigen |
| iFrame | Formular direkt in Ihrer Seite eingebettet | Landingpages, Marketing-Sites, Dashboards | Einige Zahlungsmethoden laufen nicht im Frame |
| Modal Window | Overlay über Ihrer Seite, die Site bleibt sichtbar | Kurze Checkouts per Button | Gleiche Methoden-Einschränkungen wie beim iFrame |
| Mobile Apps | WebView oder In-App-Browser in Ihrer App | Native iOS- und Android-Apps oder Hybrid-Apps | Braucht Deep Links für einen sauberen Rückweg |
Einschränkungen bei eingebetteten Zahlungsmethoden
Nicht jede Zahlungsmethode darf in einem iFrame oder Modal Window laufen. PayPal und Coinbase verweigern eingebettete Kontexte komplett, PostFinance wird deaktiviert, wenn der Browser Drittanbieter-Cookies blockiert (Standard auf iOS und macOS). Google Pay funktioniert nur, wenn der Frame das Attribut allow="payment *" trägt.
Muss eine betroffene Methode verfügbar bleiben, hängen Sie &breakIframe=true an die eingebettete URL an: Die externe Zahlungsseite öffnet sich dann in einem neuen Browser-Tab.
So wählen Sie
- Sie entwickeln gegen die Merchant API und wollen maximale Kompatibilität: Nutzen Sie den Redirect.
- Sie betten eine Zahlungsseite oder ein Spendenformular in eine bestehende Website ein: Nutzen Sie den iFrame.
- Sie möchten einen schnellen Checkout ohne Seitenwechsel: Nutzen Sie das Modal Window.
- Sie liefern eine native oder hybride App aus: Folgen Sie dem Mobile-Guide.
Zahlungen serverseitig bestätigen
Egal welcher Modus: Erfolgsbildschirm und Redirect sind nur UI-Signale. Bestätigen Sie den finalen Status immer über Webhooks – idealerweise mit Signaturprüfung – oder rufen Sie die Transaktion über die API ab, bevor Sie eine Bestellung erfüllen.
Nächster Schritt: Erstellen Sie ein Gateway und binden Sie den gewünschten Modus an – der iFrame-Guide ist ein guter Einstieg.