Updating a Bundle

This method can be used for applying updates for an already active bundle in order to move the user to a different package e.g. from free trial to paid, if required by the Partner.

Every request should be secured using JWT authentication token provided in an Authorization: Bearer header containing JWT token using the payload as per the example.

The body_sha256 claim in the JWT header must be equal to the sha256 checksum of the request body.

Please refer to the Security page for additional information about JWT.

Returns either 200 OK or error in case of refused operation. Update result will be sent via an asynchronous callback to a previously configured backend URL.

Request URL: https://bundle-api.fortumo.io/bundle/update

Request body

Request body is JSON with the following fields:

Attribute Type Description Required
merchant_id String Value must equal to Merchant ID as provided by Fortumo. Mandatory
bundle_id String Unique activated bundle id. Mandatory
product String An identifier to indicate whether the consumer is on a free, promotional price or full price tier. Should be set to the new tier value Mandatory
operation_reference String A unique operation id. Optional
callback_url String Specifies the backend URL where Fortumo will send a callback after a successful bundle update flow. Overrides default offer configuration. Optional
1
2
3
4
5
6
7
8
9
10
{
    "iss": "d3ad608d0a1729727a3eb6bc0892b426",
    "exp": 1525437711,
    "iat": 1522845411,
    "nbf": 1522845211,
    "sub": "bundle",
    "aud": "Fortumo",
    "jti": "jwt-id",
    "body_sha256": "0321385d3f67571815efebbb377a6fe9d2b4e205a87f3d5867de60b152560322"
}
1
2
3
4
5
6
7
8
9
10
11
12
POST /bundle/update  HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiI2N...OL4LxCc4FA-OtAb_UD9M5M
Content-Type: application/json
JWT-Request: true

{
    "merchant_id": "6ae23a346c39ab2963a1245db4903631",
    "bundle_id": "4de65cf6-e1ea-438a-8ac2-49727e700cd4",
    "product": "vod_full_price",
    "operation_reference": "bundling-aed470f7-c9e7-4692-be89-d164b67bb5e6",
    "callback_url": "https://example.com/bundles/callbacks"
}
Help us improve our Merchants Portal. Was this article helpful?