Choisir une intégration
July 30, 2026
Guide de décision FlowAlp Pay : comparez liens de paiement et QR codes, plugins e-commerce, checkout hébergé via l'API et intégration API complète.
FlowAlp Pay propose quatre parcours d'intégration, classés ici de zéro code au contrôle total : liens de paiement et QR codes, plugins, checkout hébergé piloté par la Merchant API, et intégration API complète. Tous les parcours partagent le même compte, les mêmes moyens de paiement, le même dashboard et le même reporting — et vous pouvez les combiner librement. Ce guide vous aide à choisir le bon point de départ.
Comparaison en un coup d'œil
| Intégration | Effort de développement | Idéal pour | Où elle s'exécute |
|---|---|---|---|
| Liens de paiement et QR codes | Aucun | Factures, dons, ventes par e-mail ou réseaux sociaux, paiements QR en personne | Créés dans le dashboard, partagés comme lien ou QR code |
| Plugin | Minimal (installer et configurer) | Boutiques sur plateformes e-commerce, CMS ou logiciels métier pris en charge | Dans votre système de boutique |
| Checkout hébergé via API (Gateway) | Intégration backend | Paniers et applications sur mesure avec montants dynamiques et redirects contrôlés | Votre backend le crée ; le client paie sur la page hébergée |
| Intégration API complète | Le plus élevé | Tokenisation, préautorisation, abonnements et opérations post-paiement sur mesure | Votre backend pilote tout le cycle de vie |
Liens de paiement et QR codes — sans code
Créez un lien de paiement ou un QR code dans le dashboard, définissez le montant et le motif, puis partagez-le par e-mail, chat, facture ou impression. Le client paie sur votre page de paiement hébergée sous votre domaine tenant. C'est le moyen le plus rapide d'encaisser un premier paiement. Voir Liens de paiement et QR codes.
Plugins — peu de code
Si votre plateforme est prise en charge, préférez un plugin à un développement sur mesure : le flux de paiement est déjà implémenté et maintenu, et la configuration se limite à connecter votre instance et votre clé API. Commencez par ces vues d'ensemble :
- Intégrations e-commerce — dont le guide WooCommerce
- Intégrations CMS
- Logiciels métier
- Autres intégrations
Checkout hébergé via la Merchant API (Gateway)
Utilisez un Gateway lorsque votre backend génère des commandes avec des montants dynamiques et que vous voulez des redirects success, failed et cancel contrôlés — la page de paiement restant hébergée par FlowAlp Pay. Le flux type :
- Votre backend crée un Gateway (Créer un Gateway) avec le montant, la devise et la référence de votre commande.
- Le client paie sur la page de paiement hébergée — en redirect ou intégrée via iFrame ou modale (vue d'ensemble de l'embedding du checkout).
- Votre serveur reçoit un webhook et le vérifie (Configurer les webhooks).
- Vous ne mettez à jour la commande qu'après confirmation côté serveur.
Intégration API complète
Au-delà du checkout hébergé, la Merchant API permet de débiter des moyens de paiement enregistrés (tokenisation), de réserver puis capturer des montants (préautorisation), de gérer la facturation récurrente (abonnements) ainsi que les remboursements et annulations via la Transaction API (débit, capture, remboursement et annulation). Partez de la vue d'ensemble de la Merchant API.
Comment décider
- Pas de développeur disponible, ou paiements occasionnels : utilisez les liens de paiement et QR codes.
- Vous utilisez une plateforme de boutique standard : utilisez un plugin.
- Vous avez votre propre checkout, panier ou application : créez des Gateways via l'API.
- Vous avez besoin de cartes enregistrées, de réservations ou d'abonnements : prévoyez une intégration API complète.
Un redirect du navigateur vers votre page de succès ne prouve pas le paiement. Quel que soit le parcours choisi, confirmez chaque paiement côté serveur via les webhooks (avec vérification de signature) ou une lecture API avant d'exécuter la commande.
Décidé ? Configurez votre nom d'instance et vos identifiants API, puis envoyez votre première requête API. Sans code : passez directement aux liens de paiement et QR codes.