Was this helpful?

Introduction

You can replace a rate plan with another rate plan. For example, suppose you created a standard rate plan that expires on December 31, 2013 and you want to replace it with another plan that goes into effect on January 1, 2014. To do that, you create a future rate plan and set it up to go into effect on January 1, 2014.

Toolbox

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 /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_id}/revision resource.

Setting up a future rate plan using the UI

  1. 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.

  2. 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.
  3. 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.

Setting up a future rate plan using the API

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.

Get help

For help, see Apigee Customer Support.

Next steps

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.

Add new comment

Provide your email address if you wish to be contacted offline about your comment.
We will not display your email address as part of your comment.

We'd love your feedback and perspective! Please be as specific as possible.
Type the characters you see in this picture. (verify using audio)

Type the characters you see in the picture above; if you can't read them, submit the form and a new image will be generated. Not case sensitive.