Skip to main content
A subscription connects one customer to a published plan version. The active phase supplies the pricing and entitlement rules that Unprice uses for request-path decisions and billing evidence.

​
Create a subscription

Use customers.signUp for the normal first subscription flow. It creates the customer record and provisions the subscription from a published plan version.

​
Change a subscription

Use a new plan version when you change pricing or entitlements. Then move the customer to that version when the change should apply to them. This preserves the version that other customers bought.

​
Inspect commercial state

For a subscription, inspect the active plan version, billing period, entitlement state, usage, wallet movement, and invoice evidence. These records explain a commercial decision; they do not run the workload or capture payment. Read Customer signup SDK for the request and response shape.