Select App/Sandbox and configure real Features and Products. Product saves use their own version rules; Offering and Paywall publication are separate.
Product, Feature & Entitlement
Configure Features, Prices and Products; understand versions and Customer holdings.
API v1Updated
Before you start
Product, Feature and Entitlement
- Feature
- A capability or usage dimension. Its type is boolean, metered, credit_system or ai_credit_system; saving updates its current definition.
- Product
- Commercial terms containing Prices, Entitlements, an optional Free Trial and Licenses. Saving returns the applicable Product version.
- Entitlement
- A Product- or Reward-owned Feature grant, including allowance, reset and overage rules. A Customer Entitlement represents its effective allowance and balance.
- Variant
- A Product related to a base Product under the catalog's Variant rules.
- Offering
- A published, ordered hierarchy of direct Product references and metadata. It supports independent JSON delivery.
- Paywall
- Independent UI that pins a published Offering Version and owns its displayed Product subset, grouping, order and default selection.
- Funnel
- An explicitly invoked flow that composes independent capabilities and keeps its own published graph and execution state.
Related:Offering·Paywall·Stripe checkout
Configure and update a Product
- Configure a Feature under Product and billing → Entitlements. Create a Product under Plans and add Prices, Entitlements, an optional Free Trial and Licenses. Use the identity and version returned after saving.
- A Product update may modify an existing version or create another one; use the server result. Offering, Paywall and Funnel each have their own draft/publication flow. Product has no publish button.
- Stripe uses the Product/Price processor identities; Apple/Google use native Product bindings. Configure payment credentials under Payment connections for the current App/environment.
| Field | Meaning |
|---|---|
| internal_feature_id | Stable internal Feature UUID used by usage commands. |
| productVersionId | Wire field referencing the original Product version UUID, not a public business ID. |
| Offering Version id | Fixed hierarchy and terms evidence returned as offering.id. |
| couponId / offerId | Coupon definition UUID / this Customer's held Coupon grant UUID. |
Integration identities
internal_feature_id
- Meaning
- Stable internal Feature UUID used by usage commands.
productVersionId
- Meaning
- Wire field referencing the original Product version UUID, not a public business ID.
Offering Version id
- Meaning
- Fixed hierarchy and terms evidence returned as offering.id.
couponId / offerId
- Meaning
- Coupon definition UUID / this Customer's held Coupon grant UUID.
Eligible free default Products can initialize on Customer creation. Paid defaults, including paid cardless trials, require a separate verified billing flow. Confirm the result through readHoldings rather than inferring holdings from registration time.
Check your result
Expected outcome
Distinguish Feature UUIDs, Product version UUIDs and public business IDs. Verify grants by reading holdings, not by interpreting UI labels.