Merge pull request #480 from kinde-oss/Feat/Billing-updates

Feat/billing updates - minor changes

Author: clairekinde11

src/content/docs/billing/manage-plans/upgrade-downgrade-plans.mdx

@@ -1,6 +1,6 @@
 ---
 page_id: e73bafc3-0a9c-48de-9b1a-d91897ffc6cb
-title: Plan upgrade and downgrade
+title: Plan upgrade and downgrade policies
 sidebar:
   order: 3
   relatedArticles:
@@ -20,21 +20,3 @@ By default, unpaid usage is forgiven and you don't refund or credit for unused s
 2. In the **Policies** section, choose the settings.
    ![Billing policies settings](https://imagedelivery.net/skPPZTHzSlcslvHjesZQcQ/1a4c3673-d972-4dd6-2c3a-d46b9eb70200/public)
 3. Select **Save**.
-
-## Ways you can change plans
-
-- Allow business customers to manage their plans via the [self-serve portal](/build/set-up-options/self-serve-portal-for-orgs/) if there's a [pricing table](/billing/billing-user-experience/plan-selection/).
-- Manually upgrade or downgrade via the Kinde UI (see below)
-- Programmatically upgrade or downgrade via API
-
-## Upgrade a plan for an organization (B2B) or user (B2C)
-
-1. Open the organization or user record in Kinde.
-   - Go to **Organizations** and locate the org.
-   - Go to **Users** and locate the user. 
-2. Select **Billing** in the side menu. Details of the org's or user's plan are shown.
-3. Select **Change plan**.
-4. In the dialog that appears, select the new plan.
-5. Select **Save**. The customer's plan is now updated.
-
-Depending on the billing policies you have set (above), this information will be synced to Stripe and an invoice credit or bill will be issued.

src/content/docs/billing/manage-subscribers/add-metered-usage.mdx

@@ -2,7 +2,7 @@
 page_id: 7060212e-5e8c-4188-acd3-e055e3474988
 title: Add metered usage for a customer via API
 sidebar:
-  order: 1
+  order: 3
 relatedArticles:
   - 7f59a705-ac5d-4b07-a44e-1421dcdeffe8
 ---

src/content/docs/billing/manage-subscribers/upgrade-downgrade-methods.mdx

@@ -0,0 +1,28 @@
+---
+page_id: 68ac4570-4aae-4d78-afda-208a4f56aef0
+title: Subscription upgrade and downgrade methods
+sidebar:
+  order: 1
+relatedArticles:
+  - e73bafc3-0a9c-48de-9b1a-d91897ffc6cb
+---
+
+Customers will eventually want to change the plan they are on and you need a way to alter their subscription.
+
+## How to upgrade or downgrade a plan subscription
+
+- Set up the self-serve portal and allow customers to manage their own subscriptions. See [self-serve portal for orgs](/build/set-up-options/self-serve-portal-for-orgs/) and [self-serve portal for users](/build/set-up-options/self-serve-portal-for-users/). In this scenario, the user will select the new plan from the pricing table.
+- Manually upgrade or downgrade via the Kinde UI (see below)
+- Overwrite the current agreement (subscription) by [creating a new one via API](/kinde-apis/management/#tag/billing-agreements/post/api/v1/billing/agreements/)
+
+## Change a plan subscription for an organization (B2B) or user (B2C)
+
+1. Open the organization or user record in Kinde.
+   - Go to **Organizations** and locate the org.
+   - Go to **Users** and locate the user. 
+2. Select **Billing** in the side menu. Details of the org's or user's plan are shown.
+3. Select **Change plan**.
+4. In the dialog that appears, select the new plan.
+5. Select **Save**. The customer's plan is now updated.
+
+Depending on the [billing policies](/billing/manage-plans/upgrade-downgrade-plans/) you have set, this information will be synced to Stripe and an invoice credit or bill will be issued.