Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/customers/archive.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ As businesses evolve, some customers may become inactive due to churn, contract


<Frame>
![](/Screenshot2025-03-12at11.42.22PM.png)
![Archive Customer Option](/Screenshot2025-03-12at11.42.22PM.png)
</Frame>

* Select Archive from the dropdown options
Expand All @@ -25,7 +25,7 @@ As businesses evolve, some customers may become inactive due to churn, contract


<Frame>
![](/Screenshot2025-03-12at11.42.42PM.png)
![Confirm Archive](/Screenshot2025-03-12at11.42.42PM.png)
</Frame>

* Click **Archive** to proceed, or **Cancel** if you change your mind.
Expand Down
10 changes: 5 additions & 5 deletions docs/invoices/managing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ title: "Managing Invoices"


<Frame>
![](/Screenshot2025-03-13at12.28.57AM.png)
![Invoices Section](/Screenshot2025-03-13at12.28.57AM.png)
</Frame>

* View the list of invoices with details like **Invoice ID, Amount, Invoice Status, Customer Slug, Payment Status, and Due Date**.
Expand Down Expand Up @@ -46,7 +46,7 @@ When viewing a specific invoice, you will see:


<Frame>
![](/Screenshot2025-03-13at12.30.19AM.png)
![Invoice List](/Screenshot2025-03-13at12.30.19AM.png)
</Frame>

* Choose from:
Expand All @@ -55,7 +55,7 @@ When viewing a specific invoice, you will see:


<Frame>
![](/Screenshot2025-03-13at12.30.41AM.png)
![Invoice Details](/Screenshot2025-03-13at12.30.41AM.png)
</Frame>

* **Draft** – Editable invoice before finalization.
Expand All @@ -78,7 +78,7 @@ When viewing a specific invoice, you will see:


<Frame>
![](/Screenshot2025-03-13at12.31.06AM.png)
![Download PDF](/Screenshot2025-03-13at12.31.06AM.png)
</Frame>

* **Pending** – Payment is awaited.
Expand All @@ -99,5 +99,5 @@ When viewing a specific invoice, you will see:


<Frame>
![](/Screenshot2025-03-13at12.31.25AM.png)
![Invoice Actions](/Screenshot2025-03-13at12.31.25AM.png)
</Frame>
2 changes: 1 addition & 1 deletion docs/invoices/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: "Overview"

Invoices in Flexprice provide a structured way to bill customers for their subscriptions, usage, and additional charges. The invoicing system supports automated generation, status management, and payment tracking, ensuring a seamless billing process for businesses.
<Frame>
![](/Invoice.jpg)
![Invoice Overview](/Invoice.jpg)
</Frame>

Invoices are essential for:
Expand Down
2 changes: 1 addition & 1 deletion docs/product-catalogue/coupons/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -108,4 +108,4 @@ Coupons integrate seamlessly with:
- **Analytics**: Track coupon performance and customer behavior
- **API Access**: Programmatically create and manage coupons

💡 **Ready to get started?** [Create your first coupon](/docs/Product%20catalogue/Coupons/Create%20a%20Coupon) to begin offering flexible pricing options to your customers.
💡 **Ready to get started?** [Create your first coupon](/docs/product-catalogue/coupons/create) to begin offering flexible pricing options to your customers.
4 changes: 2 additions & 2 deletions docs/product-catalogue/plans/archive.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,15 @@ Over time, businesses may need to modify or discontinue certain pricing plans du
* Click on the three-dot menu next to the plan you want to archive

<Frame>
![](/Screenshot2025-03-12at11.19.59PM.png)
![Archive Plan Option](/Screenshot2025-03-12at11.19.59PM.png)
</Frame>

* Select Archive from the dropdown options

* A confirmation dialog will appear asking if you want to archive the plan. Make sure that you can no longer modify the plan details once it is archived.

<Frame>
![](/Screenshot2025-03-12at11.20.29PM.png)
![Confirm Archive Plan](/Screenshot2025-03-12at11.20.29PM.png)
</Frame>

