Communitygithub.com

deangilmoreremix/videoremix.vip2

Clerk-Abrechnung für Abonnementverwaltung – rendert Clerks PricingTable und den In-App-Checkout-Drawer, konfiguriert Abonnementpläne, Sitzungsbeschränkungspläne für B2B, Feature-Berechtigungen mit has() und Abrechnungs-Webhooks. Verwendung für SaaS-Monetarisierung, Plan-Gating, Checkout-Abläufe, Testphasen, Rechnungsstellung und Abonnement-Lebenszyklusverwaltung.

Was ist videoremix.vip2?

Diese Skill-Anleitung behandelt die vollständige Abrechnungskonfiguration und -integration mit Clerk, dem Authentifizierungs- und Benutzerverwaltungsdienst. Sie erklärt, wie die Abrechnung aktiviert wird (entweder über das Clerk-Dashboard oder das CLI mit `clerk enable billing`), wie Pläne und Funktionen erstellt werden, und wie die Komponenten `<PricingTable />` und `<CheckoutButton />` gerendert werden, damit Benutzer Abos auswählen und abschließen können. Der Leitfaden behandelt sowohl B2C-Muster (einzelne Benutzerabos) als auch B2B-Muster (Organisationsabos mit Sitzungslimits), einschließlich serverseitiger und clientseitiger Berechtigungsprüfungen mit `has({ plan })` und `has({ feature })`. Außerdem wird beschrieben, wie Abrechnungs-Webhooks zur Behandlung von Ereignissen des Abo-Lebenszyklus eingerichtet werden, mit einer vollständigen Ereignistabelle, die Clerk-Ereignisnamen den Stripe-Äquivalenten gegenüberstellt. Die Anleitung enthält Referenzen zu detaillierten Mustern für B2C, B2B und Webhooks sowie eine programmatische Abrechnungskonfiguration über CLI-Befehle für agentengesteuerte Einsätze. Die Skill-Anleitung hebt hervor, dass sie experimentell ist, dass `@clerk/nextjs` und `clerk-js` versionsgebunden werden müssen und dass die Abrechnung aktiviert sein muss, bevor eine der Komponenten oder Prüfungen funktioniert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deangilmoreremix/videoremix.vip2/tree/HEAD/.agents/skills/clerk-billing

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Abrechnung

STOPP, Voraussetzung. Die Abrechnung muss aktiviert sein, bevor <PricingTable />, <CheckoutButton />, has({ plan }) oder has({ feature }) verwendet werden können. Zwei Wege: (1) Dashboard → Abrechnung → Einstellungen, oder (2) clerk enable billing (siehe "Agent-first: Programmatische Abrechnungskonfiguration" unten). Die Aktivierung erstellt automatisch die Standardpläne free_user / free_org. Dev-Instanzen können das gemeinsame Clerk-Entwicklungsgateway verwenden (kein Stripe-Konto erforderlich); die Produktion erfordert ein Stripe-Konto nur für die Zahlungsabwicklung.

Hinweis: Die Abrechnungs-APIs sind noch experimentell. Sichern Sie Ihre Versionen von @clerk/nextjs und clerk-js. Siehe clerk-Skill für die unterstützte Versionstabelle.

Kurzanleitung

  1. Abrechnung aktivieren, via Dashboard → Abrechnung → Einstellungen oder clerk enable billing (siehe Abschnitt Agent-first). Das Überspringen führt in der Entwicklung zu cannot_render_billing_disabled und in der Produktion zu einer leeren Ansicht.

  2. Pläne im passenden Tab erstellen, Dashboard → Abrechnung → Pläne. Zwei Tabs, Slugs sind pro Tab begrenzt, nach der Erstellung nicht verschiebbar:

    • Benutzerpläne → <PricingTable /> (Standard for="user")
    • Organisationspläne → <PricingTable for="organization" />

    Der falsche Tab ist die häufigste Ursache für ein leeres <PricingTable />. Pläne leben in Clerk; nicht mit Stripe synchronisiert.

  3. Funktionen innerhalb eines Plans hinzufügen, öffnen Sie den Plan im Dashboard → Abrechnung → Pläne, nutzen Sie den Bereich "Funktionen". Funktionen sind pro Plan begrenzt, nicht global. Derselbe Slug kann mehreren Plänen zugeordnet werden; has({ feature: 'export' }) trifft zu, wenn der aktive Plan diesen Slug enthält.

  4. <PricingTable /> rendern (übergeben Sie for="organization" für B2B).

  5. Zugriff steuern mit has({ plan }) oder has({ feature }) aus auth().

  6. Abrechnungs-Webhooks behandeln für den Abonnement-Lebenszyklus.

