You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs/api-platform/monetization/manage-rate-plans). info

## Introduction

After an existing rate plan is published, the only property you can change is its end date.
However, you can create a new version of the plan that includes changed properties, such as
changed rate plan rates. You can set up the revision to go into effect at a future date. The
original rate plan ends when the revision goes into effect.

For example, suppose you created a standard rate plan that expires on December 31, 2019 and
you want to replace it with another plan that goes into effect on January 1, 2020. To do that,
you create a future rate plan and set it up to go into effect on January 1, 2020.
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. You'll need to expire the current rate plan, as described in [Expire a
published rate plan](https://docs.apigee.com/api-platform/monetization/expire-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).

You can create a future rate plan using the management UI or monetization API, as described in
the following sections.

> [!NOTE]
> If you want to replace an existing rate plan today, see [Expire a published rate plan](https://docs.apigee.com/api-platform/monetization/expire-published-rate-plan).

## Creating a future rate plan using the UI

Create a future rate plan, as described below.

### Edge

To create a future version of a rate plan that starts sometime after today
using the Edge UI, perform the following steps.

1. On the [Rate Plans page](https://docs.apigee.com/api-platform/monetization/create-rate-plans#ui), position your cursor within the row associated with the rate plan for which you want to create a future rate plan.  
   The rate plan must have an end date.
2. Click **+Future**.
3. In the **Future rate plan** section, select one 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. Configure the following fields in the top panel:   
   **Note** : Other fields are read-only.

   | Field | Description | Default | Required |
   |---|---|---|---|
   | Rate plan name | Name of your rate plan. **Note**: The name does not need to match the original rate plan name. | Existing plan name | Yes |
   | Start date | Date the rate plan goes into effect. Enter a start date or select a date using the calendar. | Today | No |
   | End date | Date the rate plan ends. To specify an end date, enable the **Has End Date,** toggle switch and enter an end date or select a date using the calendar. **Note** : The rate plan will be in effect until the **end of the day** on the date specified. If you want to expire a rate plan on December 1, 2018, for example, you should set the endDate value to 2018-11-30. In this case, the rate plan will expire at the end of the day on November 30, 2018; all requests on December 1, 2018 will be blocked. | None | No |
   | Visible to portals | Set whether the rate plan is Public or Private. See [Public versus private rate plans](https://docs.apigee.com/api-platform/monetization/create-future-rate-plans#public-versus-private). | Enabled | No |

5. Configure fees for the rate plan. See [Configuring fees](https://docs.apigee.com/api-platform/monetization/add-fees-rate-plan).  
   **Note**: Not applicable to adjustable notification plans.
6. If you select a product bundle that contains more than one API product, set the following preferences in the **Specific or generic rate plan** section:   
   **Note** : This step is not applicable to adjustable notification plans.  

   | Field | Description | Default |
   |---|---|---|
   | Configure each product individually | Flag that specifies whether to configure an individual rate plan for each API product. | Disabled |
   | Configure each product's freemium offer individually | Flag that specifies whether to configure a freemium plan for each API product. | Disabled |
   | Select a product | If you enable one or both of the flags, you must select each product individually from the drop-down list and configure its rate plan details. **Note**: Make sure that you configure all products in the product bundle. | N/A |

7. Configure the rate plan details, based on the rate plan type selected:  
   - [Freemium](https://docs.apigee.com/api-platform/monetization/add-freemium-plan)
   - [Rate card](https://docs.apigee.com/api-platform/monetization/specify-rate-card-plan-details)
   - [Revenue share](https://docs.apigee.com/api-platform/monetization/specify-revenue-share-plan-details)
   - [Adjustable notification](https://docs.apigee.com/api-platform/monetization/specifying-adjustable-notification-plan-details)
8. Click one of the following:   

   | Button | Description |
   |---|---|
   | Update Draft | Save the rate plan as draft. The rate plan will not be visible to app developers until you publish it. You can edit any field in a draft rate plan. |
   | **Publish Draft** | Publish the plan. **Note** : After you publish a rate plan, you can only modify the end date if it is not already set. You cannot delete a rate plan after it's published, but you can expire the rate plan and replace it with a future rate plan, as described in [Expire a published rate plan](https://docs.apigee.com/api-platform/monetization/expire-published-rate-plan). |

### Classic Edge (Private Cloud)

> [!NOTE]
> **Note:** The Classic Edge UI is available with Edge for Private Cloud only.

To create a future version of a rate plan that starts sometime after today
using the Classic Edge UI, perform the following steps.

1. In the package catalog, click **+Future** in the Draft/Future column for the rate plan that you want to replace.

   ![](https://docs.apigee.com/static/api-platform/images/Future-button.png)

   This opens a future Rate Plan window.

   ![](https://docs.apigee.com/static/api-platform/images/Future-Rate-Plan-window.png)

   The primary difference between a future rate plan window and a current rate plan window is
   the addition of an Existing Subscribers section.

   ![](https://docs.apigee.com/static/api-platform/images/Existing-Subscribers-section.png)
2. As you would for any rate plan:
   - Enter a name for the plan in the Rate Plan Name field. The name does not have to match the name of the original rate plan.
   - [Configuring fees for a rate plan](https://docs.apigee.com/api-platform/monetization/add-fees-rate-plan) (optional).
   - Configure the rate plan details, based on the rate plan type selected:
     - [Freemium](https://docs.apigee.com/api-platform/monetization/add-freemium-plan)
     - [Rate card](https://docs.apigee.com/api-platform/monetization/specify-rate-card-plan-details)
     - [Revenue share](https://docs.apigee.com/api-platform/monetization/specify-revenue-share-plan-details)
     - [Adjustable notification](https://docs.apigee.com/api-platform/monetization/specifying-adjustable-notification-plan-details)
   - Specify a date when the future plan goes into effect (see [Publishing rate plans](https://docs.apigee.com/api-platform/monetization/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). If an end date is set for the current plan, then 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.
4. In the Effective Date field, enter a start date that occurs after the end date of the existing rate plan.

## Creating a future rate plan using the API

You can create a future rate plan using the API by issuing a `POST` request to
`/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision`.

Where:

- `{org_id}` is the name of the organization.
- `{package_id}` is the identification of the API package.
- `{plan_Id}` is the identification of the rate plan.

When you create the revision, you must specify the following properties in the request body:

<!-- -->

- `parentRatePlan` specifies the ID of the original rate plan.
- `startDate` specifies the date that the new plan takes effect.

The name of the future rate plan must not match the name of the original plan. Also, it must be
unique among all of your rate plans. If you want to keep the original start date recorded for
the developers, set the `keepOriginalStartDate` flag to `true`. This flag
defaults to `false`.

For more information about the configuration settings, see [Configuration settings for rate plans](https://docs.apigee.com/api-platform/monetization/create-rate-plans#creatingrateplansusingtheapi-configurationsettingsforrateplans).

For example, the following request creates a future rate plan:

```
$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "parentRatePlan": {
       "id": "monetization_package_flat_rate_card_plan_1379513833409"
     },
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "myorg"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.05",
        "startUnit": "0"       
       }      
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2014-01-01 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password
```