# Product Subscription

## Introduction

The Product Subscription extension on the Fynd Commerce allows the customer to maintain ongoing access to the product or service for as long as they continue to pay a subscription fee. Subscribers pay a recurring fee at regular intervals (such as weekly, monthly or annually) based on the subscription plan to access a product or service provided by a sales channel, rather than making a one-time purchase.

## Steps to Use **Product Subscription** Extension

1. Go to the **Extensions** section in the Fynd Platform.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image.png)

center
em
Figure 1: Extensions Section - Fynd Platform
br
1. Select **Product Subscription** extension.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(1).png)

center
em
Figure 2: Product Subscription Extension
br
Once you have installed this extension, it will be available in the **Extensions** section on the Fynd Platform.

1. Go to the desired sales channel for which you wish to enable the extension by clicking the arrow. Here, we have selected **test-pages**.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(4).png)

center
em
Figure 3: Selecting Desired Sales Channel
br
1. Activate the extension by toggling the master button located at the top-right corner.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/1.png)

center
em
Figure 4: Activate the Extension
br
Enabling the extension on a sales channel will result in a corresponding status update of "active" or "inactive".

The **Product Subscription** extension has been successfully enabled. In the following sections, you will be guided through the configuration pages for the complete setup of product subscription. The extension offers three distinct features, each designed to address various functionalities.

1. [Manage Plans](#manage-plans)
2. [Manage Customers](#manage-customers)
3. [Emails](#emails)
4. Dashboard (Coming Soon)


## Manage Plans

In this section, sellers can create a subscription plan for a list of products and offer a discount on recurring purchase to subscribers. All the available plans will display as a list. Sellers can review the type, start date, and status of each plan. Additionally, sellers have the option to activate or deactivate any plan directly from this section.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(8).png)

center
em
Figure 5: Actions on Manage Plans Page
br
1. **Plan Name**: Provide a clear and descriptive title for your plan that effectively communicates its purpose and ensures easy understanding. This is for seller’s reference and is not shown to the customer.
For instance, if you're creating a subscription plan where customers can receive monthly tea bag deliveries at a 20% discount on MRP, you can name the plan "*Tea Bag Subscription: Enjoy 20% Off!*".
2. **Frequency**: Select the frequency based on your subscription model which will create recurring order for your customers. Whether it's daily, monthly, or quarterly, selecting the appropriate frequency is crucial to align with the subscription plan.
For the monthly plan, customers are required to renew their subscription every month. Therefore, the frequency is set to "*Monthly*."
3. **Promotions**: Add a promotion to your subscription plan to offer lucrative offers and discount for subscription purchases. The promotion can be offered as a flat off or percentage discount. This will be applicable to all the recurring orders.
For example, the subscription offers 20% discount on every recurring order. (as shown in the screenshot below)
4. **Plan Schedule**: Establish a schedule by setting definitive start and end dates for the plan. If the end date is not defined, the plan will be visible on the storefront without any set termination date. The new customers will be able to purchase the subscription during this duration only. The existing customers who have made a purchase already will continue to receive orders even after the end date.
For example, the subscription offer will be valid for one year, running from 01 February 2024 to 29 July 2026 09:01 PM IST. (as shown in the screenshot below)
5. **Select Product**: Select the appropriate products for which the plans are applicable on the sales channel. The plan will be available for the selected products as per the plan schedule (Point 4) on the sales channel.
6. Click **Save** to create your plan.


A plan named with *Tea Bag Subscription: Enjoy 20% Off!* will be available in the list of available plans.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/2.png)

center
em
Figure 6: Create New Plan
br
## Manage Customers

This section provides sellers with a clear overview of subscriber’s details and purchase activity. It enables sellers to track subscriber history and take action to adjust subscription status as required. The details include name of the subscriber, email ID, phone number, the date when they subscribed, frequency of subscription, status, and history.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/1-N2v12ZcUF.png)

center
em
Figure 7: Manage Customers
br
Subscribers can have any of the following statuses:

1. **Inactive**: The subscription has been closed by the seller. This state cannot be undone. If the same customer purchases the subscription again, a new subscription row entry will be created.
2. **Pause**: The subscription has been temporarily paused because the customer failed to make a payment for an upcoming order. An email reminder is sent to the customer regarding the subscription renewal. If the customer makes the payment within 48 hours the subscription is kept active. This is a temporary step, seller can resume the subscription post which again the payment link will be sent to the customer.
3. **Active**: The subscription is currently active for the customer. The payment link will be sent to the customer as per the frequency. Post successful payment, an order will be placed for the customer.


The seller can filter the details present on the page based on the following criteria:

1. Customer's name, email or phone number
2. Type of subscription
3. Status of the subscription


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/4.png)

center
em
Figure 8: Actions on Manage Customers Page
br
The seller can access the customer's details and view the consolidated order and payment history for the respective subscriber by clicking the **Eye** icon.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/3.png)

center
em
Figure 9: View History
br
On the **View History** page, seller can access the following details:

1. **Product Code**: Unique identifier for the product associated with the subscription.
2. **Plan ID**: Identification number assigned to the subscription plan.
3. **Status**: Indicates the current status of the subscription, such as active, paused, or inactive.
4. **Amount**: Displays the amount charged for the subscription.
5. **Status of Upcoming Order**: Provides information about the status of the next scheduled order, such as pending, processed, or cancelled.
6. **Order History**: Shows a comprehensive history of past orders associated with the subscription, including order id, dates, and statuses.


