Open Source · TypeScript

Neu: agentkit

Abos und Shop in deiner App – zahls.ch schon eingebaut.

agentkit ist das Open-Source-Billing-Framework für Schweizer Software. Abos, Rechnungen und Onlineshop laufen als TypeScript-Bibliothek in deiner eigenen App – mit TWINT, Karten und PostFinance über zahls.ch, QR-Rechnung, MWST und Texten in vier Sprachen.

agentkit.ch öffnenCode auf GitHub

Frühe Version: Beide Kits sind Vorschauen. APIs können sich zwischen Minor-Versionen noch ändern, Datenbank-Änderungen bleiben rückwärtskompatibel.

billing.ts@agentkit.ch/subkit
import { createSubscriptions } from '@agentkit.ch/subkit'import { zahlsProvider } from '@agentkit.ch/subkit/zahls' export const subscriptions = createSubscriptions({  database: drizzleAdapter(db),  provider: zahlsProvider({    instance: 'acme',    apiKey: process.env.ZAHLS_API_KEY,  }),  plans,  tax: { rateBps: 810 }, // 8.1 % MWST})

Zwei Kits, ein zahls.ch-Konto

Installiere nur, was du brauchst. Beide Kits nutzen denselben zahls.ch-Provider – ein API-Schlüssel reicht für Abos und Shop.

Abos und Rechnungen

subkit

@agentkit.ch/subkit
  • Tarife, Testphasen und anteilige Verrechnung bei Planwechseln
  • Zahlung per Karte, TWINT oder auf Rechnung mit QR-Rechnung
  • Mahnwesen, Lebenszyklus-E-Mails und druckbare Rechnungen
  • Berechtigungen im Code: hasFeature() und getLimit()
  • Bankabgleich mit camt.053 / camt.054 und <BillingPortal /> für React

Installation

npm i @agentkit.ch/subkit
DokumentationTestseite ausprobieren

Onlineshop

shopkit

@agentkit.ch/shopkit
  • Produkte und Varianten mit Lagerbestand, Warenkorb und Checkout
  • TWINT und Karte online oder Kauf auf Rechnung mit QR-Rechnung
  • MWST pro Satz, Rabattcodes, Geschenkkarten und Versandtarife
  • Bestellungen, Versand, Teilrückerstattungen und Backoffice <ShopAdmin />
  • Bestellen über den KI-Agenten deiner Kundschaft (MCP)

Installation

npm i @agentkit.ch/shopkit
DokumentationTestseite ausprobieren

So verbindest du agentkit mit zahls.ch

1. Konto und API-Schlüssel

Erstelle dein zahls.ch-Konto und generiere im Dashboard einen API-Schlüssel – ohne Einrichtungskosten.

2. zahlsProvider eintragen

Übergib Instanz und API-Schlüssel an zahlsProvider() – agentkit erstellt Zahlungsseiten und belastet gespeicherte Zahlungsmittel selbst.

3. Webhook hinterlegen

Lege im zahls.ch-Dashboard einen JSON-Webhook auf den Handler des Kits an. Zahlungen und Abostatus bleiben so automatisch synchron.

Darum agentkit

Deine Datenbank

Adapter schreiben in deine eigenen Tabellen (Drizzle für Postgres). Kein gehosteter Dienst dazwischen.

Konfiguration im Code

Ein Aufruf von createSubscriptions() oder createShop() – versioniert und im Pull Request prüfbar.

Schweiz zuerst

QR-Rechnung, TWINT, MWST, Beträge in Rappen und Texte auf Deutsch, Französisch, Italienisch und Englisch.

Bereit für KI-Agenten

llms.txt, ein Docs-MCP-Server und MCP-Handler pro Kit – für dein Team und, im Shop, für deine Kundschaft.

Bereit für die erste Zahlung?

Mit einem kostenlosen zahls.ch-Konto testest du agentkit sofort mit echten Schweizer Zahlungsmethoden.

Kostenlos registrierenGuides ansehen