* Click **Archive** to proceed, or **Cancel** if you change your mind.
Expand Down
2 changes: 1 addition & 1 deletion docs/product-catalogue/plans/create.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ It defines how customers will be charged under this plan. You can add **one or
* **Yearly** → Customers are billed once per year for total usage over the year.

* **Select a Billing Model**
Flexprice allows different pricing models for usage-based billing:💡 *The correct billing model ensures flexibility in pricing strategy and revenue optimization. To read more about different types of charges read* [here](Charges%20in%20plans%201b09b3a59a6880d69013dab788bbe5ea.md)*.*
Flexprice allows different pricing models for usage-based billing:💡 *The correct billing model ensures flexibility in pricing strategy and revenue optimization. To read more about different types of charges read in the [Billing Models](/docs/product-catalogue/plans/billing-models/flat-fee) section.*
Copy link
Contributor

@subratsahilgupta subratsahilgupta Oct 31, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could be better phrasing:
Flexprice supports multiple pricing models for usage-based billing: 💡 *The correct billing model ensures flexibility in pricing strategy and revenue optimization. For more details on different charge types, see the [Billing Models](/docs/product-catalogue/plans/billing-models) section.*


* **Flat Fee** → A fixed price per unit of usage (e.g., $0.01 per API call).

Expand Down
20 changes: 10 additions & 10 deletions docs/product-catalogue/plans/pricing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Follow the steps below to create a pricing plan in Flexprice:

3. Click **"Add Pricing Plan"** at the top-right of the screen.
<Frame>
![](/Screenshot2025-01-21at3.03.14AM.png)
![Add Pricing Plan](/Screenshot2025-01-21at3.03.14AM.png)
</Frame>

This opens a **three-step form** to configure your plan.
Expand All @@ -55,9 +55,9 @@ This step captures key identifiers for your pricing plan.
- **Plan Description** _(Optional)_: Provides internal context about the plan.

<Frame>
![](/Screenshot2025-01-21at3.05.22AM.png)
![Plan Details Form](/Screenshot2025-01-21at3.05.22AM.png)
</Frame><Frame>
![](/Screenshot2025-01-21at3.06.14AM.png)
![Plan Configuration](/Screenshot2025-01-21at3.06.14AM.png)
</Frame>

## **Step 2: Configure Billing Preferences**
Expand All @@ -76,7 +76,7 @@ Billing preferences define when and how the customer will be billed. It includes

- Click **Next** to continue.
<Frame>
![](/Screenshot2025-01-21at3.08.50AM.png)
![Billing Preferences](/Screenshot2025-01-21at3.08.50AM.png)
</Frame>

## **Step 3: Define plan charges**
Expand All @@ -89,14 +89,14 @@ It defines how customers will be charged under this plan. You can add **one or m

You can create a plan by adding multiple usage-based charges in the same plan as well
<Frame>
![](/Screenshot2025-01-21at3.11.27AM.png)
![Multiple Charges](/Screenshot2025-01-21at3.11.27AM.png)
</Frame>

### Setting-up a recurring-based charge:

Select subscription type as Recurring to charge your customers a recurring fee based on the defined billing period. Whenever user purchases this plan, it will be charged a flat fee and given access to the features that will be part of that plan.
<Frame>
![](/Screenshot2025-01-21at3.18.13AM.png)
![Recurring Charge](/Screenshot2025-01-21at3.18.13AM.png)
</Frame>

- **Select billing currency**
Expand Down Expand Up @@ -128,14 +128,14 @@ To incorporate usage-based charges into a plan, you can utilize existing billabl
Select the Flat fee pricing model if you want to charge the **same price for each unit** consumed.
**Example:** $0.01 per API call.
<Frame>
![](/Screenshot2025-01-21at3.28.12AM.png)
![Flat Fee Pricing](/Screenshot2025-01-21at3.28.12AM.png)
</Frame>

