Intégrations
Medusa × Crypto

Crypto pour Medusa

Crypto est l’option de paiement crypto pour les monnaies numériques. 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 Crypto. Crypto 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

  • Atteins une clientèle orientée crypto
  • 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

Crypto pour Medusa est utile dans de nombreux scénarios :

  • Clientèle qui souhaite payer en cryptomonnaies
  • 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 Crypto dans Medusa

  1. Crée un compte zahls.ch et termine la vérification.
  2. Installe le paquet npm @zahls/medusa-plugin, enregistre le payment provider dans medusa-config.ts et saisis clé API et nom d’instance.
  3. Saisis les clés API de ton dashboard zahls.ch dans les paramètres de l’intégration.
  4. Active Crypto comme méthode de paiement et enregistre la configuration.
  5. Effectue un paiement test en mode test, puis passe la boutique en production.

FAQ

Ai-je besoin d’un contrat séparé pour Crypto ?

Non. Tu actives Crypto 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 Crypto ?

Les frais de transaction dépendent du plan zahls.ch choisi. Aucun frais d’installation n’est facturé pour l’intégration.