Monetization User Guide
The Monetization solution consists of the Monetization Service and the Billing Service which are managed services. This user guide describes the UI workflows on how to configure the services and how to manage the data.
Overview
The Monetization Service is a managed service to create SVOD business models. It is the managing part of the Content Monetization solution. This service maintains the data about available subscription plans, payment plans, pricing, and claim sets. It provides a GUI to manage and publish this data to be consumed by other services.
The Billing Service is also a managed service which is responsible to handle subscriptions. It is the end-user focused part of the Content Monetization solution. It provides the payment provider integrations for subscribing and handling subscription renewals and other payment related notifications. It manages the data about the enabled payment providers and their settings.
This document describes the Monetization Service user interface, the administration UI, and will guide you through the creation of subscription plans and claim sets and the configuration of payment providers. For a detailed description of the underlying monetization data model including data validation and constraints see the Monetization Technical Specification.
Administration
The general settings and the payment provider related settings can be configured in the Mosaic Admin Portal.
You can access those settings from the Mosaic Admin Portal. The link for the EU region is https://admin.service.eu.axinom.com/. Select your environment and navigate to the Service Configuration section.
Enabling Payment Providers
Payment providers are enabled in the Payment Providers section. Each payment provider has specific settings for authorization and similar. Each payment provider can be enabled once.
You can add new payment providers by using the "new" button. Please refer to the specific payment provider integration guides for their settings.
Billing & Monetization Services Configuration
When end-users purchase a subscription in a redirect based purchase flow, they are at the end redirected to a web-page. If everything went fine, the end-user is redirected to the success URL. If he cancelled the payment flow he is redirected to the cancel URL. And if there was any error during the purchase flow, the user is redirected to the error URL. At least the success redirect URL hast to be configured and will act as a fallback if the others are not configured.
Monetization Workflows
The Monetization Service provides management and publishing workflows for all its entities. The workflows are available from the management system once the service is activated.
The monetization hub page is an entry point to monetization management stations.
Subscription Plans
The subscription plans explorer station lists all subscription plans.
A new subscription plan can be created by clicking the + NEW button and then entering a title.
Filters on the left can be used to filter the the displayed subscription plans. For example, click Title, type some text and press Enter to display only rows with a matching title. Each active filter will remain visible with a button to remove the filter. Dates and numerical properties can be filtered to a range between From and To values.
Each subscription plan is displayed as a row with various columns. Rows are sorted with the most recently modified row at the top. Click on row headers to sort by a different property. Click any row to open the details of the subscription plan where properties can be edited.
| Column | Description |
|---|---|
Publication state & cover image |
A colored bar on the left of the first column indicates the Publication State. The first columns also displays a thumbnail if a cover image has been assigned. |
Payment Plans |
The number of configured payment plans. This number includes payment plans which are not yet published. |
Status |
Active / Inactive. See Subscription plan editable properties. |
Created At |
The date and time of first creation. |
Last Modified At |
The date and time when the last change was made. |
Last Published At |
The date and time when last published. This will be blank if never published. |
After creating a new subscription plan, or opening a subscription plan from the explorer page, the subscription plan details station will be displayed.
Properties edited at the subscription plan details station will be saved on navigating away from the page but will have no effect until the subscription plan is published.
| Property | Description |
|---|---|
Title |
Display name for the subscription plan. This will be shown to potential subscribers. |
Description |
A description for the subscription plan. This should describe the benefits to a potential subscriber. |
Status |
New subscriptions cannot be created for a subscription plan which is not active. Existing subscriptions will continue to be billed. |
Payment Providers and Settings |
The list of payment providers that can be used to subscribe. The interface and validation for settings vary per supported payment provider. See payment provider specific documentation for details. |
-
Claim Sets Management - Assign / remove claim sets.
-
Payment Plans - Opens the payment plans explorer station to manage payment plans owned by this subscription plan.
-
Manage Cover Image - Assign a subscription plan cover image that was uploaded to Image Service.
-
Publishing - Validate and publish the subscription plan. See Publishing.
-
Delete - Delete the subscription plan including owned payment plans. Note that published subscription plans cannot be deleted.
Payment Plans
The payment plans explorer station lists the payment plans owned by a subscription plan.
A new payment plan can be created by clicking the + NEW button and then entering a title.
Each payment plan is displayed as a row with various columns. Filters and sorting are similar to the subscription plans explorer with the most recently modified row at the top by default. Click any row to open the details of the payment plan where properties can be edited.
| Column | Description |
|---|---|
Publication state |
A colored bar on the left of the first column indicates the Publication State. Payment plans are always published as part of their parent subscription plan but newly created or changed payment plans may have a different publication state. |
Recurrence period |
Recurring payment duration. See Payment plan editable properties. |
Payment providers |
The list of configured payment providers. |
Status |
Active / Inactive. See Payment plan editable properties. |
After creating a new payment plan, or opening a payment plan from the explorer page, the payment plan details station will be displayed.
Properties edited at the payment plan details station will be saved on navigating away from the page, but will have no effect until the parent subscription plan is published.
| Property | Description |
|---|---|
Title |
Display name for payment plan. This will be shown to potential subscribers. |
Description |
A description for the payment plan. This should describe payment terms and the benefits to a potential subscriber. |
Status |
New subscriptions cannot be created for a payment plan which is not active. Existing subscriptions will continue to be billed. If the parent subscription plan is not active then this property is ignored. |
Recurrence Period |
Required. Defines the recurring payment duration. NOTE: Some payment provider may only support a subset of the available options. |
Payment Providers and Settings |
The list of payment providers that can be used to subscribe. Only payment providers which are enabled on the parent subscription plan can be used. The interface and validation for settings vary per supported payment provider. See payment provider specific documentation for details. |
-
Price per Country - Manage price and currency per country.
-
Delete - Delete the payment plan. Note that published payment plans cannot be deleted.
Price per Country
The price per country station lists prices configured for a single payment plan.
A single price and currency can be configured for each country where this payment plan can be used. Subscribers will not be able to subscribe from a country that is not listed. At least one entry must be added per payment plan.
Prices will be saved on navigating away from the page, but will have no effect until the parent subscription plan is published.
Claim Sets
The claim sets explorer lists all claim sets.
A new claim set can be created by clicking the + NEW button and then entering a title.
Each claim set is displayed as a row with various columns. Filters and sorting are similar to the subscription plans explorer with the most recently modified row at the top by default. Click any row to open the details of the claim set where properties can be edited.
After creating a new claim set, or opening a claim set from the explorer page, the claim set details station will be displayed.