> For the complete documentation index, see [llms.txt](https://docs.xenoraa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xenoraa.com/xenoraa-super-admin-operations-manual/platform-billing-and-revenue-operations.md). # Platform Billing & Revenue Operations ## Platform Billing & Revenue Operations Managing the financial health of Xenoraa requires precise oversight of subscriptions, invoices, payment receipts, and recurring revenue metrics. The Super Admin billing module gives you a bird's-eye view of your Monthly Recurring Revenue (MRR), Annual Recurring Revenue (ARR), and individual subscriber transactions. *** ### 1. Revenue Metrics & Telemetry The Revenue Dashboard (`/superadmin/revenue`) aggregates all financial transactions into actionable business intelligence. The system calculates these metrics in real-time from the `subscriptions` and `payments` tables. ``` +-------------------------------------------------------------------+ | [REVENUE DASHBOARD] | +-------------------------------------------------------------------+ | MRR: Rs. 2,45,000 | ARR: Rs. 29,40,000 | LTV: Rs. 18,50,000 | +-------------------------------------------------------------------+ | [Monthly Revenue Trend] | | Jan: ▓▓▓▓ Rs. 1,80,000 | | Feb: ▓▓▓▓▓ Rs. 2,10,000 | | Mar: ▓▓▓▓▓▓ Rs. 2,45,000 | +-------------------------------------------------------------------+ | [Plan Distribution] | | - Business Plan: 45% (Rs. 1,10,250) | | - Pro Plan: 40% (Rs. 98,000) | | - Starter Plan: 15% (Rs. 36,750) | +-------------------------------------------------------------------+ ``` #### Core Financial Indicators * **Monthly Recurring Revenue (MRR):** The sum of all active subscription monthly fees. (Formula: `Starter_Count * Price + Pro_Count * Price + Business_Count * Price`). * **Annual Recurring Revenue (ARR):** Computed as `MRR * 12`. * **Customer Lifetime Value (LTV):** The average revenue generated per tenant across their entire active lifecycle. * **Churn Rate:** The percentage of tenants who cancelled their subscriptions during the current billing cycle. *** ### 2. Step-by-Step Billing Workflows #### Workflow A: Setting Up Pricing Plans & Tiers You can manage the public-facing pricing plans, feature lists, and FAQs directly from the Pricing Manager. 1. Navigate to the **Pricing Manager** (`/superadmin/pricing-manager`). 2. **Edit Plans:** Update the monthly price, annual price, and core feature list for the Starter, Pro, and Business plans. 3. **Edit Comparison Matrix:** Add, update, or remove rows in the feature comparison matrix to show tenants exactly what they get in each tier. 4. **Edit FAQs:** Manage the pricing and billing FAQs shown on the public homepage. 5. Click **Save Plans & Pricing** to write the configuration to the database. The public pricing page updates instantly. *** #### Workflow B: Managing Individual Subscriptions When a tenant upgrades, downgrades, or requests a billing adjustment, you can manage their subscription record directly. 1. Navigate to **Subscriptions** (`/superadmin/subscriptions`). 2. Search for the tenant's company name. 3. Click **Edit Subscription** to open the management modal. 4. **Change Plan:** Select the new plan (Starter, Pro, Business). 5. **Adjust Billing Cycle:** Toggle between **Monthly** and **Annual** billing. 6. **Set Custom Price:** Enter a custom monthly rate to override the standard plan price (e.g., for custom enterprise agreements). 7. **Adjust Expiry Date:** Set a custom renewal date if the tenant paid offline or received a free extension. 8. Click **Save Subscription**. The system will log the change and update the tenant's billing schedule. *** #### Workflow C: Recording Offline Payments If a tenant pays via direct bank transfer, cash, or check, you must record the payment manually to keep their subscription active and update your revenue reports. 1. Open the **Subscriptions** or **Billing Overview** page (`/superadmin/billing`). 2. Locate the tenant and click **Record Payment**. 3. Enter the **Payment Amount** (in Rs.). 4. Select the **Payment Method** (Bank Transfer, Cash, Check). 5. Enter the **Reference Number** (e.g., bank transaction ID, check number). 6. Select the **Payment Date**. 7. Click **Submit Payment**. The system will: * Generate a payment receipt invoice. * Update the tenant's subscription status to `active`. * Extend their subscription expiry date based on the plan cycle. * Send an automated email confirmation to the tenant. *** ### Plan & Pricing Reference Table All standard subscription plans are billed in Indian Rupees (Rs.) as per the local design system requirements: | Plan Name | Monthly Price | Annual Price (15% Disc) | Default Seats | Key Features Included | | ---------------- | --------------- | ----------------------- | :-----------: | ------------------------------------------------------------------ | | **Starter** | Rs. 4,999 / mo | Rs. 50,990 / yr | 3 seats | Basic CRM, Leads, Contacts, Tasks, 1 Email Config | | **Professional** | Rs. 14,999 / mo | Rs. 1,52,990 / yr | 10 seats | Full CRM, Accounts, 1 POS Terminal, Storefront, 100 AI Credits | | **Business** | Rs. 29,999 / mo | Rs. 3,05,990 / yr | Unlimited | Full CRM, Full Accounts, Unlimited POS, Storefront, 300 AI Credits | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.xenoraa.com/xenoraa-super-admin-operations-manual/platform-billing-and-revenue-operations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.