# Trial-with-Payment Subscriptions (NCS Circ)

{% hint style="danger" %}
**DISCLAIMER**

*Product Information contained within this document, including technical information and functional specifications, is subject to change without notice. Naviga reserves the right to make any changes to the information in this document at any time without notice. Naviga makes no warranty, representation, or guarantee regarding the suitability of its products and services for any particular purpose.*
{% endhint %}

## What is a Trial-with-payment subscription?

A Trial-with-payment subscription allows end-users to try a subscription for free before deciding whether to purchase it.&#x20;

### **Trial-with-Payment Subscription Details**

This feature enables a publication to collect payment information, such as credit card and/or bank details when an end-user subscribes to a Trial. The payment information is collected and authorized for $1 without any actual deduction from the subscriber’s account at the time of the Trial purchase. This information is then tokenized and securely submitted to the NCS circulation system.

Publications can set a Trial duration in days, weeks, or months, independently of the actual rate and term for the offer using the SolCon application. Auto-renewal (EZPay) is mandatory for Trial offers, so at the end of the Trial period, a subscriber is billed for a standard subscription using the tokenized payment information.

An end user can cancel the Trial subscription anytime during the trial period, however the **cancellation** can happen **only through the Self Service** portal.

* Regardless of payment success/failure, when the Trial End Date is reached, the 'Subscription kind' in Subscribe changes from **Trial** to **Standard**.&#x20;
* The actual status of the subscription, however, will depend on the payment status;

  * **Active** - when payment is successful
  * **Perm Stopped** / **In Grace** depending upon trial-specific Grace period setup in NCS.&#x20;

  For more details on Trial features within NCS, [click here](https://docs.navigaglobal.com/naviga-subscribe/welcome-to-subscribe/service-packs/2020.4.0-version/2020.4.0-enhancements).

In Account Management (Self-Service), a banner reminds the end date of Trial subscriptions. This banner will be displayed every time a subscriber logs in to Account Management till the Trial period ends. The user can close this banner, if required, by clicking the 'X' button.

A similar banner with a warning message is displayed in the Account Info tab of the SubCon Admin Portal too.

## Before you start

For this feature to be implemented the following prerequisites must be met:

* The minimum Subscribe version: 3.16.2 &#x20;
* The minimum NCS Circ version:[ 2020.4.0](https://docs.navigaglobal.com/ncs-circ-release-notes/circulation-release-notes/ncs-circ-maintenance-release-2020-4.0)
* Subscribe **extracts version 5** is required

{% hint style="warning" %}
Please note that during implementation, **the sync job** has to be **updated to 3.16.2**.
{% endhint %}

## Setup Guide

To avail Trial-with-payments feature, you need to:

1. Set up a Trial offer in Solicitor Concierge.
2. Set up the CMS presentation to display the Trial offer on the Subscription Panel.
3. Key setting in the Support Viewer.

### 1. SolCon Settings

To set up a Trial-with-Payment offer with an end date in Solicitor Concierge please perform the following steps:

1. Select **Offer Groups** from the left sidebar.&#x20;
2. Select the **Additional Options** category.
   1. Select the **Subscription Kind** section, and check the option, `Trial`. Select the Trial period unit (Day/Week/Month). Enter the number of trial days/weeks/months that are offered.  \
      **Note**: Once the offer group is published, the whole Subscription Kind section including the number of trial days cannot be edited. If you need to edit an existing Trial subscription, select the corresponding offer, and click the Save As New button to make the Subscription Kind section editable again.
   2. Select the **Auto-renew** section and ensure the `Auto-renew Required` option is selected. <br>

      <figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2FG2dQNrsZYm0GO5L20hn7%2Fadditional%20options.png?alt=media&#x26;token=550f6b7d-8267-4578-8650-2f05f20aaa12" alt=""><figcaption><p>Subscription Kind and Auto-renew sections</p></figcaption></figure>
   3. Select the Payment Method section and select the desired payment method options(s).&#x20;
3. Select the **Coding** category.

   1. Select the **Billing Systems Code** section. Ensure to set up all the required rate-related details such as Rate Code, Reason Code, Billing Method, Term, and Term Length. \
      **Note**: Rate Code, Reason Code, Term, and Term Length will be reflected from NCS in SolCon.
   2. Set **Delivery Method** to `Online` since a Trial subscription is supported only for digital products.

   <figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2FfOuwoj6Mkb1cl52qOOhK%2Fbilling%20system%20codes.png?alt=media&#x26;token=507d3b51-df01-4a82-8bc0-f3851664d41f" alt=""><figcaption></figcaption></figure>
4. Click **Save Draft** or **Publish**.
5. Click **Clear Cache** button on the top menu bar of SolCon.

### 2. CMS settings&#x20;

Set up a subscription Presentation in the CMS application for the Trial offer. Follow the same steps as a standard SolCon offer.&#x20;

*CMS > Subscription Panel > Presentation > Select any Presentation from the drop-down.*

<figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2FXd5NJaJgAXSXi9Q6qhSH%2FTitle%20of%20landing%20tile.png?alt=media&#x26;token=d48551f2-694f-4f23-acbf-3e3683a4611f" alt=""><figcaption><p>Title of the Landing Tile CMS Setting</p></figcaption></figure>

<figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2FhhEputz4Yfsn5ebXGaI2%2Flanding%20tile%20Title.png?alt=media&#x26;token=fe339033-cb21-4aea-afd1-97a07662bde0" alt=""><figcaption><p>Title and Trial button of the landing tile on the Subscription Panel</p></figcaption></figure>

4. After making any updates, click the **Save** button on the corresponding component.&#x20;

5. To customize the **Payment Information** tab:\
   You can reassure users with a message stating that no money will be deducted during the Trial subscription purchase, even though payment details are collected. To set this up, follow these steps:

   1. Navigate to Page V3 (the page following the landing page).
   2. Select Step V3 (Payment step) > Details.
   3. Enter the reassurance message in the **Subtitle** text field.<br>

      <figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2Fv8GxPLE2EMliySJ5tc1n%2Fpayment%20info%20tab%20message%20setting.png?alt=media&#x26;token=e24b7dfb-cdac-4593-9cde-136712edd15c" alt=""><figcaption><p>Payment Information tab message setting</p></figcaption></figure>

      <figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2FhPkBq6xbcz8hyL6wqVSB%2Fpayment%20info%20message.png?alt=media&#x26;token=7462fc36-ad3a-49bd-8292-9fabc6ff2558" alt="" width="364"><figcaption><p>Payment Information tab message</p></figcaption></figure>

6. To customize the **Confirmation page**:\
   You can display user a congratulatory message for purchasing the Free Trial subscription. Follow these steps:

   1. Navigate to Page V3 (the final page)
   2. Select Confirmation V3 (Confirmation step) > Details
   3. Enter the congratulatory message in the Title field.

   <figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2FuFAJ9XmxbmVlz7JjYoKT%2Fconfirmation%20page%20message%20setting.png?alt=media&#x26;token=0e7b661c-0219-4748-bf28-bc1e6c9a3561" alt=""><figcaption><p>Congratulatory message setting on the Final page</p></figcaption></figure>

   <figure><img src="https://976659993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MHtWY24ZsNeJjetCpNF%2Fuploads%2Fs9wNCf3GfFRE0c73C9G9%2Fconfirmation%20message.png?alt=media&#x26;token=1dba0231-35ef-433e-9880-34c212ea2f3c" alt=""><figcaption><p>Congratulatory message displayed on the final page</p></figcaption></figure>

7. It is mandatory to select Refresh Panel from the page-top menu bar and click the option 'Refresh CMS+Panel' before you leave the editing of the presentation to reflect the changes in the Presentation on Subscription Panel.&#x20;

### 3. Support Viewer Settings

The Trial subscription kind is configurable from MG2control or **Support Viewer**. The App Setting key '**OfferGroupAdditionalOptionTrialFlag**' configures and displays the 'Trial' subscription kind in Solcon.&#x20;

* If the value of OfferGroupAdditionalOptionTrialFlag is 1, the 'Trial' subscription kind is available in SolCon and a Trial offer can be configured.
* If the value of OfferGroupAdditionalOptionTrialFlag is 0, the 'Trial' subscription kind will not be available in SolCon and a Trial offer cannot be configured.

To Configure Trial Subscription kind in SolCon, follow these steps:

1. Navigate to **Support Viewer** → **Management** → **App settings**
2. In **Filters** section under Search settings, select **Setting type**: Client Components Permission, **Key**: OfferGroupAdditionalOptionTrialFlag, **App type**: SolconAdmin
3. Click **Search**. Click on the OfferGroupAdditionalOptionTrialFlag key displayed in **Settings Keys Grid** to select it.
4. Select the **Client group** from the corresponding dropdown (Ex. Mg2 Group Stripe) in the Filters section at right. Select Client and Environment from the corresponding drop-downs.
5. The clients with Environments, key values, and other details are listed below.\
   **Note:** To update any key value, click the "Edit" button at the end of the selected client's row. Update the value to either 0 or 1. After making the change, add a comment in the Comment field of the same row describing the update. Finally, click "Update."
6. Click the **Update** button in the Update setting key section, just above the Filters section. \
   A pop up will open. Click **Show generated script**. Click **Execute**.
7. After the update, click **Clear Appcache** button to clear the cache. \
   **Note**: If the SolCon Offer Groups page is already open in your browser, be sure to refresh the page to reflect the recent SV changes.
