Intégrations
Medusa × American Express

American Express pour Medusa

American Express est une marque de cartes premium établie mondialement. 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 American Express. American Express 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 la clientèle Amex avec des paniers plus élevés
  • 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

American Express pour Medusa est utile dans de nombreux scénarios :

  • Clientèle business et premium avec cartes American Express
  • 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 American Express 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 American Express 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 American Express ?

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

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