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 - a public offer for a music streaming service, with offer activation URLs distributed over the web and SMS.

In this scenario, the users will log in to the service and are redirected to Fortumo. Fortumo will handle user authentication 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 - a private offer of a gaming service, which is activated via telco's self-service portal

In this scenario, after activating the service on telco's portal, the user is taken 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 - a private offer of a video streaming service, which is activated via 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.

Partner ID

In order to get access to Fortumo’s Bundling Platform, you will need a Partner 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?