Autumn

Autumn abstracts Stripe billing in Convex with three functions: check access, track usage, and process checkouts for any pricing model.

Installation

npm install @useautumn/convex

About Autumn

Autumn is your pricing and customer database—an abstraction over Stripe that lets you model any pricing (subscriptions, usage-based, seats, trials, credits) and implement it in your codebase in just three functions: check for access, track for metering, and checkout for purchases.

Benefits

Use cases

how to add subscription billing to convex app

Autumn provides a Stripe abstraction with three functions integrated into Convex. Install @useautumn/convex, then use the check function to verify access, track for usage metering, and checkout for payment processing. This eliminates the need to handle Stripe webhooks or complex subscription state management.

usage based billing in convex

Autumn's track function lets you meter usage directly in your Convex mutations and queries. It automatically handles usage aggregation, billing cycles, and overage charges. The component integrates with Stripe for payment processing while keeping all usage data in your Convex database.

convex stripe integration with trials

Autumn handles trial periods, subscription upgrades, and seat-based pricing through its unified API. The check function returns access status including trial information, while checkout supports plan changes and upgrades without custom webhook handling.

Frequently asked questions

How does Autumn handle Stripe webhooks in Convex?

Autumn manages Stripe webhooks automatically so you don't need to implement webhook endpoints in your Convex app. The @useautumn/convex package abstracts webhook handling and keeps your billing state synchronized with Stripe through its managed service layer.

Can I use Autumn with existing Stripe customers?

Yes, Autumn can work with existing Stripe customers and subscriptions. The component provides migration utilities to import existing billing data while maintaining your current Stripe setup and customer relationships.

What pricing models does Autumn support in Convex?

Autumn supports subscriptions, usage-based billing, seat-based pricing, credit systems, and free trials. You can combine these models and implement complex pricing logic using the three core functions: check for access control, track for usage metering, and checkout for payments.

Does Autumn require a separate database for billing data?

No, Autumn stores billing and customer data directly in your Convex database. This eliminates the need for external billing databases while providing real-time access to subscription status, usage metrics, and customer information in your Convex queries and mutations.

Links