Billing integration with TVMS
Last updated
Last updated
This diagram describes the customer journey when taking a subscription of the operators service.
Consumer visits website of Operator.
Consumer Selects one of the products.
Pays for the Product and now has a subscription
Consumer and transaction is registered in Billing system
Billing system register the new customer in the TV Management System (TVMS)
Consumer gets a mail or text message from billing system with information about the Subscription and login details to access the Operators Service
Customer goes to App store and download the Operators App
With user name and password he logins
App connects with TVMS to check if it is valid subscription and which product this customer used. TVMS approves login and customer can watch TV.
The following steps must be implemented to create new subscriber.
Access of Billing system to the TVMS
Synchronize Products
Fill Web shop with Products
Handle transaction & payment
Ingest new subscriber in TVMS
Inform customer about subscription and how to access Operators Service
Managing existing subscriber
Renewal of the subscription
Change Product
Add extra Package
Cancellation of the Subscription
The TVMS offers Operators the facility to work with several deployments. As a result you can have several CRMs in the System and still work with one App in the App stores.
For example. Operator facilitates other operators that act as reseller. A service provider facilitates server companies with their TV service.
To connect subscribers to the correct Operator (= CRM) subscribers enter a service ID when they login before they enter Username and Password.
If Operator has only his own service, they don’t use this option.
The correct APIs can be found in the API Connector of the TVMS of the Operator. If a field value is not used, please put 0
Endpoint - https://{IMS_URL}/api/AddCustomer/addCustomerAsync_v2
Each CRM is linked to a CMS. The system can have more CMSs and CRMs. Each CRM has its own token. Name CMS: can be seen in TVMS Name CRM: can be seen in TVMS API Key: can be found in the CRM, Settings, Company info. Reseller ID (default = 0 in case of no resellers) Remark: Save all info in own database
Goal: synchronize Product in TVMS and Billing System Be aware the every CRM had it owns Products with unique ID.
Name CMS: can be seen in TVMS Name CRM: can be seen in TVMS You get all Product information. E.g. product name, length of subscription, subscription start date Depending on how you want to use it in your billing system, the data can be used. Remark: Save all info in own database
Use the Products in your Web shop
Handle this transaction in your web shop Customer selects product and pays for it
Use Add customer API
It includes CMS name, CRM name, Product ID, Length, Send registration email (False) If billing system want to set username and PW It should included in the Add customer request Send registration email (False), because billing system sends mail Response from TVMS: Service ID, Username Password Remark: Save all info in own database
Customer gets an email or text message with information about the Subscription and login details.
Customer automatically expire at the set date (as defined in Add customer API) With Renew Customer API subscription end date can be extended If nothing is done, automatically expires and customer cannot login anymore
API: Change subscription API
This is only needed when an Operator sells product with option for subscriber to buy extra packages.
Subscription end date is set to today Use the Change subscription API