Dashboard-Shortcuts

AktionURL
Abrechnung aktivierenhttps://dashboard.clerk.com/last-active?path=billing/settings
Pläne erstellen / bearbeitenhttps://dashboard.clerk.com/last-active?path=billing/plans
Mitgliedschaftsmodus (B2C + B2B-Koexistenz)https://dashboard.clerk.com/last-active?path=organizations-settings
Funktionen bearbeitenPläne → Klicken Sie auf einen Plan → Bereich "Funktionen" (keine direkte URL)

Agent-first: Programmatische Abrechnungskonfiguration

Die vollständige Abrechnungskonfiguration (Aktivierungsumschalter, Pläne, Funktionen, Plan-Funktions-Zuordnungen) ist über PLAPI bearbeitbar, ohne das Dashboard zu berühren. Nützlich für Agenten, die Pläne anlegen, Konfigurationen über Instanzen replizieren oder die Abrechnungsstruktur versionieren.

Voraussetzung: Projekt mit der Clerk-App verknüpft (clerk auth login + clerk link, siehe clerk-setup).

Abrechnung via CLI aktivieren

clerk enable billing                # beide Ziele (Standard, erstellt automatisch free_user + free_org-Pläne)
clerk enable billing --for org      # nur Organisation
clerk enable billing --for user     # nur Benutzer

Aktuelle Abrechnungskonfiguration abrufen

clerk config pull --keys billing > billing.json

Dies schreibt die aktuelle Abrechnungskonfiguration (Umschalter + Pläne + Funktionen) für die verknüpfte Instanz in billing.json.

Bearbeiten und anwenden

Bearbeiten Sie billing.json, um Pläne oder Funktionen hinzuzufügen/zu entfernen, zeigen Sie dann den Diff an und wenden Sie ihn an:

clerk config patch --file billing.json --dry-run
clerk config patch --file billing.json

Übergeben Sie --instance prod, um die Produktionsinstanz statt der Dev-Instanz anzusprechen.

Raw PATCH (volle Kontrolle)

Für einmalige Plan-/Funktionsaktualisierungen ohne Konfigurationsdatei:

clerk api --platform PATCH /v1/platform/applications/<app_id>/instances/<ins_id>/config \
  -d '{"billing":{"plans":[{"slug":"pro","name":"Pro","amount":2000,"currency":"usd","payer_type":"user","is_recurring":true}],"features":[{"slug":"export","name":"Export"}]}}'

Hinweise

  • Dies behandelt die Abrechnungskonfiguration (Umschalter + Pläne + Funktionskatalog). Der Abonnement-Lebenszyklus (Benutzer wählen einen Plan, Checkout, Verlängerung, Kündigung) läuft weiterhin über <PricingTable /> + Abrechnungs-Webhooks, siehe clerk-webhooks-Skill für die Lebenszyklus-Ereignisse.
  • Die Manipulation des Top-Level-features-Maps und Plan-Funktions-Zuordnungen (Sync) werden vollständig über den PLAPI-Abrechnungskonfigurations-Handler unterstützt.

Was brauchen Sie?

AufgabeReferenz
<PricingTable />-Props, <CheckoutButton />, <Show>-Abrechnungsmusterreferences/billing-components.md
B2C-Muster (einzelne Benutzerabos, vorausgesetzte Membership optional)references/b2c-patterns.md
B2B-Muster (Organisationsabos, Sitzungsbeschränkungspläne, admin-gesteuerte Abrechnungs-UI)references/b2b-patterns.md
Webhook-Ereigniskatalog, Payload-Formate, Handler-Vorlagenreferences/billing-webhooks.md

Referenzen

