Understanding Floating Prices in Price Intervals

When creating price intervals using the add/edit endpoint, you have the option to include floating prices. This article explains how floating prices work and how they differ from add-on prices.

What are Floating Prices?

Floating prices are custom prices created specifically for individual price intervals. They are typically used for adjusting usage tiers or creating subscription-specific pricing.

Querying Floating Prices

Floating prices created as part of a price interval are not queryable through the standard list prices endpoint. They are designed to be used only for the specific price interval they were created for.

Floating Prices vs. Add-on Prices

• Floating Prices: Created within price intervals, not queryable, used for specific subscriptions or usage tiers.

• Add-on Prices: Created through the add-on price endpoint, queryable via the list prices endpoint, reusable across multiple subscriptions.

Best Practices

1. Use floating prices when you need a unique price for a specific subscription or usage tier.

2. If you need to reuse a price or query it later, create an add-on price instead.

3. For cases where the free allotment has been used, consider creating a reusable add-on price that eliminates the tier altogether.

By understanding the difference between floating prices and add-on prices, you can better manage your pricing structure and avoid confusion when querying price information.