Integrationen
Medusa × TWINT

TWINT für Medusa

TWINT ist die meistgenutzte Zahlungsapp der Schweiz. 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, TWINT aktivieren. Danach erscheint TWINT direkt im Checkout deines Medusa-Shops und alle Transaktionen laufen übersichtlich in deinem Dashboard zusammen.

MedusaTWINT

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

  • Hohe Conversion im Schweizer Markt
  • Schnelle Aktivierung ohne Programmierkenntnisse
  • Stabile API-Anbindung mit automatischen Statusupdates
  • Offizielle Medusa-v2-Integration mit Webhooks

Anwendungsfaelle

TWINT für Medusa lohnt sich in vielen Szenarien:

  • Schweizer Kundschaft, die mobil und per QR-Code mit der TWINT-App 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 TWINT in Medusa ein

  1. Erstelle ein Konto bei zahls.ch und schliesse die Verifizierung ab.
  2. Installiere das npm-Paket @zahls/medusa-plugin, registriere den Payment Provider in medusa-config.ts und hinterlege API-Schlüssel sowie Instanzname.
  3. Hinterlege die API-Schlüssel aus deinem zahls.ch-Dashboard in den Einstellungen der Integration.
  4. Aktiviere TWINT als Zahlungsmethode und speichere die Konfiguration.
  5. Führe im Testmodus eine Testzahlung durch und schalte den Shop anschliessend live.

FAQ

Brauche ich einen separaten Vertrag für TWINT?

Nein. Die TWINT-Akzeptanz ist in deinem zahls.ch-Konto enthalten, ein separater Akzeptanzvertrag ist nicht nötig.

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 TWINT?

Die Transaktionsgebühren hängen vom gewählten zahls.ch-Paket ab. Für die Integration selbst fallen keine Einrichtungsgebühren an.