Hybrid pricing

Hybrid pricing lets you mix and match pricing models — recurring, quantity-based, usage-based, and one-time — within a single transaction. Your subscribers can purchase a subscription alongside custom, non-recurring charges in one checkout, with everything collected on a single invoice.

Available on all Recurly plans

1Definition 2Key benefits 3Key details 4Activating hybrid pricing

Definition

The hybrid pricing model lets you combine different pricing structures — recurring, quantity-based, usage-based, and one-time — in a single subscription transaction. Subscriptions and custom charges (non-recurring products) can be purchased together on one invoice, collected immediately.

Key benefits

Pricing flexibility Accommodate a wide variety of business models by combining recurring subscriptions with one-time and usage-based charges — all in one place.

Single-transaction checkout Let subscribers purchase a subscription and one-time products together, collected on a single invoice at checkout.

Tailored pricing strategies Precisely match your pricing to your product mix — whether that's digital goods, physical goods, SaaS, or any combination.

Better customer experience Reduce friction at checkout by unifying diverse product types into one seamless purchasing flow.

Key details

The hybrid pricing model is designed for businesses whose product catalog doesn't fit neatly into a single pricing type. By combining recurring, quantity-based, usage-based, and one-time models, you can address a wide range of business needs in a single transaction.

Industry examples

Industry	Example
SaaS	A CRM software charges $50/month per user and bills separately based on the number of leads generated or emails sent.
Streaming media	A streaming service charges $39.99/month and offers one-time purchases for movies or TV show seasons.
Consumer goods	A pet supplies service charges $9.99/month for a subscription and tiered pricing for toy add-ons.

Activating hybrid pricing

Note Hybrid pricing requires API integration. You'll need access to Recurly's API to create hybrid purchases programmatically.

Understand hybrid checkout

Hybrid checkout introduces the concept of a "purchase" — a single transaction that combines recurring subscriptions with non-recurring custom charges (adjustments). Both appear as line items on one invoice.

Integrate with the Recurly API

To use the hybrid model, your system needs to interact with Recurly's API. Review the Purchases endpoint in the API reference before you begin.

Create a purchase

In your API request, submit a subscription with one or more add-ons or adjustments on a new or existing Account. The subscription and adjustments appear as line items on a single invoice, which is collected immediately.

Understand transaction behavior

A purchase creates a single gateway transaction. If the transaction succeeds, Recurly creates or updates the Account. If it fails, the entire request is rolled back — no partial state is saved.

Updated 2 days ago