TWINT pour Medusa
TWINT est l’application de paiement la plus utilisée de Suisse. 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 TWINT. TWINT 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
- Conversion élevée sur le marché suisse
- 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
TWINT pour Medusa est utile dans de nombreux scénarios :
- Clientèle suisse qui paie sur mobile et par QR code avec l’app TWINT
- 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 TWINT 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 TWINT 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 TWINT ?
Non. L’acceptation TWINT est incluse dans ton compte zahls.ch, aucun contrat d’acceptation séparé n’est nécessaire.
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 TWINT ?
Les frais de transaction dépendent du plan zahls.ch choisi. Aucun frais d’installation n’est facturé pour l’intégration.