## Emails

This section lists all the email templates that are sent to the customers regarding product subscription.

1. **Welcome Email**: This email is sent to customers upon successful purchase of subscription to a product.
2. **Payment Confirmation Email**: This email is sent as a confirmation of cancel event for a subscription.
3. **Subscription Paused Email**: This email is sent to inform the customer in case subscription has been temporarily paused.
4. **Subscription Cancellation Confirmation**: This email is sent as a confirmation of cancel event for a subscription.
5. **Subscription Resumed Email**: This email is sent to inform the customer in case subscription has been resumed after been paused.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/6.png)

center
em
Figure 10: Emails
br
Additionally, sellers can click on the edit button next to each email template to make any necessary changes to the email template. They can also test the email by sending a sample to their own email address.

When editing the email, the seller can select the default provider from a list of all available providers for the respective sales channel. Additionally, seller has an option to customise the subject of the email to align with their business need.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/7.png)

center
em
Figure 11: Edit or Test Emails
br
## Adding Product Subscription Extension in Theme

1. Go to **Sales Channel**. Here we have selected **test-pages**.
2. Click **Appearance**.
3. Click **Theme**.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(18).png)

center
em
Figure 12: Theme Page
br
1. Click **Edit**. Theme editor will appear.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(19).png)

center
em
Figure 13: Edit Theme Page
br
Now, we will add the product subscription extension wrapper in our theme.

1. Select **Product Description** option from the drop down.
2. Go to the **Page** tab under **Sections**.
3. Select **Extension** as product subscription in below delivery location.
4. Select wrapper as Product Subscription.
5. Click **Save**.


![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(20).png)

center
em
Figure 14: Product Description Page on Themes
br
## Final Output

### Customer Journey

If the customer is not logged on the storefront, they will be prompted to log in on the product display page of the sales channel saying **LOGIN TO SUBSCRIBE**.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(14)-mg5SB154h.png)

center
em
Figure 15: Product Description Page
br
Once logged in, customers will be able to see the **SUBSCRIBE AND SAVE** button on the Product Description Page (PDP).

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(15)-gNzVBBUtx.png)

center
em
Figure 16: Subscribe and Save
br
Upon clicking **SUBSCRIBE AND SAVE**, customers will be prompted to select the plan along with an email ID in case email is not available for the logged in customer. This email ID will be used to send all subscription related communication.

Click **SELECT & PROCEED**.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(16)-ufF1qSDvK.png)

center
em
Figure 17: Enter Email ID to Proceed
br
Customers will provide delivery details similar to checkout journey. The subscription discount will be added in the price summary during checkout as shown below.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(17)-A0Tu_44sM.png)

center
em
Figure 18: Subscription Discount on Checkout Page
br
The customer can pay the remaining amount with any mode of payment to buy the selected product on subscription.
After successful payment, the order will be created for the customer.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(18)-Fsudli6Tx.png)

center
em
Figure 19: Payment Page
br
![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(19)-R6lahizrW.png)

center
em
Figure 20: Order Confirmation
br
Once the subscription order is successful, customer receives a welcome email.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(20)-2sKwRWVFq.png)

center
em
Figure 21: Welcome Email
br
### Seller Journey

Once the seller creates the subscription plan from the **Manage Plan** section, the customer will be able to see the subscription on the product description page.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(21).png)

center
em
Figure 22: Subscription Plan on Product Description Page
br
Additionally, the details of the customer subscription are reflected in the **Manage Customer**  section, where the status of the subscriber is active, which is available in the **History** section.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(22).png)

center
em
Figure 23: Customer Status on Manage Customer Page
br
![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(23).png)

center
em
Figure 24: Customer Details on History Page
br
For the next upcoming order due date, the customer receives a **Pay Now** email. This email contains a payment link that is valid for 10 minutes.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(24).png)

center
em
Figure 25: Payment Link Email
br
If the customer successfully completes the payment within the 10-minute, the order is marked as placed and can be processed ahead.

If the payment is not completed within the 10-minute window, a payment regenerate link email is sent to the customer. This regenerate link is valid for 48 hours. The customer can click on the same to generate a new payment link which will again be valid for 10 mins. If the customer completes the payment using the link, the order is marked as placed and can be processed ahead.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(25).png)

center
em
Figure 26: Payment Link Regeneration Email
br
If the payment is not completed within the 48-hour window, The subscription is paused and a subscription pause email is sent to the customer.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(26).png)

center
em
Figure 27: Customer Status on Manage Customer Page 
br
![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(27).png)

center
em
Figure 28: Customer Details on History Page
br
The status of the customer remains paused. If the seller wishes to deactivate the paused customer from the platform, he can change the status of the subscriber to **Inactive** and a subscription cancellation email is sent to the customer.

Once the customer is marked inactive, it cannot be marked active again with the same subscriber ID. In case, the customer makes the same purchase using subscription, it will be treated as a new customer.

![QG1](https://cdn.pixelbin.io/v2/doc/original/moonlight/Extensions/Product_subscription/image(28).png)

center
em
Figure 29: Typical Customer/Seller Journey Explained via Flowchart
br