> ## Documentation Index
> Fetch the complete documentation index at: https://docs.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform-Managed Product Lifecycle Integration

This onboarding and monetization flow requires that the [Platform-Managed](g_platformManagedFlow) subscriptions integrate with the MarketONE OpenAPIs. This integration has multiple steps. The following image provides a generic example of this integration in action at a high level.<img src="https://mintcdn.com/amdocs-spbu/v6XW4z-1DbX5IGa9/marketONE/merchantOnboardingGuide/images/M1ManagedSubscriptionIntegrations.png?fit=max&auto=format&n=v6XW4z-1DbX5IGa9&q=85&s=f6333b30d2e27bc145dae4879459b222" alt="Platform-Managed Subscription Flow" width="1742" height="747" data-path="marketONE/merchantOnboardingGuide/images/M1ManagedSubscriptionIntegrations.png" />

For more details on the integration, see the [Platform-Managed Use Cases](dgPlatformUseCases).

**Note:** The Merchant's system must support idempotency for successful subscription status management. For more information, see the **Idempotency** section in the [Design Guidelines for the Platform-Managed Flow](designGuidelinesPlatformManaged).

## 1. Creating a Subscription

MarketONE leverages an `AddSubscription` callback URL to notify the Merchant to provision the subscription.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/merchantOnboardingGuide/images/m1process_step1.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=45caf50b4c2e531ce0bcd656fcdcd367" alt="Creating a Subscription" width="1474" height="818" data-path="marketONE/merchantOnboardingGuide/images/m1process_step1.png" />

## 2. Activating a Subscription

The user gets the activation link with the embedded redemption code from the Reseller (Service Provider). When the user clicks the link, the Merchant gets the redemption code. The Merchant uses this code to match the redemption code MarketONE sent. The Merchant manages the user identity through sign up, sign in or an existing session.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/merchantOnboardingGuide/images/m1process_step2.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=1151ae3249cf8f597a20c70691d7063e" alt="Activating a Subscription" width="1604" height="662" data-path="marketONE/merchantOnboardingGuide/images/m1process_step2.png" />

## 3. Updating the Subscription Status

The Merchant sends the change in the subscription status (Active) to MarketONE using the `PUT /partnerSubscription/{id}` API call.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/merchantOnboardingGuide/images/m1process_step3.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=d29174e1cdff8ad21cd61c2dc3560de5" alt="Updating a Subscription" width="1588" height="594" data-path="marketONE/merchantOnboardingGuide/images/m1process_step3.png" />

## 4. Canceling a Subscription

When a user confirms cancellation of their subscription in the Reseller's digital store, or when the user's account with the Reseller is no longer in good standing, it triggers a `DeleteSubscription` callback to the Merchant. The Merchant locates the existing subscription with the `partnerSubscriptionID` sent by MarketONE. The Merchant deactivates the user's entitlement.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/merchantOnboardingGuide/images/m1process_step4.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=72dab81ce27eff87ea62624feec064ad" alt="" width="1327" height="777" data-path="marketONE/merchantOnboardingGuide/images/m1process_step4.png" />

## 5. Updating an Existing Subscription

When the user confirms an upgrade or downgrade in the Reseller's digital store, it triggers an `UpdateSubscription` event/callback to the Merchant with a new product code. The Merchant replaces the product code and grants the user access to the new product of the same subscription.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/merchantOnboardingGuide/images/m1process_step5.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=ff32c5ff09b69b61e37df4ad1349643a" alt="" width="1512" height="693" data-path="marketONE/merchantOnboardingGuide/images/m1process_step5.png" />

## 6. Pausing a Subscription

**Note:** Both the Merchant and Reseller (Service Provider) must support the pause and resume callbacks to use this functionality.

When the user pauses their subscription in the Reseller's digital store, it triggers a `PauseSubscription` callback to the Merchant. The Merchant locates the existing subscription in the `partnerSubscriptionID` that MarketONE sent and pauses the user's entitlement.

<img src="https://mintcdn.com/amdocs-spbu/v6XW4z-1DbX5IGa9/marketONE/merchantOnboardingGuide/images/Partner_PauseSubscription.png?fit=max&auto=format&n=v6XW4z-1DbX5IGa9&q=85&s=f8b8c5aa6fd2d649064154d4fdf557c5" alt="" width="1436" height="771" data-path="marketONE/merchantOnboardingGuide/images/Partner_PauseSubscription.png" />

## 7. Resuming a Subscription

**Note:** Both the Merchant and Reseller (Service Provider) must support the pause and resume callbacks to use this functionality.

When a user resumes a paused subscription in the Reseller's digital store, it will trigger a `ResumeSubscription` callback to the Merchant. The Merchant locates the existing subscription in the `partnerSubscriptionID` that MarketONE sent and resumes the user's entitlement.

<img src="https://mintcdn.com/amdocs-spbu/v6XW4z-1DbX5IGa9/marketONE/merchantOnboardingGuide/images/Partner_ResumeSubscription.png?fit=max&auto=format&n=v6XW4z-1DbX5IGa9&q=85&s=355f0452dc8d00f24518ca5dd2975ff9" alt="" width="1335" height="688" data-path="marketONE/merchantOnboardingGuide/images/Partner_ResumeSubscription.png" />

**Parent topic:**[Step 1: Discovery and Education](partnerOnboardingDiscovery_r)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.