SaaS-API-Monetisierung: Nutzungsbasierte Abrechnung

TL;DR: Nutzungsbasierte Abrechnung (nutzungsabhängige Abrechnung) belastet Kunden basierend auf ihrem API-Verbrauch – Anfragen, Speicher, Rechenzeit oder Nutzer. Stripes Integration für nutzungsbasierte Abrechnung in Kombination mit TanStack Start macht die Implementierung unkompliziert. Dieser Leitfaden behandelt die Messarchitektur, Preismodelle (pro Anfrage, gestaffelt, Überschreitung) und das Design eines Developer-Portals.

Einleitung

Nutzungsbasierte Abrechnung synchronisiert Ihren Umsatz mit dem Wert, den Kunden erhalten. Kleine Nutzer zahlen wenig; Power-User zahlen mehr. Dieses Modell ist bei API-Produkten Standard (Twilio, Stripe, OpenAI) und wird zunehmend auch von SaaS-Plattformen übernommen.

Messarchitektur

// API-Nutzungsmessung Middleware
export const meterApiUsage = defineMiddleware({
  before: async ({ request, context }) => {
    const apiKey = request.headers.get('x-api-key')
    const user = await getUserByApiKey(apiKey)

    // Nutzungsereignis erfassen
    context.metering = {
      userId: user.id,
      endpoint: request.url,
      timestamp: Date.now(),
    }
  },
  after: async ({ context }) => {
    // Nutzungszähler in D1 erhöhen
    await db.insertInto('api_usage').values({
      user_id: context.metering.userId,
      endpoint: context.metering.endpoint,
      timestamp: context.metering.timestamp,
    }).execute()
  },
})

Preismodelle

Stripe nutzungsbasierte Abrechnung

import Stripe from 'stripe'

// Nutzung an Stripe melden
await stripe.subscriptionItems.createUsageRecord(
  subscriptionItemId,
  {
    quantity: apiCalls,
    timestamp: 'now',
    action: 'increment',
  }
)

Fazit

Nutzungsbasierte Abrechnung bringt Preise in Einklang mit dem Mehrwert. Die Messinfrastruktur – Nutzung erfassen, an Stripe melden, im Dashboard anzeigen – lässt sich mit TanStack Start Server Functions und Stripes API für nutzungsbasierte Abrechnung unkompliziert umsetzen. Für eine vollständige Abrechnungsstrategie empfehlen wir unseren Stripe Billing-Leitfaden und SaaS-Preisstrategie.