Prerequisites

Before starting any actual development work, it may be worthwhile to take some time to envision the end-user journey and offer scope. This will make the project kick-off smoother and help to proceed faster. Below you can see a few examples:

Scenario 1 - The activation journey starts from a public activation URL, which can be distributed over the web, email or via SMS.

In this scenario, the users will be redirected to Fortumo. Fortumo will handle user authentication via an OTP (one-time password), HE (header enrichment) or Mobile Connect OAuth, and entitlement checks based on a list of predefined business rules. After completing the activation, the users will land on service provider’s website.

Partner needs to integrate callbacks (for activation and termination) and also Cancellation API.

Scenario 2 - The activation journey starts from a secure environment, e.g. telco's self-service portal.

In this scenario, after activating the service on telco's portal, the user is redirected to Fortumo using signed JWT token. Fortumo will handle user entitlement checks based on a list of predefined business rules. The user is then redirected to service provider page for completing the activation.

Partner needs to integrate signed user redirect (from self-service to the offer page) passing Fortumo a unique user ID, callbacks (for activation and termination) and also Cancellation API.

Scenario 3 - The activation journey starts from a set-top box.

In this scenario, the user is able to activate the service directly on the set-top box.

Partner needs to integrate Bundle Activation API, callbacks (for activation and termination) and also Cancellation API.

Merchant ID

In order to get access to Fortumo’s Bundling Platform, you will need a Merchant ID, this will be provided by your Project Manager.

SSH keys

Before you can start you will need to share a public key with your Project Manager. Refer to Preparing SSH keys guide on how to generate the public and private key pair (only applicable in case of signed redirect).

Offer Configuration

In order to proceed with integration and testing, an offer needs to be configured on Fortumo platform. This will be managed fully by your Project Manager, as a result, you will receive an offer_code parameter value to be used when calling Fortumo's APIs.

1
2
3
{
    "offer_code": "telekom_vod_trial30"
}
Help us improve our Merchants Portal. Was this article helpful?