> For the complete documentation index, see [llms.txt](https://docs.navigaglobal.com/naviga-subscribe/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.navigaglobal.com/naviga-subscribe/subscribe-features/new-starts-and-restarts/new-starts-in-ncs-circ.md).
# New starts
## Goal
The goal of this tutorial is to show you how to configure some of the Subscription Purchases in the Solicitor Concierge and Content Management System (CMS) dashboards. This guide explores the four following types:
* [digital ZIP-only Subscription Purchase](#digital-zip-only-subscription-purchase)
* [start-and-bill Subscription Purchase](#start-and-bill-subscription-purchase)
* [campaign code Subscription Purchase](#campaign-code-subscription-purchase)
* [frictionless Subscription Purchase](#frictionless-checkout-for-payway-ncs-circ-clients)
Navigate to your desired Subscription Purchase type to learn more. You can also view the workflows for a visual representation for [NCS Circ](https://docs.navigaglobal.com/subscribe/workflows/ncs-diagrams/subscription-purchase-workflows) or [Matrix](https://docs.navigaglobal.com/subscribe/workflows/matrix-diagrams/new-start-matrix).
{% hint style="warning" %}
Please note that the [complimentary subscription guide](/naviga-subscribe/subscribe-features/new-starts-and-restarts/new-starts-in-ncs-circ/complimentary-free-of-charge-subscriptions.md) and[ 'Day Pass' subscription guide ](/naviga-subscribe/subscribe-features/new-starts-and-restarts/new-starts-in-ncs-circ/day-pass-subscriptions-ncs-circ.md)were moved to separate page
{% endhint %}
## Before you start
Make sure you meet the pre-requisites before starting the tutorial steps and reach out to a Naviga Implementation Manager to ensure Solicitor Concierge and CMS components are configured and structured properly.
For general offer group setup please see the proper [section of the Solicitor Concierge User Guide](/naviga-subscribe/csr-user-guide/solicitor-concierge-guide/solcon-tutorials/configure-an-offer-group.md)
## Digital ZIP-only Subscription Purchase
A Digital ZIP-only Subscription Purchase requires a subscriber to enter only a postal code (and not a complete address) while making a purchase.
### Goal
The goal of this section is to explain how to configure a Digital ZIP-only Subscription Purchase in Naviga's Solicitor Concierge and CMS dashboards.
### Pre-requisites
For this feature to be implemented the following pre-requisites must be met:
* For NCS: the minimum Subscribe version is 3.13 and minimum circ version is 2018.5
* For CircPro: the minimum Subscribe version is 3.15 and minimum circ version is 2021-3
* Matrix currently does not support this flow. However, it can be developed.
### Solicitor Concierge setup
From the Solicitor Concierge dashboard:
1. Select **offer groups** from the left sidebar. Your offer groups will appear in a list to the right.
2. Select an offer group from the list, or create a new offer group.
3. Select the **additional options** category, then select the **address requirements** drop-down menu.
4. Uncheck the *run product delivery check*, *billing address*, and *delivery address* boxes.
5. Select **update** or **save as new**.
### CMS setup
From the CMS dashboard:
1. Select **subscription panel** then **presentations**. Be sure to apply these changes to the newspaper level.
2. Choose your desired presentation from the drop-down menu.
3. Add the **Independent Address V3** as a child component to the **Step V3** component. To collect other information we recommend using the **User Information V3** component
4. Select **save** and clear your app's cache by selecting the manage cache button, then the relevant app.
{% hint style="danger" %}
For a successful start in circ system the following information is required: **First Name**, **Last Name**, **Email** and **Zipcode**
{% endhint %}
{% hint style="info" %}
Please note that **Independent Address V3** component supports taxing only from Subscribe 3.14.3
{% endhint %}
{% hint style="warning" %}
Please note that the **tax amount** (and hence the **total price**) is dependent on the zip code. For the best user experience, we recommend collecting zip code **before** the Payment Step. Otherwise, the tax amount and the total price shall be recalculated.
{% endhint %}
### Outcome
Congratulations! You've added a Digital ZIP-only Subscription Purchase in the Solicitor Concierge and CMS dashboards.
## Start-and-bill Subscription Purchase
A start-and-bill Subscription Purchase allows the subscriber to begin a subscription and pay for it later via invoice. The subscriber is not required to provide payment information.
### Goal
The goal of this section is to explain how to configure a start-and-bill Subscription Purchase in Naviga's Solicitor Concierge and CMS dashboards.
### Pre-requisites
For this feature to be implemented the following pre-requisites must be met:
* For NCS Circ: the minimum Subscribe version is 3.13 and the minimum NCS circ version is 2018.5
* For Matrix: the minimum Subscribe version is 3.15.1 and the minimum Matrix version is 38.00.034 P5
### Solicitor Concierge setup
From the Solicitor Concierge dashboard:
1. Select **offer groups** from the left sidebar. Your offer groups will appear in a list to the right.
2. Select an offer group from the list, or create a new offer group.
3. Select the **additional options** category, then select the **payment method** drop-down menu.
4. Check the *billed* box.
5. Select **update** or **save as new**.
### CMS setup
From the CMS dashboard:
1. Select **subscription panel** then **presentations**. Be sure to apply these changes to the newspaper level.
2. Choose your desired presentation from the drop-down menu.
3. Add the **Bill Me V3** as a child component to the **Payment Method V3** component.
4. Select **save** and clear your app's cache by selecting the manage cache button, then the relevant app.
{% hint style="info" %}
Please note that you can have other payment methods as children of the **Payment Method V3** component - only those payment methods checked in Solicitor Concierge will be displayed
{% endhint %}
### Outcome
Congratulations! You've added a start-and-bill Subscription Purchase in the Solicitor Concierge and CMS dashboards.
## Campaign-code Subscription Purchase
A campaign-code Subscription Purchase minimizes the amount of data you need to enter. Instead of entering circulation-specific data (rate code, term, length, etc.), a single campaign code is sufficient.
### Goal
The goal of this section is to explain how to configure a campaign-code Subscription Purchase in Naviga's Solicitor Concierge and CMS dashboard.
### Pre-requisites
For this feature to be implemented the following pre-requisites must be met:
* Minimum Subscribe version is 3.14.0 and minimum NCS circ version is 2014.5
### Solicitor Concierge setup
From the Solicitor Concierge dashboard:
1. Select **offer groups** from the left sidebar. Your offer groups will appear in a list to the right.
2. Select an offer group from the list, or create a new offer group.
3. Select the **coding** category, then select the **custom codes** drop-down menu.
4. Select the NCS campaign code value from the **Campaign Code 1** field. After you have selected the campaign code then the rate code, reason code, term length and billing method will be automatically prepopulated with valid values that were setup in NCS circ.
5. Select **update** or **save as new**.
### CMS setup
Configure a campaign-code Subscription Purchase just as you would do for a regular Subscription Purchase, no additional setup is needed
### Outcome
Congratulations! You've added a campaign-code Subscription Purchase in the Solicitor Concierge and CMS dashboards.
See also: [Configure activation fees for Subscription Purchases](/naviga-subscribe/csr-user-guide/solicitor-concierge-guide/solcon-tutorials/configure-an-activation-fee.md)
## Frictionless (seamless) checkout
### Goal
The goal of this section is to explain how to configure a frictionless checkout for Subscription Purchase in Naviga's Solicitor Concierge and CMS dashboard.
### Details
This checkout has several main advantages:
1. Make it easier for users to start a subscription online. Reduce the time it takes to start a subscription as well as the number of error states
2. PayWay hosted page can be customized (Set labels and placeholders' text, show\hide fields, added fields for zip code and phone number, display T\&C of selected offer)
3. Consume billing information from the external sources (PayWay form, GooglePay, ApplePay) and pass it into POST /Subscriptions even if the billing address component doesn’t exist in presentation
### Pre-requisites
* The minimum Subscribe version required is 3.14
* Client should be using Payway payment provider
* For ZIP-only starts minimum NCS circ version is 2018.5 and the minimum CircPro version is 2021-3
### Solicitor Concierge setup
For ZIP-only starts please see [this guide](https://docs.navigaglobal.com/subscribe/subscribe-features/new-starts-and-restarts/new-starts-in-ncs-circ#solicitor-concierge-setup). For regular starts, no additional setup is needed
### CMS setup
To configure a frictionless checkout low you need to set `Seamless` as the Presentation Theme:
1. From the CMS, select the **Hierarchy** button and choose a level (`Client`, `Newspaper Group`, or `Newspaper`).
2. Select **Subscription Panel**, then choose **Presentations**.
3. From the drop-down menu, select the Presentation you wish to edit. The Presentation's structure and components appear below.
4. Navigate to the `Presentation Properties` component and select the **Details** button. The component's properties expand below. Ensure the following property is configured: `Theme` - choose either `Seamless`
5. Select **Save**.
{% hint style="warning" %}
Starting from 3.15.3 the following changes were made:
* `OfferTopContainer.Styling.BackgroundColor`property was replaced by `OfferTopContainer.Styling.BackgroundColor.Left` and `OfferTopContainer.Styling.BackgroundColor.Right` for the **Sticky Note** to be able to support gradient. If set only one colour then the header will have solid colour
* subscription price, tax amount and total price can be shown at the Checkout step at the same time - please use the toggles in **Sticky Note** component: `Pricing Amount Show`, `Pricing TaxAmount Show`, `Pricing TotalPrice Show`
{% endhint %}
No action is required from the business user to support the new version of the Payway iFrame - all the fields in the **CreditCardEdgil** component should be automatically populated via a script being a part of the CMS database setup.
Also, below you can find examples of the structure templates to configure the presentations that match the designs
{% tabs %}
{% tab title="No landing zip only " %}
#### Structure template for No landing with address
* Presentation Properties V3
* Header V3
* Page V3
* Offer Selector - Tiles V3
* Page V3
* Sticky Note V3
* Step V3
* User Information V3
* Information V3 (to specify T\&C)
* Page V3
* Sticky Note V3
* Step V3
* Payment Methods V3
* Credit Card Edgil V3 (turn on zipcode)
* Page V3
* Confirmation V3
* Footer V3
{% endtab %}
{% tab title="No landing with address " %}
#### Structure template for No landing with address
* Presentation Properties V3
* Header V3
* Page V3
* Offer Selector - Tiles V3
* Page V3
* Sticky Note V3
* Step V3
* User Information V3
* Information V3 (to specify T\&C)
* Step V3
* Delivery Information V3
* Billing Information V3
* Page V3
* Sticky Note V3
* Step V3
* Payment Methods V3
* Credit Card Edgil V3 (turn on zipcode)
* Page V3
* Confirmation V3
* Footer V3
{% endtab %}
{% endtabs %}
The following points are *optional* to match the design at the screens:
{% tabs %}
{% tab title="New properties" %}
* `isOnlinePaymentSystemsButtonsBelow` property of the **PaymentMethods** component should be set to **ON** - this flag excludes additional payments like Google Pay, Apple Pay, PayPal from the list of available options and places them below Submit/Purchase button divided by the delimeter text. Otherwise, the additional payment methods would have been shown in the dropdown under the title of the Step. Please see the *Payment Step - regular start s*creenshot above as an example
* `enumer show` toggle of the **Step** component - displays/hides the Step number
* `offerTopContainer.enableCustomization` toggle of the **StickyNote** component should be enabled - this allows you to manage the sticky note background component using the`offerTopContainer.Styling.BackgroundColor`properties
{% endtab %}
{% tab title="Existing properties" %}
* `IsMoveLabel` toggle of the **PresentationProperties** component should be set to `ON` - the title will slide above the input field when the user hovers over the field
* `Button.HideWhileDisabled` toggle of the **Step** component with Payway iFrame should be set to `ON` - this flag supports one click instead of two clicks, e.g.
* After the payment step - the user will only click on one submit button and see the confirmation page
* After login (3rd party) - the user will only click 'submit' once.
***NOTE:*** There should only be one component in such step to leverage these features
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.navigaglobal.com/naviga-subscribe/subscribe-features/new-starts-and-restarts/new-starts-in-ncs-circ.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.