PostFinance Pay für Medusa
PostFinance Pay ist die etablierte Bezahllösung der PostFinance. 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, PostFinance Pay aktivieren. Danach erscheint PostFinance Pay 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
- Vertrauter Zahlungsweg für PostFinance-Kundschaft
- Schnelle Aktivierung ohne Programmierkenntnisse
- Stabile API-Anbindung mit automatischen Statusupdates
- Offizielle Medusa-v2-Integration mit Webhooks
Anwendungsfaelle
PostFinance Pay für Medusa lohnt sich in vielen Szenarien:
- Schweizer Kundschaft, die ihr PostFinance-Konto direkt für Online-Zahlungen nutzt
- 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 PostFinance Pay 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 PostFinance Pay 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 PostFinance Pay?
Nein. PostFinance Pay aktivierst du direkt in deinem zahls.ch-Konto, ohne separaten Vertrag mit PostFinance.
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 PostFinance Pay?
Die Transaktionsgebühren hängen vom gewählten zahls.ch-Paket ab. Für die Integration selbst fallen keine Einrichtungsgebühren an.