Skip to main content

Overview

Cable TV purchases are a two-step flow:
  1. Validate the smartcard number to confirm it exists and retrieve the customer name
  2. Buy the subscription using the validated details
Supported providers include DSTV, GOtv, Startimes, and others available in your catalog.

Authentication

Both endpoints require your merchant API key and the channel: API header.

Step 1 — Validate smartcard

Request body

Sample response

Always display customerName to the user for confirmation before proceeding to purchase. This prevents funding the wrong decoder.

Step 2 — Cable subscription

Request body


Full purchase flow

Do not proceed to purchase if the validation step fails. An invalid smartcard number will result in a failed transaction that may still debit your wallet.

Next steps