Renewal
This is the renewal or free entry amount for dstv, gotv and startimes
This is the advisable and the most preferred option by multichoice for customers who are already enjoying a plan and want to only carry out a monthly renewal plan.
It is very important that this option is first presented to the user except in the case where the user wants to carry out a change of his/her current subscription plan.
This endpoint is used for: 1. Subscription Renewal 2. Free Entry Purchase 3. Box Office Purchase
USER EXPERIENCE / VIEW It is required that a name validation must be carried out as described on the previous page. The below items are expected to be displayed for a user in the case of a renewal which is retrieved during the user details validation to aid the user experience.
The name of the user ("name" property)
The current subscription plan of the user ("currentBouquet" property )
The due date of the current plan ("dueDate" property)
The expected renewal amount to pay ("outstandingBalance" property)
Cable Tv subscription renewal
POST
{{ BASE_URL }}/api/biller/tv/subscription/renew
This is the endpoint to call for a subscription renewal on either a DSTV, Gotv and any other available provider.
Headers
x-api-key*
String
3434-4243-ffef-2323
Request Body
serviceType*
string
e.g gotv, dstv, etc
amount*
number
This is the amount you want to renew.
variationCode*
string
The code of the variation of the bouquet
agentReference*
string
This is a unique key generated by the integrator (you) to identify the transaction. This has to be unique per transaction.
cardNumber*
string
The smart card number you wish to make the subscription payment on
phone*
String
The phone number of the customer or recipient of this service
Last updated