billing-system-expert

Stripe billing integration maps price IDs to subscription plans (Glow Up, Viral Surge, Fame Flex, Free) and enforces plan limits on user actions. The Skill handles price-to-plan mapping, validates campaign creation against tier limits, and synchronizes usage across all subscription tiers.

Webhooks are critical events Stripe sends to notify your system of subscription changes. Webhook handling verifies signatures, maps events like subscription creation, and triggers billing state updates. This ensures your database stays synchronized with Stripe's billing records.

Trial activation occurs during onboarding; conversion to paid happens when the trial period expires or the user upgrades. The Skill manages trial state transitions, enforces trial-specific limits, and automates the upgrade flow without manual intervention.

Yes. Plan enforcement validates campaign creation and creator usage against tier-specific limits. The Skill retrieves plan limits from configuration, compares current usage, and blocks or allows actions based on the user's active subscription tier.

Billing sync keeps your application's usage records aligned with Stripe's subscription state. You need it after webhook events, failed deliveries, or manual state corrections. The Skill tracks states like webhook_subscription_created and provides endpoints to manually sync campaigns and monthly creator counts.

Verify webhook delivery in the Stripe dashboard, confirm webhook signatures are valid, run the manual sync endpoint to reconcile usage, and test events with Stripe CLI. The Skill maps billing states and logs transitions to help identify where sync failures occurred.