# Manage Add-ons & Credits – Guide

{% embed url="<https://youtu.be/SdB9XsxYwRg?si=t2jz9CkLNM6LZzc1>" %}

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?

<figure><img src="/files/s1Rrd8jk5AQIxzynU4Ub" alt=""><figcaption></figcaption></figure>

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.


---

# Agent Instructions: 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:

```
GET https://docs.rapidbott.com/help-center/start-here/manage-add-ons-and-credits-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
