app/stories/organization-owner/ORG-008-subscription-management.md

Manage Subscription and Billing

ID: ORG-008 Priority: Medium Status: Planned

User Story

As an organization owner, I want to manage my subscription plan and billing details so that I can upgrade, downgrade, or update payment methods as needed.

Acceptance Criteria

• View current subscription plan and features
• Compare available plans with feature matrix
• Upgrade to higher plan with immediate effect
• Downgrade with effect at end of billing period
• Update payment method (credit card via Paddle)
• View billing history and download invoices
• Cancel subscription with confirmation
• Apply coupon/discount codes

Technical Notes

• Paddle integration exists (paddlesetup view, BillingPlanManager)
• Enhance existing subscription view with more functionality
• Paddle handles PCI compliance for payment data
• Webhook handlers for subscription status changes
• VAT handling for EU customers (Paddle manages this)

Related TODOs

• Enhancement to existing Paddle integration