asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: separate Billing + Plans guide and add note for Indian cards (#13710)

Browse Source
This commit is contained in:
Shahed Nasser
2025-10-09 08:53:40 +03:00
committed by GitHub
parent 0cbd9f0bc3
commit 87a66ff37e
8 changed files with 100 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
www/apps/cloud/app/billing/manage/page.mdx
View File

@@ -81,6 +81,12 @@ To add a payment method that can be used for Cloud payments in an organization:
6. This will open a form where you can add credit card details.
7. Once you're done, click the "Save" button.
<Note title="Restrictions">
Cards issued by banks in India are not supported. Please use cards issued by banks in other countries.
</Note>
### Set Payment Method as Default
When Cloud captures the subscription payment for your organization, it first uses the default payment method in your organization. If payment fails, Cloud tries to use other payment methods in the organization, if available.

52
www/apps/cloud/app/billing/page.mdx
View File

@@ -99,39 +99,6 @@ You can view your add-on charges in the [Invoices](#view-billing-history-and-inv
---
## Change Plan
You choose your organization's plan when you sign up for Cloud. However, the plan may not be the best fit for your needs as your business grows or as you move to production.
Hobby or Pro organizations can change their plan from the Cloud dashboard. Enterprise organizations need to contact support to change their plan.
### What happens when I change my plan?
When you change your organization's plan, the following will happen:
- You'll be refunded the remaining days of your current plan.
- For example, if you are on a Pro plan and you change to a Hobby plan halfway through the month, you'll be refunded half of the Pro plan's cost.
- You'll be charged a pro-rated amount for your current billing cycle's [Flex Usage](../usage/page.mdx).
- You'll be charged upfront for the new plan.
### Change Your Organization's Plan
To change your organization's plan:
1. Make sure you're viewing the [correct organization's dashboard in Cloud](../organizations/page.mdx#switch-organization).
2. Click on the <InlineIcon Icon={ChevronUpDown} alt="switch organization" /> icon in the [organization switcher](../organizations/page.mdx#switch-organization) at the top left of the Cloud dashboard.
3. Choose "Organization Settings" from the dropdown.
4. Change to the "Billing" settings from the sidebar.
5. In the "Upcoming payment" section, click the "Change plan" button.
![Change plan button in the Billing settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1759415060/Cloud/CleanShot_2025-10-02_at_17.23.41_2x_dtqz5r.png)
6. In the modal that opens, choose either to upgrade to the Pro plan or downgrade to the Hobby plan.
- To upgrade to the Enterprise plan, contact support for assistance.
7. Confirm the plan change in the pop-up by clicking the "Confirm" button.
---
## Handle Unsuccessful Payments
If a payment for your organization's subscription fails, you'll receive a [notification](../notifications/page.mdx) in the Cloud dashboard.
@@ -139,22 +106,3 @@ If a payment for your organization's subscription fails, you'll receive a [notif
The payment may fail for various reasons, such as insufficient funds, an expired card, or other issues with the payment method. Make sure to [update your payment method](./manage/page.mdx#manage-payment-methods) if needed.
If there are no issues with your payment method and the payment still fails, contact support for assistance.
---
## Cancelling your Organization's Plan
You can cancel your organization's plan at any time. The plan will be cancelled at the end of the current billing period, and you will be charged for the month's plan and Flex Usage.
Hobby or Pro organizations can cancel their plan from the Cloud dashboard. Enterprise organizations need to contact support to cancel their plan.
To cancel your organization's plan:
1. Make sure you're viewing the [correct organization's dashboard in Cloud](../organizations/page.mdx#switch-organization).
2. Click on the <InlineIcon Icon={ChevronUpDown} alt="switch organization" /> icon in the [organization switcher](../organizations/page.mdx#switch-organization) at
3. Choose "Organization Settings" from the dropdown.
4. Change to the "Billing" settings from the sidebar.
5. Scroll down to the "Cancel plan" section and click the "Cancel plan" button.
6. Confirm the cancellation in the pop-up by clicking the "Confirm" button.
![Cancel plan section in the Billing settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1759415806/Cloud/CleanShot_2025-10-02_at_17.30.39_2x_d8ixwc.png)

60
www/apps/cloud/app/billing/plans/page.mdx Normal file
View File

@@ -0,0 +1,60 @@
import { InlineIcon } from "docs-ui"
import { ChevronUpDown } from "@medusajs/icons"
export const metadata = {
title: `Manage Plans`,
}
# {metadata.title}
In this guide, you'll learn how to view and manage your organization's plan in Cloud.
## Change Plan
You choose your organization's plan when you sign up for Cloud. However, the plan may not be the best fit for your needs as your business grows or as you move to production.
**Hobby** or **Pro** organizations can change their plan from the Cloud dashboard. **Enterprise** organizations need to contact support to change their plan.
### What happens when I change my plan?
When you change your organization's plan, the following will happen:
- You'll be refunded the remaining days of your current plan.
- For example, if you are on a Pro plan and you change to a Hobby plan halfway through the month, you'll be refunded half of the Pro plan's cost.
- You'll be charged a pro-rated amount for your current billing cycle's [Flex Usage](../../usage/page.mdx).
- You'll be charged upfront for the new plan.
### Change Your Organization's Plan
To change your organization's plan:
1. Make sure you're viewing the [correct organization's dashboard in Cloud](../../organizations/page.mdx#switch-organization).
2. Click on the <InlineIcon Icon={ChevronUpDown} alt="switch organization" /> icon in the [organization switcher](../../organizations/page.mdx#switch-organization) at the top left of the Cloud dashboard.
3. Choose "Organization Settings" from the dropdown.
4. Change to the "Billing" settings from the sidebar.
5. In the "Upcoming payment" section, click the "Change plan" button.
![Change plan button in the Billing settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1759415060/Cloud/CleanShot_2025-10-02_at_17.23.41_2x_dtqz5r.png)
6. In the modal that opens, choose either to upgrade to the Pro plan or downgrade to the Hobby plan.
- To upgrade to the Enterprise plan, contact support for assistance.
7. Confirm the plan change in the pop-up by clicking the "Confirm" button.
---
## Cancelling your Organization's Plan
You can cancel your organization's plan at any time. The plan will be cancelled at the end of the current billing period, and you will be charged for the month's plan and Flex Usage.
**Hobby** or **Pro** organizations can cancel their plan from the Cloud dashboard. **Enterprise** organizations need to contact support to cancel their plan.
To cancel your organization's plan:
1. Make sure you're viewing the [correct organization's dashboard in Cloud](../../organizations/page.mdx#switch-organization).
2. Click on the <InlineIcon Icon={ChevronUpDown} alt="switch organization" /> icon in the [organization switcher](../../organizations/page.mdx#switch-organization) at the top left of the Cloud dashboard.
3. Choose "Organization Settings" from the dropdown.
4. Change to the "Billing" settings from the sidebar.
5. Scroll down to the "Cancel plan" section and click the "Cancel plan" button.
6. Confirm the cancellation in the pop-up by clicking the "Confirm" button.
![Cancel plan section in the Billing settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1759415806/Cloud/CleanShot_2025-10-02_at_17.30.39_2x_d8ixwc.png)

10
www/apps/cloud/app/faq/page.mdx
View File

@@ -58,4 +58,12 @@ No, Medusa does not create new Medusa projects for your deployments. Instead, it
No, Medusa does not provide a static IP address for your Medusa project on Cloud. However, you can use a proxy that has a static IP address to connect to your Medusa project.
Contact support for help with setting up a proxy for your Medusa project.
Contact support for help with setting up a proxy for your Medusa project.
---
## My card from India is not being accepted. What should I do?
Cards issued by banks in India are not supported. Please use cards issued by banks in other countries.
You can also [contact support](https://medusajs.com/contact/) to discuss alternative payment methods for Pro and Enterprise plans.

6
www/apps/cloud/app/sign-up/page.mdx
View File

@@ -64,6 +64,12 @@ Learn about the different plans and their features in the [Plans guide](../prici
Next, you need to enter your card details. This is required for all plans.
<Note title="Restrictions">
Cards issued by banks in India are not supported. Please use cards issued by banks in other countries.
</Note>
Once you finish the sign-up, you will be charged upfront for the first month based on the plan you selected. You can learn more about this in the [Billing guide](../billing/page.mdx).
![Payment details form with card number, expiry date, and CVC fields](https://res.cloudinary.com/dza7lstvk/image/upload/v1757582477/Cloud/CleanShot_2025-09-11_at_12.20.06_2x_lzk7gu.png)

11
www/apps/cloud/generated/edit-dates.mjs
View File

@@ -16,11 +16,12 @@ export const generatedEditDates = {
"app/environments/environment-variables/page.mdx": "2025-08-15T15:35:24.085Z",
"app/environments/long-lived/page.mdx": "2025-10-02T11:58:36.623Z",
"app/environments/preview/page.mdx": "2025-10-02T13:06:32.356Z",
"app/faq/page.mdx": "2025-09-11T14:26:01.400Z",
"app/billing/page.mdx": "2025-10-02T14:37:27.199Z",
"app/faq/page.mdx": "2025-10-08T14:43:21.930Z",
"app/billing/page.mdx": "2025-10-08T14:37:11.611Z",
"app/usage/page.mdx": "2025-08-25T07:25:54.703Z",
"app/billing/manage/page.mdx": "2025-10-02T13:08:08.552Z",
"app/billing/manage/page.mdx": "2025-10-08T14:40:23.629Z",
"app/pricing/page.mdx": "2025-09-05T10:31:59.059Z",
"app/sign-up/page.mdx": "2025-09-29T10:16:20.885Z",
"app/comparison/page.mdx": "2025-09-30T06:17:40.257Z"
"app/sign-up/page.mdx": "2025-10-08T14:40:47.993Z",
"app/comparison/page.mdx": "2025-09-30T06:17:40.257Z",
"app/billing/plans/page.mdx": "2025-10-08T14:49:27.009Z"
}

8
www/apps/cloud/generated/sidebar.mjs
View File

@@ -195,6 +195,14 @@ export const generatedSidebars = [
"path": "/pricing",
"children": []
},
{
"loaded": true,
"isPathHref": true,
"type": "link",
"title": "Manage Plans",
"path": "/billing/plans",
"children": []
},
{
"loaded": true,
"isPathHref": true,

5
www/apps/cloud/sidebar.mjs
View File

@@ -133,6 +133,11 @@ export const sidebar = [
title: "Plans & Pricing",
path: "/pricing",
},
{
type: "link",
title: "Manage Plans",
path: "/billing/plans",
},
{
type: "link",
title: "Manage Billing Details",