Mastercard für Medusa
Mastercard ist eines der weltweit führenden Kartennetzwerke. In Kombination mit Medusa, dem Open-Source-Commerce-Framework für Headless-Shops, bietest du deiner Kundschaft im Checkout genau den Zahlungsweg, den sie erwartet. Mit zahls.ch verbindest du beide ohne Programmieraufwand: Konto erstellen, Integration einrichten, Mastercard aktivieren. Danach erscheint Mastercard direkt im Checkout deines Medusa-Shops und alle Transaktionen laufen übersichtlich in deinem Dashboard zusammen.
Medusa ist ein Open-Source-Commerce-Framework für Headless-Shops: Produkte, Warenkorb, Checkout und Admin laufen als Node.js-Backend, das Storefront und Custom-Apps über APIs anbindet.
Die Anbindung an zahls.ch läuft über das offizielle npm-Paket @zahls/medusa-plugin. Du installierst es im Medusa-Backend, registrierst den Payment Provider in medusa-config.ts und hinterlegst API-Schlüssel sowie Instanzname.
Kundinnen und Kunden bezahlen über den gehosteten Checkout von zahls.ch (Redirect). Captures, Rückerstattungen und Statusupdates laufen über die Medusa-Payment-Webhooks – optional mit HMAC-Signaturprüfung.
Medusa eignet sich für Teams, die einen entwicklergetriebenen, headless Shop betreiben und Schweizer Zahlungsmethoden wie TWINT, Karten und PostFinance brauchen.
Funktionen
- Offizielles npm-Plugin für Medusa v2
- Gehosteter Checkout mit Redirect
- Captures und Rückerstattungen über die API
- Webhooks mit optionaler HMAC-Prüfung
- TWINT, Karten und PostFinance im Checkout
Vorteile
- Breite Akzeptanz bei in- und ausländischer Kundschaft
- Schnelle Aktivierung ohne Programmierkenntnisse
- Stabile API-Anbindung mit automatischen Statusupdates
- Offizielle Medusa-v2-Integration mit Webhooks
Anwendungsfaelle
Mastercard für Medusa lohnt sich in vielen Szenarien:
- Kundschaft im In- und Ausland, die mit Kredit- oder Debitkarte bezahlt
- Shops, die ihre Abbruchrate im Checkout mit vertrauten Zahlungsmethoden senken wollen
- Händlerinnen und Händler, die Transaktionen, Rückerstattungen und Auszahlungen an einem Ort verwalten möchten
Setup
So richtest du Mastercard in Medusa ein
- Erstelle ein Konto bei zahls.ch und schliesse die Verifizierung ab.
- Installiere das npm-Paket @zahls/medusa-plugin, registriere den Payment Provider in medusa-config.ts und hinterlege API-Schlüssel sowie Instanzname.
- Hinterlege die API-Schlüssel aus deinem zahls.ch-Dashboard in den Einstellungen der Integration.
- Aktiviere Mastercard als Zahlungsmethode und speichere die Konfiguration.
- Führe im Testmodus eine Testzahlung durch und schalte den Shop anschliessend live.
FAQ
Brauche ich einen separaten Vertrag für Mastercard?
Nein. Die Kartenakzeptanz läuft über dein zahls.ch-Konto, du brauchst keinen eigenen Acquiring-Vertrag.
Wie lange dauert die Einrichtung in Medusa?
In der Regel weniger als eine Stunde: Integration installieren, API-Schlüssel hinterlegen, Zahlungsmethode aktivieren und testen.
Was kostet die Nutzung von Mastercard?
Die Transaktionsgebühren hängen vom gewählten zahls.ch-Paket ab. Für die Integration selbst fallen keine Einrichtungsgebühren an.