- **Package pricing**
Select the package charge model if you want to apply a **fixed price to a range of units**.
**Example:** $5 per 100 API calls.
<Frame>
![](/Screenshot2025-01-21at3.30.33AM.png)
![Package Pricing](/Screenshot2025-01-21at3.30.33AM.png)
</Frame>

- **Volume tiered based pricing**
Expand All @@ -145,7 +145,7 @@ To incorporate usage-based charges into a plan, you can utilize existing billabl

- 10,001 – ∞ calls → $0.0008 per call
<Frame>
![](/Screenshot2025-01-21at3.32.13AM.png)
![Volume Tiered Pricing](/Screenshot2025-01-21at3.32.13AM.png)
</Frame>

- Click on **Add** to save the charges
Expand All @@ -154,7 +154,7 @@ To incorporate usage-based charges into a plan, you can utilize existing billabl

You can create a single pricing plan which includes multiple charges - Recurring as well usage-based charges.
<Frame>
![](/Screenshot2025-01-21at3.35.59AM.png)
![Hybrid Charges](/Screenshot2025-01-21at3.35.59AM.png)
</Frame>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alt text can be more appropriate i.e, aligning with what the screenshot is about.
Also, it will be appreciated, if the new pattern is followed in the follow-up PR, wherein we are storing named screenshots /public/images/docs/respective_dir


### **Review & Save**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,10 +31,10 @@ In addition, Cursor provides usage-based metering for:

**Configuring Cursor’s Pricing in Flexprice**

