BB Cable Renewal

This section gives a description of the renewal for DStv, GOtv, and StarTimes.

This is the most preferred option by multichoice for customers who are already enjoying a plan and want to only carry out a monthly renewal plan.

Except in the event that the user wishes to modify his or her current subscription plan, it is crucial that this option is first offered to the user.

Request

HTTP[POST]

{{baseUrl}}/cable/renewal

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 the user wants to pay	Required
number_of_months	String	The duration until subscription expires	Required
product_code	String	The identification code of the selected package	Required
isBoxoffice	boolean	This is an optional property that should only be added if the account is only a box Office account	Optional

Response Sample

Response

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