Aperçu des intégrations du checkout
July 30, 2026
Comparez les options d'intégration du checkout FlowAlp Pay : redirection, iFrame, fenêtre modale et apps mobiles, avec des conseils de choix.
Après avoir créé un Gateway via la Merchant API ou configuré une page de paiement dans le dashboard, vous choisissez comment vos clients voient le checkout FlowAlp Pay. Quatre modes de présentation existent : redirection pleine page, iFrame intégré, fenêtre modale et flux in-app pour les applications mobiles.
Les quatre options
La redirection envoie le client vers la page de paiement hébergée sur https://<instance>.pay.flowalp.com, puis le ramène vers votre URL de succès, d'échec ou d'annulation. C'est l'option la plus robuste et le choix recommandé pour les intégrations API, car chaque moyen de paiement s'exécute dans son environnement natif.
L'intégration iFrame affiche le formulaire de paiement dans la mise en page de votre site — idéal pour les sites marketing et les outils où le checkout doit sembler faire partie de la page.
La fenêtre modale ouvre le formulaire dans un overlay : le client ne quitte jamais votre site. Techniquement, elle se comporte comme un iFrame avec un cadre prêt à l'emploi.
L'intégration dans les apps mobiles charge la page de paiement dans une WebView ou un navigateur in-app et renvoie le résultat à votre app via des événements et des deep links.
Comparatif
| Mode | Expérience client | Idéal pour | Points d'attention |
|---|---|---|---|
| Redirection | Quitte temporairement votre site, revient via les URL de redirection | Intégrations API, plugins de boutique, la plupart des checkouts en production | Le retour seul ne prouve pas le paiement : confirmez côté serveur |
| iFrame | Formulaire intégré dans votre page | Landing pages, sites marketing, dashboards | Certains moyens de paiement refusent les frames |
| Fenêtre modale | Overlay sur votre page, le site reste visible | Checkouts courts déclenchés par un bouton | Mêmes restrictions de moyens de paiement que l'iFrame |
| Apps mobiles | WebView ou navigateur in-app dans votre app | Apps natives iOS et Android ou hybrides | Nécessite des deep links pour un retour propre |
Restrictions des moyens de paiement en mode intégré
Tous les moyens de paiement ne fonctionnent pas dans un iFrame ou une fenêtre modale. PayPal et Coinbase refusent totalement les contextes intégrés, et PostFinance est désactivé lorsque le navigateur bloque les cookies tiers (comportement par défaut sur iOS et macOS). Google Pay ne fonctionne que si le frame porte l'attribut allow="payment *".
Si un moyen concerné doit rester disponible, ajoutez &breakIframe=true à l'URL intégrée : la page de paiement externe s'ouvre alors dans un nouvel onglet.
Comment choisir
- Vous développez avec la Merchant API et voulez une compatibilité maximale : utilisez la redirection.
- Vous intégrez une page de paiement ou un formulaire de don dans un site existant : utilisez l'iFrame.
- Vous voulez un checkout immédiat sans quitter la page : utilisez la fenêtre modale.
- Vous publiez une app native ou hybride : suivez le guide mobile.
Confirmez les paiements côté serveur
Quel que soit le mode retenu, l'écran de succès ou la redirection ne sont que des signaux d'interface. Confirmez toujours l'état final via les webhooks — idéalement avec la vérification de signature — ou en récupérant la transaction via l'API avant d'exécuter une commande.
Étape suivante : créez un Gateway puis branchez le mode de présentation de votre choix — le guide iFrame est un bon point de départ.