Aperçu de FlowAlp Pay

FlowAlp Pay est la plateforme de paiement suisse de FlowAlp pour encaisser en ligne et en personne. Un seul compte marchand vous donne un checkout hébergé, des liens de paiement et QR codes, des plugins prêts à l'emploi pour les boutiques, une Merchant API REST et des options POS (point de vente) — avec des moyens de paiement suisses comme TWINT aux côtés des cartes et wallets internationaux.

Cette documentation s'adresse à deux publics : les marchands qui veulent être payés avec peu ou pas de configuration technique, et les développeurs qui intègrent les paiements dans des sites, boutiques et applications. Chaque fonctionnalité ci-dessous renvoie à un guide dédié.

Ce que propose FlowAlp Pay#

Les moyens de paiement incluent TWINT, Visa, Mastercard, American Express, PostFinance, Apple Pay, Google Pay, PayPal et Klarna. Les moyens que vous pouvez proposer dépendent de la configuration de votre compte — voir Activer les moyens de paiement.

Concepts essentiels#

Pour en savoir plus sur l'instance, voir Nom d'instance.

Deux façons d'intégrer#

Pour les marchands (sans code ou presque)#

• Créez votre compte et activez les moyens de paiement.
• Créez des liens de paiement et QR codes directement dans le dashboard et partagez-les par e-mail, chat, facture ou impression.
• Si vous utilisez une plateforme de boutique, installez un plugin — commencez par la vue d'ensemble des intégrations e-commerce ou le guide WooCommerce.

Pour les développeurs (API REST)#

1. Repérez votre nom d'instance et créez vos identifiants API.
2. Envoyez votre première requête API pour vérifier la configuration.
3. Créez un Gateway et envoyez votre client vers le checkout hébergé, ou intégrez-le — voir la vue d'ensemble de l'embedding du checkout.
4. Traitez les résultats côté serveur avec les webhooks et la vérification de signature.
5. Testez tout en mode test et parcourez la checklist de mise en production.

Explorer la documentation#

• Premiers pas — Choisir une intégration, Créer votre compte, Identifiants API
• Paiements — Accepter un paiement unique, Liens de paiement et QR codes, Abonnements
• Checkout — Vue d'ensemble de l'embedding (redirect, iFrame, modale, mobile)
• Référence API — Vue d'ensemble de la Merchant API, Authentification, Créer un Gateway
• Webhooks — Configurer les webhooks, Vérifier les signatures webhook
• Versements — Versements et réconciliation
• Intégrations — E-commerce, CMS, Logiciels métier, Autres intégrations
• Tests — Tests pour développeurs, Cartes de test et scénarios, Checklist de mise en production
• SDK — SDK PHP

URL clés#

La Merchant API prend en charge les versions v1.14, v1.15 et v1.16 ; utilisez v1.16 pour toute nouvelle intégration. Voir Versions API et changelog.