Expire a subscriber offer

This PUT operation expires an offer for a subscriber. Expiring offers does not remove the attributes for the offer (such as suspension timers, etc.), meaning the offer is not immediately available again to the subscriber. You can only expire offers that were previously ACCEPTED. If successful, you receive an HTTP response code of 200 and a JSON response containing the offer that was cancelled by the subscriber with information such as the ID, the status, and the campaign of which it is a part.

See HTTP response codes for other response codes.

PUT /rte/marketplace/subscribers/<msisdn>/offers/<offerId>/expire + JSON request

content-type: application/JSON

accept: application/JSON

authorisation: HTTP Basic Auth

URL parameters

There are two mandatory parameters.

Parameter Type Description

msisdn

string

The subscriber’s MSISDN in international format.

offerId

string

The external offer ID used to identify a specific offer instance.


JSON request

The JSON request contains the clientId and the channel through which the offer was expired. You might also receive metadata if applicable.

See RTEM data type descriptions for more information. 
{
    "clientId" : "portal123",
    "channel" : "Web",
    "metadata" : "policyName=insure123&policyNum=1980AS098UO9",
    "notification": [
        {
            "message": "Your offer has expired."
        }
    ]
}


JSON response

The JSON response includes the offer information.

See RTEM data type descriptions for more information. 
{
    "offerId" : "2WeeksTravelTime",
    "status" : "EXPIRED",
    "campaignName" : "InsuranceForEveryone"
}

RTE Marketplace JSON data type descriptions

Field Type Description

offerId

string

The external offer ID used to identify a specific offer instance.

status

string

The current status of the offer.

possible values

  • ISSUED

  • ACKNOWLEDGED

  • ACCEPTED

  • REJECTED

  • CANCELLED

  • EXPIRED

offerExpiryDate

string

The offer expiry timestamp after which the offer is no longer valid. In other words, the offer must be accepted or rejected before this date and time. Format: DD/MM/YYYY HH:MM:SS.

This field is only present when the status is ISSUED or ACKNOWLEDGED.

offerSuspensionDate

string

Indicates that the offer will not be sent to the subscriber again until after this offerSuspensionDate. Format: DD/MM/YYYY HH:MM:SS.

This field is only present when the status is ACCEPTED or REJECTED.

campaignName

string

The name of the campaign of which the offer is apart.

clientId

string

An arbitrary string used to identify the client.

channel

string

Identifies the channel through which the offer was consumed such as Web, App, or SMS.

metadata

string

Optional data to include with the request.

This data is logged for audit and reporting purposes.

notifications

array

An optional array containing messages to the subscriber.

productExpiryDate

string

An optional expiry date for the offer expressed in DD-MM-YYYY format.

This is only relevant for the Accept an Offer request.

HTTP response codes

Code Description

200 OK

success!

400 Bad Request

wrong input parameter or URL

401 Unauthorized

user authentication failed; incorrect credentials

403 Forbidden

user authorisation failed; operation not permitted for user

404 Not Found

The resource was not found.

  • subscriber = <msisdn>

  • offer = <offerId>

409 Conflict

Invalid operation due to current offer state.

500 Internal Server Error

A server side error occurred while processing the request.