Choisir une intégration

FlowAlp Pay propose plusieurs modes d'intégration. Le choix dépend de la plateforme utilisée et du niveau de contrôle souhaité sur le checkout.

Prérequis

• Compte marchand FlowAlp Pay (inscription (https://signup.pay.flowalp.com) ou connexion (https://login.pay.flowalp.com))
• Au moins un prestataire de paiement configuré sur le compte
• Accès au code du site / boutique / application si vous intégrez via API ou embedding

Décisions rapides

Scénario | Approche recommandée | Où aller
Vous utilisez un e-commerce, CMS ou logiciel métier pris en charge | Plugin / intégration officielle ou tierce | Intégrations
Vous avez déjà une page de paiement dans le back-office et souhaitez l'afficher sur votre site | iFrame ou fenêtre modale | iFrame, Fenêtre modale
Vous avez besoin d'un checkout personnalisé (montant dynamique, redirect, panier, app) | Merchant API — Gateway | Accepter un paiement

TODO FlowAlp: creare e collegare le pagine citate se non ancora presenti

Plugins tiers

Si un plugin existe pour votre plateforme, préférez-le à une intégration sur mesure : moins de maintenance et un flux déjà testé. Guides :

• E-commerce
• CMS
• Logiciels métier

Dans certains écrans techniques, packages ou noms de plugins, vous pouvez encore voir Payrexx, car FlowAlp Pay utilise cette technologie comme infrastructure de paiement.

Intégrer une page existante

Si la page de paiement est déjà configurée dans le backend marchand et que vous n'avez pas besoin d'un flux API dynamique :

• générez ou récupérez l'URL / le snippet de la page ;
• intégrez-la via iFrame ou ouvrez-la dans une fenêtre modale ;
• pour le mobile, voir Applications mobiles.

Un redirect navigateur vers l'URL de succès ne remplace pas la vérification côté serveur du statut de paiement.

Gateway via Merchant API

Utilisez un Gateway lorsque :

• le montant de la commande et les métadonnées sont générés par votre backend ;
• vous souhaitez des redirects success / failed / cancel contrôlés ;
• vous gérez des subscriptions, la tokenization ou la pre-authorization ;
• vous intégrez un checkout personnalisé ou une application.

Flux typique :

• le backend crée un Gateway (POST /Gateway/) ;
• le client finalise le paiement sur la page FlowAlp Pay (redirect ou embed) ;
• vous recevez un webhook et/ou interrogez la Merchant API ;
• vous mettez à jour la commande uniquement après confirmation côté serveur.

Détails : Créer un Gateway et Configurer les webhooks.

Étapes suivantes

• Nom de l'instance
• Identifiants API
• Première requête API