> ## 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.

# Purchase Subscription

This flow shows how a customer purchases a Merchant subscription in the Reseller's (Service Provider's) digital store.

The steps in this flow are:

1. Confirm the Subscription Purchase
2. Provision a Merchant Partner Subscription
3. Activate the Service

**Note:** The APIs used for integration with Partner Ecosystem Management are the MarketONE APIs.

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyIntegrationFlow.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=45302187519deb1eb066b66ba89878e6" alt="Deployment Integration Sequence" width="1547" height="1685" data-path="marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyIntegrationFlow.png" />

## 1. Confirm the Subscription Purchase

The customer views the product catalog in the Reseller's (Service Provider's) storefront. The Reseller applies an eligibility check and presents the customer with the eligible offers. The customer purchases the subscription.

The Reseller creates the entitlement using the POST **/entitlement** endpoint and passes the Product ID.

**Note:** The Reseller typically processes the payment after sending the POST **/entitlement** request to the MarketONE OpenAPI. However, in some implementations, the Reseller could process the payment before sending the request.

**Note:** If the Reseller wants to link the billing subscription identifier to the entitlement in MarketONE, they can provide the Subscription ID in the **/entitlement** request.

As a result, the MarketONE OpenAPI creates the account and the Merchant Partner Subscription.

Here's a detailed view of this step:

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyOnboarding1.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=24a825423ca309e8770d24729058ed05" alt="Browse offerings and confirm subscription purchases sequence" width="1209" height="760" data-path="marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyOnboarding1.png" />

## 2. Provision a Merchant Partner Subscription

Asynchronously, the MarketONE OpenAPI generates the registration link and redemption code.

**Note:** Alternatively, Merchants can generate their own redemption code. If the Merchant generates the redemption code, the code will be sent to the MarketONE OpenAPI in the create entitlement request. If the redemption code isn't included in the call, the transaction won't be successful. If the redemption code is included in the call, the MarketONE OpenAPI will pass the code on to the Reseller (Service Provider). The Reseller can then send the code to the end customer to activate the subscription.

The MarketONE OpenAPI leverages the **AddSubscription** callback to notify the Merchant to provision the customer. The MarketONE OpenAPI notifies the Reseller with a POST **/notification** call containing the registration link and redemption code. Next, the Reseller should send the customer the registration link with the redemption code.

Here's a detailed view of this step:

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyOnboarding2.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=77a60213aa22ef99213e0e9e652fd990" alt="Provision Partner subscription sequence" width="1367" height="679" data-path="marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyOnboarding2.png" />

## 3. Activate the Service

The user activates their service by clicking the registration link and redeeming the code. On the Merchant's side of the integration, the customer creates their own Merchant-specific credentials.

The Merchant sends a Partner subscription activation response to the MarketONE OpenAPI. The MarketONE OpenAPI updates the subscription status to **Active**.

On the subscription renewal date, the Reseller (Service Provider) processes the renewal charges. If successful, the customer can continue to use the service.

Here's a detailed view of this step:

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyOnboarding3.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=25ebcfc8bc1685c39bcf609eb3414a5c" alt="Service activation sequence" width="1140" height="663" data-path="marketONE/plmOnlyResellerOnboardingGuide/images/M1OnlyOnboarding3.png" />

## Example of a Purchase and Renewal Scenario

<img src="https://mintcdn.com/amdocs-spbu/-GCj74mr5p4KPy3T/marketONE/plmOnlyResellerOnboardingGuide/images/PurchaseSubscription.png?fit=max&auto=format&n=-GCj74mr5p4KPy3T&q=85&s=7a81261d9d9d26120f66b8b4fca122e3" alt="Purchase Subscription and Renewal" width="1200" height="675" data-path="marketONE/plmOnlyResellerOnboardingGuide/images/PurchaseSubscription.png" />

**Parent topic:**[Back-End Integration Use Cases](M1onlyAggregatorIntegrationFlow)


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