CSP Integration: Overview
Contents
Overview
In the MarketONE managed subscription model, a customer purchases over-the-top (OTT) services through the communications service provider (CSP). That purchase is sent to and processed by MarketONE, and the user's service entitlements are then provisioned to the OTT service.
User Journey
A customer purchases an OTT digital service from the CSP digital storefront (e.g., Disney+ streaming service) and selects to add the service cost to their direct carrier bill. MarketONE then receives the subscription from the CSP, processes the service charge, and maintains the user's account and subscription entitlement information. After a successfully processing the purchase, the platform then provisions the the user's subscription and service entitlements to the OTT provider, and sends along a unique registration code or QR code that is also sent along to the user. The user then completes their journey at the OTT service application, and signs into the OTT application with their unique code.
Note: MarketONE requires an integration to the CSP's Business Support System (BSS) and identity provider in order to keep the user's account and subscription entitlements up to date.
How the Integration Works
This onboarding and monetization flow requires that the CSP-driven subscriptions integrate with MarketONE. The following images provide a generic example of this integration in action.
1. Provisioning a Subscription to MarketONE
The CSP provisions the subscription into MarketONE using the GET or POST Subscriptions APIs. In this step, an associated account can be created beforehand, or on the fly.
2. Notifying the OTT Provider of the Subscription
MarketONE then leverages an AddSubscription callback URL to notify the OTT to provision the user. The user is then sent a registration link with a redemption code.
3. Updating the Subscription Status in MarketONE
Once the user has logged into the OTT service, the redemption code is consumed. The change in the subscription status is then sent to MarketONE through the PUT /v2/partnerSubscription/{id} API call.
4. Notifying the CSP
MarketONE then notifies the CSP that the user is now active on the service through the POST /v2/notification API call. In turn, the CSP should notify the user that charges for the service are now being applied.
Revision History
Version | Description |
---|---|
2020.02 | Added this topic. |