Cydene Bills API
  • Cydene Agents API Documentation
  • Authentication
    • API Authentication requirements
  • INTEGRATION FLOW
    • Requests
    • Response
  • AIRTIME
    • Airtime recharge providers
    • Purchase Airtime
  • DATA BUNDLES SERVICES
    • Bundle recharge providers
    • Bundle from a provider
    • Purchase Data Bundle
  • SMILE
    • Get Smile Bundle Options
    • Validate Smile Account
    • Purchase Smile Data Bundle
  • SPECTRANET
    • Get Spectranet Data Bundle Options
    • Purchase Spectranet Data Bundle
  • Power
    • Electricity Service Providers
    • Validate
    • Purchase Power
  • Cable Tv
    • Validate
    • Bouquets
    • Addons
    • Renewal
    • Update
  • Betting
    • Get Betting Providers
    • Validate Account
    • Fund Account
  • DSTV SHOWMAX
    • Get plans
    • Subscribe to a showtime plan
  • GAS
    • Create Order
    • Get Available Dispatchers
    • Complete Order
    • Cancel Order
    • Order Status
    • Get Order
  • Transactions
    • GetStatus
    • Get Balance
  • CONTACT US
    • Contact us
  • SMS
    • Send SMS
    • Get Delivery Status
Powered by GitBook
On this page
  1. Cable Tv

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.

  1. The name of the user ("name" property)

  2. The current subscription plan of the user ("currentBouquet" property )

  3. The due date of the current plan ("dueDate" property)

  4. 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

Name
Type
Description

x-api-key*

String

3434-4243-ffef-2323

Request Body

Name
Type
Description

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

{
  "isSuccessful": true,
  "message": "string",
  "code": "string",
  "data": {
    "amount": 0,
    "statusCode": "string",
    "transactionStatus": "string",
    "transactionMessage": "string",
    "transactionReference": "string",
    "isSuccessful": true
  }
}

PreviousAddonsNextUpdate

Last updated 9 months ago