Centi für Medusa
Centi ist eine krypto-basierte Schweizer Zahlungsoption. 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, Centi aktivieren. Danach erscheint Centi 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
- Ergänzt den Mix um eine weitere Krypto-Option
- Schnelle Aktivierung ohne Programmierkenntnisse
- Stabile API-Anbindung mit automatischen Statusupdates
- Offizielle Medusa-v2-Integration mit Webhooks
Anwendungsfaelle
Centi für Medusa lohnt sich in vielen Szenarien:
- Digital affine Kundschaft mit Interesse an Krypto-Zahlungen
- 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 Centi 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 Centi 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 Centi?
Nein. Centi aktivierst du in deinem zahls.ch-Konto – ohne separaten 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 Centi?
Die Transaktionsgebühren hängen vom gewählten zahls.ch-Paket ab. Für die Integration selbst fallen keine Einrichtungsgebühren an.