ReferenzBeschreibung
references/billing-components.md<PricingTable /> und Abonnement-UI
references/b2c-patterns.mdB2C-Abonnement-Abrechnungsmuster
references/b2b-patterns.mdB2B-Abrechnung mit Organisationsabos und Sitzungsbeschränkungsplänen
references/billing-webhooks.mdEreignisbehandlung des Abonnement-Lebenszyklus

Dokumentation

Funktionen vs. Pläne: Wann verwenden Sie was

Verwenden Sie has({ feature: 'slug' }), wenn Sie eine bestimmte Fähigkeit sperren, Export, Analysen, API-Zugriff, Audit-Logs.

Verwenden Sie has({ plan: 'slug' }), wenn Sie eine Stufe sperren, das Pro-Dashboard anzeigen, die Organisations-Abonnementstufe prüfen, kostenlose Benutzer umleiten.

SzenarioKorrekte Prüfung
"Export CSV"-Button sperrenhas({ feature: 'export' })
"Analysen"-Abschnitt sperrenhas({ feature: 'analytics' })
Alle von /dashboard/pro sperrenhas({ plan: 'pro' })
Prüfen, ob die Organisation ein Team-Abo hathas({ plan: 'org:team' })
SSO-Konfiguration sperrenhas({ feature: 'sso' })

Wenn ein Benutzer sagt "sperre die Export-Funktion" oder "sperre die Analysen", verwenden Sie immer has({ feature }). Verwenden Sie has({ plan }) nur, wenn die Sperre die Planstufe selbst ist, nicht eine bestimmte Fähigkeit darin.

Schlüsselmuster

1. Preistabelle rendern

Zeigen Sie Benutzern verfügbare Pläne mit einer einzigen Komponente an:

import { PricingTable } from '@clerk/nextjs'

export default function PricingPage() {
	return (
		<main>
			<h1>Wählen Sie einen Plan</h1>
			<PricingTable />
		</main>
	)
}

<PricingTable /> rendert automatisch alle konfigurierten Pläne aus dem Clerk-Dashboard. Die Auswahl eines Plans öffnet den In-App-Checkout-Drawer von Clerk. Keine Props für die Basisnutzung erforderlich. Für B2B übergeben Sie for="organization", um organisationsspezifische Pläne statt Benutzerpläne anzuzeigen.

2. Feature-Berechtigungen prüfen (serverseitig)

Sperren Sie nach einzelnen Funktionen, dies ist der bevorzugte Ansatz für spezifische Fähigkeiten:

import { auth } from '@clerk/nextjs/server'

export default async function AnalyticsPage() {
	const { has } = await auth()

	const canViewAnalytics = has({ feature: 'analytics' })
	const canExport = has({ feature: 'export' })

	return (
		<div>
			{canViewAnalytics && <AnalyticsChart />}
			{canExport && <ExportButton />}
		</div>
	)
}

Funktionen werden im Clerk-Dashboard → Abrechnung → Funktionen konfiguriert und Plänen zugewiesen. Verwenden Sie has({ feature }) anstelle von has({ plan }), wenn Sie granulare Fähigkeiten sperren – prüfen Sie die Funktion, nicht den Plan.

3. Feature-Berechtigungen prüfen (clientseitig)

Verwenden Sie useAuth() für clientseitiges Feature-Gating. Kombinieren Sie es mit serverseitigen Prüfungen für vollständige Abdeckung:

'use client'
import { useAuth } from '@clerk/nextjs'

export function FeatureGatedUI() {
	const { has, isLoaded } = useAuth()
	if (!isLoaded) return null

	const canExport = has?.({ feature: 'export' })
	const canAnalytics = has?.({ feature: 'analytics' })

	return (
		<div>
			{canAnalytics && <AnalyticsSection />}
			{canExport ? <ExportButton /> : <UpgradeToExport />}
		</div>
	)
}

Server-Komponenten verwenden auth(), Client-Komponenten verwenden useAuth(). Beide unterstützen has({ feature }) und has({ plan }).

4. Abonnementplan serverseitig prüfen

Sperren Sie den Zugriff nach Abonnementplan (verwenden Sie dies für stufenbezogene Sperren, nicht für einzelne Funktionen):

import { auth } from '@clerk/nextjs/server'
import { redirect } from 'next/navigation'

