Integrations
E-commerce

Medusa

Open-source commerce framework for headless shops

E-commerceSetup: Advanced
Medusa

Medusa is an open-source commerce framework for headless shops: products, cart, checkout, and admin run as a Node.js backend that connects storefronts and custom apps via APIs.

The connection to zahls.ch uses the official npm package @zahls/medusa-plugin. You install it in the Medusa backend, register the payment provider in medusa-config.ts, and enter your API key plus instance name.

Customers pay via the hosted zahls.ch checkout (redirect). Captures, refunds, and status updates run through Medusa payment webhooks – optionally with HMAC signature verification.

Medusa suits teams running a developer-driven headless store that need Swiss payment methods such as TWINT, cards, and PostFinance.

Features

  • Official npm plugin for Medusa v2
  • Hosted checkout with redirect
  • Captures and refunds via the API
  • Webhooks with optional HMAC verification
  • TWINT, cards and PostFinance at checkout

Ready to integrate?

Get started and integrate zahls.ch with Medusa.