1. **Define **[**Features**](https://docs.flexprice.io/docs/Product%20catalogue/Features/Creating%20a%20feature)** in Flexprice**\
Flexprice allows you to define different types of features to enable precise billing and usage tracking for Cursors pricing model.\
1. **Define **[**Features**](/docs/product-catalogue/features/create)** in Flexprice**\
Flexprice allows you to define different types of features to enable precise billing and usage tracking for Cursor's pricing model.\
\
**Metered Features**\
**Metered Features**
These features track usage over time and are billed based on consumption.

| Feature Name | Feature Type | Aggregation Method | Key Filters |
Expand All @@ -58,7 +58,7 @@ In addition, Cursor provides usage-based metering for:
| Feature Name | Feature Type | Description |
| ------------- | ------------ | ------------------------------------- |
| SAML/OIDC SSO | Static | Enables single sign-on authentication |
2. **Create ** [**Plans**](https://docs.flexprice.io/docs/Product%20catalogue/Plans/Creating%20a%20plan)** for Subscription Tiers**
2. **Create ** [**Plans**](/docs/product-catalogue/plans/create)** for Subscription Tiers**
1. Each of Cursor’s plans can be created as a **recurring charges** in Flexprice:

| Plan Name | Billing Type | Base Price |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Now, let’s configure the pricing for the O1 model using **Flexprice**.

**Configuring Pricing of o1 model in Flexprice**

1. **Create** [Metered Features](../../Features%201b09b3a59a6880e59e45d3e7a56bd66b/Creating%20a%20feature%201b09b3a59a68808fafbfd3ec556640dd.md) **for Token Usage**
1. **Create** [Metered Features](/docs/product-catalogue/features/create) **for Token Usage**
Since token usage is metered, we first define three separate Metered Features in Flexprice for input tokens, output tokens, and cached input tokens.

| **Feature Name** | **Feature Type** | **Aggregation Method** | **Key** | **Filters** |
Expand All @@ -45,7 +45,7 @@ Now, let’s configure the pricing for the O1 model using **Flexprice**.
| Output Tokens | Metered | SUM | model\_name | model: OpenAI O1, prompt\_type: output |
| Cached Input Tokens | Metered | SUM | model\_name | model: OpenAI O1, prompt\_type: cached\_input |

2. **Create a Plan with** [Package-Based Pricing](../Charges%20in%20plans%201b09b3a59a6880d69013dab788bbe5ea/Package%201b09b3a59a688086af25c00392d217a5.md)
2. **Create a Plan with** [Package-Based Pricing](/docs/product-catalogue/plans/billing-models/package)
Once the metered features are created, we define a **Plan** that charges users per million tokens rather than per individual token.

| **Metered Feature** | **Billing Model** | Charges |
Expand Down
8 changes: 4 additions & 4 deletions docs/subscriptions/customers-create-subscription.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,19 @@ description: "Once a customer is created, you can assign a subscription to them

- Click on the customer you want to assign a subscription to. This will open the customer's details page.
<Frame>
![](/Screenshot2025-01-21at9.01.50PM.png)
![Select Customer](/Screenshot2025-01-21at9.01.50PM.png)
</Frame>

- On the customer details page, click the **Add Subscription** button.

- Select a pricing plan from the dropdown menu. Only plans that have been created will be listed.
<Frame>
![](/Screenshot2025-01-21at9.03.00PM.png)
![Select Plan](/Screenshot2025-01-21at9.03.00PM.png)
</Frame>

- Based on the selected plan, subscription preview along with breakdown of charges will appear on the right side of the screen. This includes all recurring charges and usage-based charges that you've created in the plan for the given billing period.
<Frame>
![](/Screenshot2025-01-21at9.05.38PM.png)
![Subscription Preview](/Screenshot2025-01-21at9.05.38PM.png)
</Frame>

- Specify the **Subscription Start Date** thats marks as the beginning of the billing cycle.
Expand All @@ -32,7 +32,7 @@ description: "Once a customer is created, you can assign a subscription to them

- The subscription will now appear under the customer's details with its status and billing information.
<Frame>
![](/Screenshot2025-01-21at9.09.06PM.png)
![Subscription Created](/Screenshot2025-01-21at9.09.06PM.png)
</Frame>

### **Managing Multiple Subscriptions for a Customer**
Expand Down
4 changes: 2 additions & 2 deletions docs/subscriptions/override-line-items.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -342,8 +342,8 @@ When overriding to `PACKAGE`, you must provide `transform_quantity`:

- [Creating Subscriptions](/docs/subscriptions/customers-create-subscription)
- [Pricing Plans](/docs/product-catalogue/plans/pricing)
- [Billing Models](/docs/product-catalogue/plans/billing-models)
- [Subscription Management](/docs/Subscriptions)
- [Billing Models](/docs/product-catalogue/plans/billing-models/flat-fee)
- [Viewing Subscriptions](/docs/subscriptions/view)

---

Expand Down
2 changes: 1 addition & 1 deletion integrations/stripe/connection-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ You can create a Stripe connection directly from the Flexprice dashboard:

<Frame>
<Frame>
![](/connection.png)
![Stripe Connection Setup](/connection.png)
</Frame>
</Frame>

Expand Down
2 changes: 1 addition & 1 deletion integrations/stripe/integration-workflow.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Before you begin, ensure the following:
## Step 1: Set Up the Connection

Follow the connection setup guide below to link Stripe with FlexPrice:
👉 [Stripe Connection Setup Guide](https://docs.flexprice.io/docs/Integrations/Stripe/stripe-connection-setup)
👉 [Stripe Connection Setup Guide](/integrations/stripe/connection-setup)

### Required Webhook Events
```
Expand Down
6 changes: 3 additions & 3 deletions integrations/stripe/payment-links.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -75,13 +75,13 @@ You can create payment links directly from the Flexprice dashboard:

<Frame>
<Frame>
![](/paymentlink2.png)
![Payment Link Form](/paymentlink2.png)
</Frame>
</Frame>

<Frame>
<Frame>
![](/paymentlink1.png)
![Payment Link Preview](/paymentlink1.png)
</Frame>
</Frame>

Expand Down Expand Up @@ -301,7 +301,7 @@ graph TD
3. **Future Payments**: Use card payment method for faster checkout
4. **Fallback**: Provide payment link option if card payment fails

For detailed information about card payments, see [Card Checkout Flow Documentation](./card-checkout-flow.md).
For detailed information about card payments, see [Card Payment Documentation](/integrations/stripe/card-payment).

## Security Considerations

Expand Down