Updating a Bundle

This method can be used for applying updates for an already active bundle, for example due to a MSISDN change or 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 following payload and also include a JWT-Request: true header for indicating the type of request.

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 partner 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
POST /bundle/update  HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiI2N...OL4LxCc4FA-OtAb_UD9M5M
Content-Type: application/json

{
    "merchant_id": "6ae23a346c39ab2963a1245db4903631",
    "bundle_id": "8ebd3885-7129-4e23-99c7-58e9741d3941:d3304123",
    "product": "vod_full_price",
    "operation_reference": "ab095dc03ab4afb0482fa2532433e50c",
    "callback_url": "https://example.com/bundles/callbacks"
}
Help us improve our Merchants Portal. Was this article helpful?