# Manage Add-ons & Credits – Guide {% embed url="" %} The **Manage Add-ons** feature in Rapidbott allows workspace owners to flexibly enable, disable, and manage paid add-ons using a **credit-based wallet system**, instead of rigid monthly subscriptions. This ensures fair billing, transparency, and full control over add-on usage. *** ### 1. What Are Add-ons?
Add-ons are optional paid features that extend your workspace capabilities. Examples: * Additional Bots * Inbound Webhooks * Advanced Automations * Extra Integrations * Premium Features Each add-on consumes credits based on: * Its monthly price * The number of active days within your billing cycle *** ### 2. Credits System (Important) Rapidbott uses a **wallet-based credit system** for add-ons. * **1 Credit = $1** * Credits are stored at the **workspace level** * Credits can be topped up anytime * Unused credits never expire This makes billing predictable and flexible. *** ### 3. Why Credits Instead of Monthly Subscriptions? Add-ons are usage-dependent and often temporary. Reasons we use credits: * Different add-ons have different usage patterns * Some users enable add-ons only for a short time * Add-ons can be added or removed anytime * Monthly subscriptions would make tracking complex With credits: * You only pay for what you actually use * Unused value is preserved in your wallet * No forced renewals *** ### 4. Workspace Renewal Date Each workspace has a **Renewal Date** (billing cycle start & end). This date is important because: * All add-on charges are calculated within this cycle * Prorated deductions depend on remaining days in the cycle * Credits are adjusted based on this date Example: * Renewal Date: 1st of every month * Billing cycle: 1st → 30th/31st *** ### 5. How Add-on Charges Are Calculated (Proration) Add-ons are charged **proportionally** based on how many days they are active in the current billing cycle. #### Example 1: Add-on Added at Start of Cycle * Add-on price: $30/month * Added on Day 1 * Charge: 30 credits #### Example 2: Add-on Added Mid-Cycle * Add-on price: $30/month * Billing cycle length: 30 days * Added on Day 16 * Remaining days: 15 Calculation: ``` 30 ÷ 30 × 15 = 15 credits ``` Only **15 credits** will be deducted. *** ### 6. Removing an Add-on (Credit Refund Logic) When an add-on is removed before the end of the cycle: * Unused days are refunded back as credits * Refund is calculated using the same prorated logic * Credits are added instantly to the workspace wallet This ensures: * No loss of value * Fair billing * Full flexibility *** ### 7. Insufficient Credits Handling (Smart Check) If you try to enable an add-on but don’t have enough credits: * The system calculates how many credits are required * You are shown the **exact additional credits needed** * You can top up only the required amount This avoids guesswork and failed activations. *** ### 8. Topping Up Credits You can add credits anytime using **Top Up Credits**. Key points: * No minimum lock-in * Credits are added instantly after payment * Credits apply to all add-ons in the workspace Recommended: * Keep buffer credits to avoid service interruption * Ideal for workspaces with active add-ons *** ### 9. Payment & Credit Validation (Behind the Scenes) When you top up credits: 1. Payment is initiated (via Stripe or supported gateways) 2. Payment status is verified on the backend 3. On success: * Credits are added to the workspace wallet * Transaction is logged 4. Wallet balance updates in real time Credits are never added unless payment is fully verified. *** ### 10. Where You Can See Everything Inside **Manage Add-ons**, you can view: * Active add-ons * Credit balance * Add-on prices * Prorated credit usage * Workspace renewal date * Required credits for activation This keeps billing **transparent and predictable**. *** ### 11. Summary * Add-ons are flexible, not locked subscriptions * Billing is based on actual usage (prorated) * **1 Credit = $1** * Unused credits are never lost * Add-ons can be added or removed anytime * Workspace renewal date controls calculations This system is designed to be **fair, simple, and scalable** for all Rapidbott users.