Send Docs Feedback

Create future rate plans

Introduction

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

If no end date is set for the current rate plan, you can replace an existing rate plan with a future rate plan that starts as early as today. For more information about expiring the current rate plan, see Expire a published rate plan.

Developers are notified about the revised rate plan. Those developers who accept the original rate plan are automatically registered for the revision (but have the option of rejecting the revision).

Toolbox

You can create a future rate plan using the management UI or monetization API.

  • Using the UI, use the package catalog.
  • Using the API, issue a POST request to the /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_id}/revision resource.

Creating a future rate plan using the UI

To create a future version of a rate plan using the UI, follow these steps.

  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:
  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.
  4. In the Effective Date field, enter a start date that occurs after the end date of the existing rate plan.

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.

Help or comments?