Change Cable Subscription

❗️
This option should be used only if the customer wishes to change the current product or add-ons to which he or she is currently subscribed.
Product codes of new products or add-ons MUST BE included in the request unlike the renewal where the product code is passed as 0.

Request

{{baseUrl}}/cable/change/subscription

Headers

Parameters	Type	Description	Mandatory
Authorization	String	public secret key e.g dc_test_1T1eSavlZxy02OT3OWlvbxK4G	Required

Body Parameters

Parameters	Type	Description	Mandatory
account_number	String	A valid account number	Required
service_type	String	This can be either ''DStv',''GOtv''or ''StarTimes''	Required
total_amount	String	This is the total amount for the package and addons selected	Required
number_of_months	String	This is the duration until subscription expires	Required
product_code	String	The identification code of the selected package	Required
smartcard_number	String	This is the smartcard number on which subscription will be recharged	Required
addon_code	String	This is the identification code of the selected addon	Optional
addon_number_of_months	String	This is the number of months the addons will last until it expires	Optional

Response Sample

{
    "status": "success",
    "message": "Successful",
    "code": 200,
    "data": {
        "statusCode": "0",
        "transactionStatus": "success",
        "transactionReference": 35974386,
        "transactionMessage": "Cable TV Subcription successful",
        "baxiReference": 1518227,
        "provider_message": "true",
        "rawOutput": {
            "transactionNumber": 1518227,
            "details": {
                "customerCareReferenceId": null,
                "exchangeReference": "2070228633",
                "errorMessage": null,
                "errorCode": null,
                "errorId": null,
                "auditReferenceNumber": "36014082430737482834",
                "done": true,
                "status": "ACCEPTED"
            }
        }
    }
}