Offerings
An offering is a combination of products and plans; products are combined with one or more plans to form an offering.
For example, your company provides online streaming of movies, web-series, and music. Your customers can purchase these services through either a weekly or monthly plan.
Offering products can be either:
- a subscription product, see Create a product.
- a Product Experience Manager product, see Create a product
Offering Examples
Offerings can have any combination of products and plans. The pricing of an offering is determined by the pricing you have configured for your products and plans.
Example | Product | Plans | Offering |
---|---|---|---|
Single product and plan | One product with a product price of $50 | A monthly plan with a 5% discount | An offering with a monthly plan for $47.50 a month |
Single product with multiple plans | One product with a product price of $50 |
| An offering with two plans:
|
Multiple products and plan | Two products:
| A monthly plan with a 5% discount. | An offering with a monthly plan for $118.75 a month. |
Multiple products with multiple plans | Two products:
|
| An offering with two plans:
|
Building an Offering
Offerings represent a snapshot of their products and plans. If you make updates to products or plans within an offering, the original products and plans are not updated. Only the products and plans within the offering are updated. Alternatively, you can create new products or plans and attach them to a new offering.
When you are building an offering:
- you can create new plans and products.
- you can modify existing products and plans. For example, you can modify the product price or any attributes of a plan included in the offering.
Here's how you build an offering:
Create your repeat products. Products can either be subscription products or Product Experience Manager products.
- to create a subscription product, see Create a product.
- to create a Product Experience Manager product, see Create a product
Create your plans.
- Plans are the rules that govern your subscription, for example, any discount.
- You can combine and reuse plans for as many products as you want, making it quick and easy to create your subscription offerings.
- An offering must have at least one plan. See Create a plan.
Build your offerings. Offerings are the products and plans that a customer can choose. An offering can consist of many combinations of a product or plans, depending on the products and services you offer.
- When a customer chooses a plan, a subscription is created. See Subscriptions.
- Elastic Path Subscriptions manages the billing and recurring payments associated with the subscription. See Invoicing and Billing.
Editing Offerings
After saving an offering, you can, at any time:
- update an offering's details, for example, name or description. See Update an Offering.
- update the existing product and plans.
- replace an existing product in an offering with a new one. See Replace a Product
- attach a new plan to an offering. See Attach a Plan.
- remove plans. See Removing a plan from an offering.
Any modifications that you make to offerings, and products or plans in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.
📄️ Create an offering
Create an offering
📄️ List offerings
Retrieves a list of all subscription offerings.
📄️ Build an offering
An offering includes products and plans; products are combined with one or more plans to form an offering. An offering can include either:
📄️ Get offering
Get offering
📄️ Delete offering
When a subscription is created, it creates a snapshot of the offering. This means you can delete an offering without affecting any active subscriptions.
📄️ Update an offering
After saving an offering, you can update an offering at any time. Updating an offering does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.
📄️ List an offering's plans
List an offering's plans
📄️ Attach a plan
After saving an offering, you can attach new plans to it at any time.
📄️ Updates a plan in an offering
Updates a plan in an offering
📄️ Remove a plan from an offering
After saving an offering, you can remove plans from it at any time.
📄️ List an offering's products
List an offering's products
📄️ Attach a product
After saving an offering, you can attach new products to it at any time.
📄️ Replace a product
After saving an offering, you can replace its products at any time.
📄️ Manage prorations on an offering
Proration ensures that subscribers are only charged for the actual time they use a service, whether they upgrade, downgrade, start, or cancel their subscription partway through a billing cycle. By default, proration is not enabled for Subscriptions. Once you have attached a proration policy to an offering, proration is enabled automatically.
📄️ Updates a product in an offering
Use the unique identifier of the product in the offering that you want to update. Any modifications that you make to the products in an offering, does not affect any active subscriptions. The changes take effect on all new subscriptions that are created.
📄️ Remove a product from an offering
After saving an offering, you can remove products from it at any time.