billing-state-machine

What problem does it solve?

Billing state machine solves the challenge of defining, enforcing, and synchronizing subscription states across systems, ensuring consistent access control and accurate Stripe status.

Core Features & Use Cases

• Define all valid states and their allowed transitions and provide a single source of truth for state changes.
• Enforce transitions at the database and application layer, preventing invalid state changes and race conditions.
• Synchronize Stripe subscription statuses to local state using a deterministic mapping from Stripe events to transitions.
• Handle concurrent webhook events safely with optimistic locking and idempotent transitions.
• Emit downstream effects (entitlements, emails, audit logs) on each transition to keep downstream systems in sync.

Quick Start

Implement the state machine in your subscription service and wire Stripe webhooks to drive transitions.