Create future rate plans
You can replace a rate plan with another rate plan. For example, suppose you created a standard rate plan that expires on December 31, 2015 and you want to replace it with another plan that goes into effect on January 1, 2016. To do that, you create a future rate plan and set it up to go into effect on January 1, 2016. You can also replace an existing rate plan with a future rate plan that starts today.
You can create a future rate plan using the management UI or monetization API. If you use the UI, you create a future plan in the package catalog.
If you use the API, you create a revision of the rate plan you want to replace and set up the revision to go into effect at a future date. You create the revision by issuing a POST request to the
If you want to replace an existing rate plan today, see Updating and deleting a rate plan. Otherwise, if you want to create a future version of a rate plan that starts sometime after today, follow these steps.
- In the package catalog, click +Future in the Draft/Future column for the rate plan that you want to replace.
This opens a future Rate Plan window.
The primary difference between a future rate plan window and a current rate plan window is the addition of an Existing Subscribers section.
- As you would for any rate plan:
- Enter a name for the plan in the Rate Plan Name field.
- Add fees to a rate plan (optional).
- Add a freemium plan (optional).
- Specify plan details, such as the type of rate plan.
- Specify a date when the future plan goes into effect (see Publish rate plans), and an end date (you can also select "No end date" if you don’t want the future rate plan to end on a specific date). The effective date of the future plan should be after the end date of the current plan.
- In the Existing Subscribers section, select either of the following:
- Restart full contract period on new effective date. The future rate plan goes into effect on the effective date. The renewal term of the future rate plan is the same as for the current rate plan.
- Deduct the time spent on previous contract from new period, on effective date. The future rate plan goes into effect on the effective date. The time spent using the current rate plan is deducted from the renewal term of the future rate plan. This means that if a developer uses the current plan for 3 months, and the renewal period is reduced by 3 months.
- In the Effective Date field, enter a start date that occurs after the end date of the existing rate plan.
You can create a future rate plan by creating a revision of the rate plan you want to replace and setting up the revision to go into effect at a future date. For details, see Creating a rate plan revision using the API.
You can manage and control you API products and packages after they're published. For example, you can limit the number of transactions on an API product. Learn more in Set limits.
Help or comments?
- If something's not working: Ask the Apigee Community or see Apigee Support.
- If something's wrong with the docs: Send Docs Feedback
(Incorrect? Unclear? Broken link? Typo?)