Mastercard pour Medusa
Mastercard est l’un des principaux réseaux de cartes au monde. 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 Mastercard. Mastercard 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
- Large acceptation auprès de la clientèle locale et internationale
- 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
Mastercard pour Medusa est utile dans de nombreux scénarios :
- Clients en Suisse et à l’étranger qui paient par carte de crédit ou de débit
- 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 Mastercard 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 Mastercard 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 Mastercard ?
Non. L’acceptation des cartes passe par ton compte zahls.ch, tu n’as pas besoin de ton propre contrat d’acquiring.
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 Mastercard ?
Les frais de transaction dépendent du plan zahls.ch choisi. Aucun frais d’installation n’est facturé pour l’intégration.