Source
Plans, pricing models & subscription lifecycle — found from sitemap — Recurly
Checked for Recurly on 26 Oct 2026
- Page
- https://docs.recurly.com/recurly-subscriptions/docs/usage-based-billing
- Checked
- 26 Oct 2026, 16:55 UTC
- How we may use it
- Public page, crawling permitted
Technical details
- type
- page
- http status
- 200
- content hash
- sha256:f58c3ec0268f793bab1c60f58dc1016a5022eb2d5cb6890046ae25be9fe45b33
- permission
- robots_ok
- screenshot
- Screenshot on file (internal exhibit, not published)
Cited by
Facts read from this source
-
Ubilling available all plans Report an error
“Available on all Recurly plans”
-
Ubilling definition Report an error
“Recurly's usage-based billing model lets you charge customers at the end of each billing cycle based on their actual consumption — not a fixed fee.”
-
Ubilling pricing strategies Report an error
“Recurly supports two pricing strategies for usage-based add-ons:”
-
Ubilling accumulation periods Report an error
“Choose whether usage accumulates and bills at each billing cycle, or across the entire subscription term.”
-
Measured units required Report an error
“Measured units are required for all usage add-ons, but only display to subscribers for price-per-unit add-ons.”
-
Ubilling charge models Report an error
“Charge model "Price per unit" or "Percentage of an amount" Determines whether you define a fixed price or a percentage. Cannot be changed after creation — remove and re-add the add-on to switch models.”
-
Ubilling price precision Report an error
“Price $0.50 USD Price per unit. Supports up to nine decimal places.”
-
Ubilling percentage precision Report an error
“Percentage 2.36% Percentage of the monetary usage amount. Supports up to four decimal places. Percentage tiers and volume are supported.”
-
Ubilling pricing models Report an error
“Pricing model (tier type) Fixed, Tiered, Volume, Stairstep”
-
Ubilling no proration Report an error
“Usage-based add-ons never prorate. Proration only applies to line items charged up front.”
-
Trial usage not billed Report an error
“Usage incurred during a free trial is not billed to the customer. It's logged and visible (useful for product analytics), but it won't appear on the first payment invoice.”
-
Final invoice on expiry Report an error
“When a subscription with usage-based add-ons expires, Recurly always generates a final invoice that includes the usage add-ons — even if usage is zero.”
-
Usage corrections coupon eligibility Report an error
“Usage correction line items are not eligible for discounts — they represent a past billing period that may or may not have had an active coupon.”
-
Corrections supported pricing models Report an error
“Corrections are accepted for Fixed and Tiered pricing models. They're charged at the tiers already billed for that period.”
-
Usage logging API only Report an error
“All usage is logged through the Usage API. Usage cannot be logged from the Admin Console.”
-
Usage not rate limited Report an error
“The Usage API endpoints are not rate-limited to support real-time logging.”
-
Usage edit delete rules Report an error
“Edit: You can edit unbilled usage records. Once billed, only the merchant_tag field can be edited. Delete: You can delete unbilled usage records. Once billed, issue a refund or usage correction instead.”
-
Decimal usage support limits Report an error
“Supported up to nine digits before and after the decimal point (as long as the total doesn't round to one billion)”
-
Ubilling addon quantity limit Report an error
“Usage-based add-ons can only have a quantity of 1. The customer is billed by measured units, not quantity.”
-
Mrr excludes usage revenue Report an error
“The MRR report does not include usage-based add-on revenue — variable fees are not counted in MRR by convention.”
-
Transactions report includes usage Report an error
“The transactions report includes usage-based add-on revenue.”
-
Ubilling API versions Report an error
“All usage and quantity-based pricing functionality is available on API v2019-10-10 and above.”
-
Recurly js min version Report an error
“Recurly.js v4.0.5 and above supports usage-based billing pricing.”
-
Webhook usage attributes Report an error
“Usage-based add-on attributes are included in these webhook notifications: new_subscription_notification renewed_subscription_notification updated_subscription_notification canceled_subscription_notification reactivated_account expired_subscription_notification”
-
New usage notification webhook Report an error
“Recurly sends a new_usage_notification webhook in these scenarios:”
-
Exports for usage Report an error
“Subscriptions Add-Ons Export (v2) Subscriptions Usage Records Export (v2)”
-
Partner decimal handling Report an error
“Integration partner support for decimal usage quantities”
-
Client library versions Report an error
“Ruby 3.10.0 2.18.8 Node.js 3.11.0 — Python 3.9.0 2.9.16 .NET 3.11.0 1.17.3 Go 3.5.0 — Java 3.10.0 — PHP 3.5.0 2.12.13”
-
Checkout display behavior Report an error
“Usage-based add-ons appear automatically on Checkout and Hosted Payment Pages, but their cost is excluded from the Order Total — all usage fees are charged at the end of the billing cycle.”
-
Plan fee can be zero Report an error
“Recurly requires a recurring plan fee, but you can set it to $0 for a strictly usage-based plan.”
-
Refund method recommendation Report an error
“Use line item refunds rather than open-amount refunds for usage-based add-ons:”
-
Ubilling provenance note Report an error
“Usage-based billing was developed with support from Louisiana Economic Development's Office of Entertainment Industry Development.”
-
Strategy change new subscriptions only Report an error
“You can switch a usage-based add-on's pricing strategy at any time, but the change only applies to subscriptions created after the switch.”
Scores citing this record
- The Billing Engineer Plans, pricing models & subscription lifecycle
- The Billing Engineer Cross-border VAT & tax handling
- The Billing Engineer Revenue reporting & accounting handoff
- The Billing Engineer Plans, pricing models & subscription lifecycle
- The Billing Engineer Revenue reporting & accounting handoff
- The Finance Lead Plans, pricing models & subscription lifecycle
- The Finance Lead Cross-border VAT & tax handling
- The Finance Lead Revenue reporting & accounting handoff
- The Finance Lead Plans, pricing models & subscription lifecycle
- The Finance Lead Revenue reporting & accounting handoff
- The SaaS Founder Plans, pricing models & subscription lifecycle
- The SaaS Founder Cross-border VAT & tax handling
- The SaaS Founder Revenue reporting & accounting handoff
- The SaaS Founder Plans, pricing models & subscription lifecycle
- The SaaS Founder Cross-border VAT & tax handling
- The SaaS Founder Revenue reporting & accounting handoff
- The Service-Business Owner Plans, pricing models & subscription lifecycle
- The Service-Business Owner Cross-border VAT & tax handling
- The Service-Business Owner Revenue reporting & accounting handoff
- The Service-Business Owner Plans, pricing models & subscription lifecycle
- The Service-Business Owner Cross-border VAT & tax handling
- The Service-Business Owner Revenue reporting & accounting handoff
- The Skeptic Plans, pricing models & subscription lifecycle
- The Skeptic Revenue reporting & accounting handoff
- The Skeptic Plans, pricing models & subscription lifecycle
- The Skeptic Cross-border VAT & tax handling
- The Skeptic Revenue reporting & accounting handoff
- The Tax Adviser Plans, pricing models & subscription lifecycle
- The Tax Adviser Revenue reporting & accounting handoff
- The Tax Adviser Plans, pricing models & subscription lifecycle
- The Tax Adviser Cross-border VAT & tax handling
- The Tax Adviser Revenue reporting & accounting handoff