Open source · TypeScript

Novità: agentkit

Abbonamenti e negozio nella tua app – con zahls.ch già integrato.

agentkit è il framework di fatturazione open source per il software svizzero. Abbonamenti, fatture e negozio online funzionano come libreria TypeScript nella tua app – con TWINT, carte e PostFinance tramite zahls.ch, QR-fattura, IVA e testi in quattro lingue.

Apri agentkit.chCodice su GitHub

Versione iniziale: entrambi i kit sono anteprime. Le API possono ancora cambiare tra versioni minori; le modifiche al database restano retrocompatibili.

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

Due kit, un conto zahls.ch

Installa solo ciò che ti serve. Entrambi i kit usano lo stesso provider zahls.ch – una chiave API basta per abbonamenti e negozio.

Abbonamenti e fatture

subkit

@agentkit.ch/subkit
  • Piani, periodi di prova e calcolo pro rata al cambio di piano
  • Pagamento con carta, TWINT o su fattura con QR-fattura
  • Solleciti, e-mail del ciclo di vita e fatture stampabili
  • Autorizzazioni nel codice: hasFeature() e getLimit()
  • Riconciliazione bancaria con camt.053 / camt.054 e <BillingPortal /> per React

Installazione

npm i @agentkit.ch/subkit
DocumentazioneProva il sito di test

Negozio online

shopkit

@agentkit.ch/shopkit
  • Prodotti e varianti con magazzino, carrello e checkout
  • TWINT e carta online, o pagamento su fattura con QR-fattura
  • IVA per aliquota, codici sconto, carte regalo e tariffe di spedizione
  • Ordini, spedizione, rimborsi parziali e back office <ShopAdmin />
  • Ordini tramite l’agente IA della tua clientela (MCP)

Installazione

npm i @agentkit.ch/shopkit
DocumentazioneProva il sito di test

Collegare agentkit a zahls.ch

1. Conto e chiave API

Crea il tuo conto zahls.ch e genera una chiave API nella dashboard – senza costi di attivazione.

2. Configurare zahlsProvider

Passa istanza e chiave API a zahlsProvider() – agentkit crea le pagine di pagamento e addebita da solo i metodi di pagamento salvati.

3. Aggiungere il webhook

Aggiungi nella dashboard zahls.ch un webhook JSON verso l’handler del kit. Pagamenti e stato degli abbonamenti restano sincronizzati automaticamente.

Perché agentkit

Il tuo database

Gli adapter scrivono nelle tue tabelle (Drizzle per Postgres). Nessun servizio ospitato in mezzo.

Configurazione nel codice

Una chiamata a createSubscriptions() o createShop() – versionata e verificabile in una pull request.

Prima la Svizzera

QR-fattura, TWINT, IVA, importi in centesimi e testi in tedesco, francese, italiano e inglese.

Pronto per gli agenti IA

llms.txt, un server MCP per la documentazione e un handler MCP per kit – per il tuo team e, nel negozio, per la tua clientela.

Pronto per il primo pagamento?

Con un conto zahls.ch gratuito provi subito agentkit con veri metodi di pagamento svizzeri.

Registrati gratisVedi le guide