Open source · TypeScript

Nouveau : agentkit

Abonnements et boutique dans ton app – zahls.ch déjà intégré.

agentkit est le framework de facturation open source pour les logiciels suisses. Abonnements, factures et boutique en ligne tournent comme bibliothèque TypeScript dans ta propre app – avec TWINT, cartes et PostFinance via zahls.ch, QR-facture, TVA et textes en quatre langues.

Ouvrir agentkit.chCode sur GitHub

Version précoce : les deux kits sont des aperçus. Les API peuvent encore changer entre versions mineures ; les changements de base de données restent rétrocompatibles.

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})

Deux kits, un compte zahls.ch

Installe seulement ce dont tu as besoin. Les deux kits utilisent le même provider zahls.ch – une clé API suffit pour les abonnements et la boutique.

Abonnements et factures

subkit

@agentkit.ch/subkit
  • Plans, périodes d’essai et prorata lors des changements de plan
  • Paiement par carte, TWINT ou sur facture avec QR-facture
  • Relances, e-mails de cycle de vie et factures imprimables
  • Droits dans le code : hasFeature() et getLimit()
  • Rapprochement bancaire avec camt.053 / camt.054 et <BillingPortal /> pour React

Installation

npm i @agentkit.ch/subkit
DocumentationEssayer le site de test

Boutique en ligne

shopkit

@agentkit.ch/shopkit
  • Produits et variantes avec stock, panier et checkout
  • TWINT et carte en ligne, ou paiement sur facture avec QR-facture
  • TVA par taux, codes de réduction, cartes cadeaux et tarifs d’envoi
  • Commandes, expédition, remboursements partiels et back-office <ShopAdmin />
  • Commandes via l’agent IA de ta clientèle (MCP)

Installation

npm i @agentkit.ch/shopkit
DocumentationEssayer le site de test

Connecter agentkit à zahls.ch

1. Compte et clé API

Crée ton compte zahls.ch et génère une clé API dans le dashboard – sans frais d’installation.

2. Configurer zahlsProvider

Passe ton instance et ta clé API à zahlsProvider() – agentkit crée les pages de paiement et débite lui-même les moyens de paiement enregistrés.

3. Ajouter le webhook

Ajoute dans le dashboard zahls.ch un webhook JSON vers le handler du kit. Paiements et statut des abonnements restent synchronisés automatiquement.

Pourquoi agentkit

Ta base de données

Les adaptateurs écrivent dans tes propres tables (Drizzle pour Postgres). Aucun service hébergé entre les deux.

Configuration dans le code

Un appel à createSubscriptions() ou createShop() – versionné et vérifiable dans une pull request.

La Suisse d’abord

QR-facture, TWINT, TVA, montants en centimes et textes en allemand, français, italien et anglais.

Prêt pour les agents IA

llms.txt, un serveur MCP de documentation et un handler MCP par kit – pour ton équipe et, dans la boutique, pour ta clientèle.

Prêt pour le premier paiement ?

Avec un compte zahls.ch gratuit, tu testes agentkit tout de suite avec de vrais moyens de paiement suisses.

S’inscrire gratuitementVoir les guides