export default async function ProDashboard() {
	const { has } = await auth()

	if (!has({ plan: 'pro' })) {
		redirect('/pricing')
	}

	return <ProFeatures />
}

5. Clientseitige Planprüfungen

Verwenden Sie den useAuth()-Hook für Client-Komponenten:

'use client'
import { useAuth } from '@clerk/nextjs'

export function UpgradePrompt() {
	const { has } = useAuth()

	if (has?.({ plan: 'pro' })) {
		return null
	}

	return (
		<div>
			<p>Upgraden Sie auf Pro, um auf diese Funktion zuzugreifen</p>
			<a href="/pricing">Pläne anzeigen</a>
		</div>
	)
}

6. B2B-Sitzungsbasierte Abrechnung mit Organisationen

Organisationspläne können ein Sitzungslimit (Mitgliederbeschränkung) enthalten, das Clerk bei der Einladung durchsetzt. Verwenden Sie das org:-Slug-Präfix bei organisationsseitigen Planprüfungen (z. B. has({ plan: 'org:team' })), um das Gating eindeutig zu halten. Rendern Sie die B2B-Preisseite mit <PricingTable for="organization" /> und verwenden Sie <OrganizationProfile /> für die Organisations-Abrechnungs-UI.

Siehe references/b2b-patterns.md für gestaffelte Planbenennung, Sitzungslimit-Invarianten, Admin-only-Abrechnung und Webhook-Handler.

7. Abonnementstatus anzeigen

Prüfen Sie bestimmte Pläne mit has({ plan }), oder verwenden Sie useSubscription() für vollständige Abonnementdetails in Client-Komponenten. Lesen Sie Planinformationen nicht direkt aus sessionClaims, das ist nicht der unterstützte Weg.

Server-Komponente, Prüfung auf bestimmte Pläne:

import { auth } from '@clerk/nextjs/server'

export default async function AccountPage() {
	const { has } = await auth()

	const currentPlan = has({ plan: 'pro' })
		? 'pro'
		: has({ plan: 'starter' })
			? 'starter'
			: 'free'

	return (
		<div>
			<h2>Aktueller Plan</h2>
			<p>Sie sind im {currentPlan}-Plan</p>
			{currentPlan === 'free' && <a href="/pricing">Upgraden</a>}
		</div>
	)
}

Client-Komponente, vollständige Abonnementdetails via useSubscription():

'use client'
import { useSubscription } from '@clerk/nextjs/experimental'

export function SubscriptionDetails() {
	const { data: subscription, isLoading } = useSubscription()
	if (isLoading) return null
	if (!subscription) return <a href="/pricing">Plan wählen</a>

	return (
		<div>
			<p>Status: {subscription.status}</p>
			{subscription.nextPayment && (
				<p>Nächste Zahlung: {subscription.nextPayment.date.toLocaleDateString()}</p>
			)}
		</div>
	)
}

useSubscription() dient nur der Anzeige. Für Autorisierungsprüfungen (Sperren von Inhalten oder Routen) verwenden Sie immer has({ plan }) oder has({ feature }).

8. API-Routen nach Plan schützen

Sperren Sie API-Routen mit auth():

import { auth } from '@clerk/nextjs/server'
import { NextResponse } from 'next/server'

export async function GET() {
	const { has } = await auth()

	if (!has({ plan: 'pro' })) {
		return NextResponse.json({ error: 'Pro-Plan erforderlich' }, { status: 403 })
	}

	return NextResponse.json({ data: 'premium data' })
}

9. Abrechnungs-Webhooks behandeln

Clerk-Ereignisnamen unterscheiden sich von Stripe-Ereignisnamen. Clerk-Abrechnungs-Webhooks verwenden Punktnotation und camelCase, nicht das Unterstrichensformat von Stripe.

Es gibt kein subscription.canceled-Ereignis. Die Kündigung erfolgt auf Elementebene als subscriptionItem.canceled.

