Skip to content

API-32428 - Update subscription_management.md #896

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lbadenhop merged 1 commit into from
Jun 25, 2026
Merged

API-32428 - Update subscription_management.md #896

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 23 additions & 1 deletion content/en/docs/manage_marketplace/consumer_experience/subscription_management.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ As a consumer, learn how to create a free or paid subscription and manage existi

Anyone who is authenticated in the Marketplace can subscribe to a product with the following role restrictions:

| Persona | Subscribe to a paid plan | subscribe to a free plan |
| Persona | Subscribe to a paid or custom plan | Subscribe to a free plan |
|-----------------------|--------------------------|--------------------------|
| Subscription Manager | Authorized | Authorized |
| Engage Administrator | Authorized | Authorized |
Expand Down Expand Up @@ -60,6 +60,22 @@ Once submitted, a subscription request goes through an approval process:
| **Declined** | The subscription request has been declined by the provider for several reasons (compliance, payment issues, etc.). Applications cannot use the product |
| **Error** | There is an error in processing the subscription request. Typically, a system error |

### Custom plan subscriptions

Custom plans follow the same permission model as Paid plans:

* Public users cannot subscribe to Custom plans.
* Users with Paid plan permission can subscribe to Custom plans.

If a consumer lacks Paid plan permission, the Subscribe button is hidden and the plan card indicates elevated access is required.

The subscription flow for Custom plans differs from Paid plans:

* Plan type displays as **Custom** throughout the flow.
* No pricing or payment step is presented.
* Engage Billing is not invoked — no invoices or payment records are created.
* Approval flows and provisioning work the same as any other plan type.

### Subscription status

Once the subscription is approved, the state of the subscription indicates whether it is usable or not. The state is not set until the subscription is approved.
Expand Down Expand Up @@ -99,6 +115,12 @@ The *subscription details* page provides:
* Subscription usage breakdown per subscription plan quota. This breakdown allows to see how much has been consumed for the current billing period.
* Subscription history (requested time / last approval / rejection time).

For Custom plan subscriptions, the *subscription details* page differs:

* Plan type displays as **Custom** on all subscription-related screens.
* No pricing, billing, or invoice information is shown.
* Quota usage and limits display normally based on Standard Quota configuration.

### Terminate a subscription

When a subscription is no longer needed, it should be terminated to prevent access to the resources that are using that subscription.
Expand Down
Loading