Guide du plugin WooCommerce

Ce guide relie une boutique WooCommerce à FlowAlp Pay de bout en bout : activation de l'intégration dans le dashboard, installation et connexion du plugin, configuration des moyens de paiement et validation par une commande de test. Le plugin apporte le support multi-devises, les icônes de moyens de paiement dans le checkout, la transmission du panier, les mises à jour de statut par webhook, la configuration du look & feel, les réglages par moyen, le support des subscriptions et la synchronisation des remboursements.

Prérequis#

• Une installation WordPress et WooCommerce récente — la fiche du plugin indique la plage de versions testée
• Un compte FlowAlp Pay avec accès au dashboard sur https://pay.flowalp.com (créer votre compte)
• L'intégration WooCommerce disponible dans votre dashboard — la disponibilité dépend de la configuration de votre compte
• Une boutique accessible publiquement en HTTPS avec un certificat valide

Étape 1 — Activer l'intégration dans FlowAlp Pay#

1. Connectez-vous sur https://pay.flowalp.com et ouvrez API & Plugins.
2. Sous Ajouter une intégration e-commerce, cliquez sur Tout afficher et ajoutez WooCommerce.
3. Le panneau affiche l'API key émise pour cette connexion et votre [nom d'instance](/fr/docs/flowalp-pay-instance-name-fr/).
4. Saisissez l'adresse de la boutique — l'URL exacte du storefront. Si la boutique vit dans un sous-répertoire, indiquez le chemin complet, p. ex. https://mon-site.example/shop.
5. Décidez si les webhooks échoués doivent être retentés : jusqu'à 10 tentatives après 5 minutes, 15 minutes, 1 heure, 2 heures, 4 heures puis toutes les 24 heures.
6. Cliquez sur Activer pour terminer.

Étape 2 — Installer le plugin dans WordPress#

1. Dans WordPress, allez dans Extensions → Ajouter une extension.
2. Installez le plugin de paiement WooCommerce de votre compte FlowAlp Pay — le panneau d'intégration du dashboard renvoie vers la bonne fiche.
3. Cliquez sur Installer maintenant, puis sur Activer.

Étape 3 — Connecter le plugin à votre compte#

Ouvrez WooCommerce → Réglages et passez sur l'onglet de la plateforme de paiement ajouté par le plugin. Sélectionnez l'entrée de plateforme, saisissez votre nom d'instance — le sous-domaine de l'URL de votre page de paiement, donc demo-shop pour demo-shop.pay.flowalp.com — et lancez la connexion. Vous êtes redirigé vers le login FlowAlp Pay sur https://login.pay.flowalp.com ; après connexion, la boutique et le compte sont liés automatiquement.

Si votre version du plugin affiche des champs d'identifiants manuels au lieu de l'assistant, collez le nom d'instance et l'API key exactement tels que les affiche le panneau d'intégration du dashboard.

Étape 4 — Activer et mapper les moyens de paiement#

1. Allez dans WooCommerce → Réglages → Paiements — chaque moyen de paiement apparaît comme une entrée distincte.
2. Activez ou désactivez les moyens via le menu aux trois points.
3. Cliquez sur Gérer pour un moyen afin de définir titre, description et — lorsque c'est proposé — le support des subscriptions.
4. Enregistrez vos modifications.

Un moyen n'apparaît au checkout que s'il est aussi actif sur votre compte FlowAlp Pay et qu'il supporte la devise de la boutique. Les configurations suisses typiques incluent TWINT, Visa, Mastercard, American Express, PostFinance, Apple Pay, Google Pay, PayPal et Klarna — la disponibilité dépend de la configuration de votre compte ; voir moyens de paiement.

Étape 5 — Effectuer une commande de test#

1. Passez en mode TEST comme décrit dans Tests pour développeurs.
2. Mettez un produit dans le panier et passez au checkout.
3. Sélectionnez un moyen de paiement — WooCommerce redirige vers la page de paiement FlowAlp Pay.
4. Payez avec les cartes ou identifiants de test.
5. Vérifiez les résultats : le navigateur revient sur la page de confirmation de la boutique, la commande WooCommerce change de statut, la transaction apparaît dans le dashboard et le journal des webhooks enregistre une réponse 200.

Subscriptions et paiements récurrents#

Pour vendre des produits récurrents, installez et activez le plugin WooCommerce Subscriptions. Deux modèles de renouvellement existent : avec le renouvellement automatique, le moyen de paiement enregistré est débité à l'échéance — seuls certains moyens le permettent. Avec le renouvellement manuel, le client reçoit un e-mail contenant un lien de paiement pour chaque échéance — cela fonctionne avec tous les moyens de votre compte. Si vous ne voulez aucun paiement récurrent, désactivez la fonction sous WooCommerce → Réglages → Subscriptions. Contexte côté facturation : abonnements et paiements récurrents.

Remboursements#

Effectuez les remboursements totaux ou partiels dans le dashboard FlowAlp Pay. Une fois terminé, le remboursement est automatiquement communiqué à WooCommerce et apparaît sur la commande.

Dépannage#

FAQ#

• Où trouver le nom d'instance et l'API key ? Dans le dashboard sous API & Plugins, dans le panneau de l'intégration WooCommerce — voir aussi identifiants API.
• Puis-je tester sans débiter d'argent réel ? Oui — utilisez le mode TEST avec les cartes de test et effectuez au moins un paiement réussi et un paiement échoué.
• Le plugin supporte-t-il plusieurs devises ? Oui. Chaque moyen de paiement doit toutefois supporter la devise utilisée.
• Le checkout reste-t-il dans ma boutique ? Le plugin utilise le flux de redirection vers la page de paiement hébergée ; pour les variantes intégrées sur des pages personnalisées, voir l'aperçu du checkout.
• Un client ou une subscription a disparu — le plugin de paiement l'a-t-il supprimé ? Non. Le plugin ne modifie jamais les données clients dans WooCommerce ; vérifiez le plugin Subscriptions ou des changements manuels d'utilisateurs WordPress.