AbsichtStripe-EreignisnameClerk-Ereignisname
Abonnement erstelltcustomer.subscription.createdsubscription.created
Abonnement aktualisiertcustomer.subscription.updatedsubscription.updated
Abonnement aktiv(keines)subscription.active
Abonnement überfällig(keines)subscription.pastDue
Abonnement-Element gekündigtcustomer.subscription.deletedsubscriptionItem.canceled
Abonnement-Element überfälliginvoice.payment_failedsubscriptionItem.pastDue
Abonnement-Element aktualisiert(keines)subscriptionItem.updated
Abonnement-Element aktiv(keines)subscriptionItem.active
Abonnement-Element bevorstehende Verlängerung(keines)subscriptionItem.upcoming
Abonnement-Element beendet(keines)subscriptionItem.ended
Abonnement-Element aufgegeben(keines)subscriptionItem.abandoned
Abonnement-Element abgelaufen(keines)subscriptionItem.expired
Abonnement-Element unvollständig(keines)subscriptionItem.incomplete
Kostenlose Testversion endet bald(keines)subscriptionItem.freeTrialEnding
Zahlungsversuch erstellt(keines)paymentAttempt.created
Zahlungsversuch aktualisiert(keines)paymentAttempt.updated

Verwenden Sie immer Clerk-Ereignisnamen, niemals Stripe, in evt.type-Prüfungen.

Payload-Format. Clerk-Abrechnungs-Webhook-Payloads sind verschachtelt. Die abonnierende Entität befindet sich unter evt.data.payer (Felder: user_id?, organization_id?). Die Planinformationen befinden sich auf jedem Element unter evt.data.items[i].plan.slug. Die Abonnement-ID ist einfach evt.data.id. Abonnement-Elemente haben kein subscription_id-Feld als Rückverweis, daher identifizieren Sie in subscriptionItem.*-Handlern den Datensatz durch die Element-ID (evt.data.id) oder suchen nach Zahler plus Plan.

Minimaler Handler zur Verankerung des Musters (importieren von @clerk/nextjs/webhooks, verifizieren, nach Clerk-Ereignisnamen verzweigen):

import { verifyWebhook } from '@clerk/nextjs/webhooks'
import { NextRequest } from 'next/server'
import { db } from '@/lib/db'

export async function POST(req: NextRequest) {
	let evt
	try {
		evt = await verifyWebhook(req)
	} catch {
		return new Response('Verifizierung fehlgeschlagen', { status: 400 })
	}

	if (evt.type === 'subscription.created') {
		const { id, payer, items, status } = evt.data
		const entityId = p

…

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

deangilmoreremix/videoremix.vip2

Implement Clerk authentication for native Android apps using Kotlin and Jetpack Compose with clerk-android source-guided patterns. Use for prebuilt AuthView/UserButton or custom API-driven auth flows. Do not use for Expo or React Native projects.

deangilmoreremix/videoremix.vip2

Astro patterns with Clerk — middleware, SSR pages, island components, API routes, static vs SSR rendering. Triggers on: astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

deangilmoreremix/videoremix.vip2

Clerk Backend REST API explorer and executor. Browse tags, inspect endpoint schemas, and execute authenticated requests. Use when listing users, managing organizations, or calling any Clerk API endpoint.

deangilmoreremix/videoremix.vip2

Chrome Extension auth with @clerk/chrome-extension -- popup/sidepanel setup, syncHost for OAuth/SAML via web app, createClerkClient for service workers and headless extensions, stable CRX ID. Triggers on: Chrome extension auth, Plasmo clerk, popup sign-in, syncHost, background service worker token, createClerkClient, headless extension.

deangilmoreremix/videoremix.vip2

>- Operate the Clerk CLI (`clerk` binary) for authentication, user/org/session management, deploy verification, instance config, env keys, and any Clerk Backend or Platform API call. Use when the user mentions Clerk management tasks, "list clerk users", "create a clerk user", "update organization", "pull clerk config", "clerk env pull", "clerk doctor", "clerk deploy", "clerk deploy status", "clerk api", or any ad-hoc Clerk API request. Prefer the CLI over raw HTTP: it handles auth, key resolution, app/instance targeting, and formatting automatically.

deangilmoreremix/videoremix.vip2

Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS. Use for custom sign-in/sign-up flows, appearance styling, visual customization, branding.

deangilmoreremix/videoremix.vip2

Agent skill / project related to launch or product demo video: deangilmoreremix/videoremix.vip2

Verwandte Skills