WIR pour Medusa
WIR est le système de paiement WIR suisse pour la création de valeur locale. Combiné avec Medusa, le framework e-commerce open source pour boutiques headless, tu proposes à ta clientèle exactement le moyen de paiement qu’elle attend au checkout. Avec zahls.ch, tu relies les deux sans programmation : créer un compte, configurer l’intégration, activer WIR. WIR apparaît ensuite directement dans le checkout de ta boutique Medusa et toutes les transactions sont regroupées dans ton dashboard.
Medusa est un framework e-commerce open source pour boutiques headless : produits, panier, checkout et admin tournent en backend Node.js, connecté aux storefronts et apps custom via des API.
La connexion à zahls.ch passe par le paquet npm officiel @zahls/medusa-plugin. Tu l’installes dans le backend Medusa, tu enregistres le payment provider dans medusa-config.ts et tu saisis clé API et nom d’instance.
Les clients paient via le checkout hébergé zahls.ch (redirection). Captures, remboursements et mises à jour de statut passent par les webhooks de paiement Medusa – avec vérification HMAC optionnelle.
Medusa convient aux équipes qui gèrent une boutique headless orientée développement et ont besoin de moyens de paiement suisses comme TWINT, cartes et PostFinance.
Fonctionnalités
- Plugin npm officiel pour Medusa v2
- Checkout hébergé avec redirection
- Captures et remboursements via l’API
- Webhooks avec vérification HMAC optionnelle
- TWINT, cartes et PostFinance au checkout
Avantages
- Accès à la clientèle compatible réseau WIR
- Activation rapide sans connaissances en programmation
- Connexion API stable avec mises à jour automatiques des statuts
- Intégration Medusa v2 officielle avec webhooks
Cas d usage
WIR pour Medusa est utile dans de nombreux scénarios :
- Entreprises et clientèle suisses dans le réseau WIR
- Boutiques qui veulent réduire les abandons de panier avec des méthodes de paiement familières
- Commerçants qui souhaitent gérer transactions, remboursements et versements au même endroit
Configuration
Configurer WIR dans Medusa
- Crée un compte zahls.ch et termine la vérification.
- Installe le paquet npm @zahls/medusa-plugin, enregistre le payment provider dans medusa-config.ts et saisis clé API et nom d’instance.
- Saisis les clés API de ton dashboard zahls.ch dans les paramètres de l’intégration.
- Active WIR comme méthode de paiement et enregistre la configuration.
- Effectue un paiement test en mode test, puis passe la boutique en production.
FAQ
Ai-je besoin d’un contrat séparé pour WIR ?
Non. Tu actives WIR dans ton compte zahls.ch – sans contrat d’acquiring séparé.
Combien de temps prend la configuration dans Medusa ?
En général moins d’une heure : installer l’intégration, saisir les clés API, activer la méthode de paiement et tester.
Combien coûte l’utilisation de WIR ?
Les frais de transaction dépendent du plan zahls.ch choisi. Aucun frais d’installation n’est facturé pour l’intégration.