Skip to main content
POST
Purchase TV subscription
Renews TV subscription plans (DSTV, GOTV, StarTimes) for a verified smart card.

Environment Notes

  • Production key -> uses the live business NGN wallet balance and runs the live purchase flow.
  • Test key -> uses the sandbox business NGN wallet balance and completes without vending real TV services.

Authorizations

x-api-key
string
header
required

Merchant API Key (e.g., nexa-prod-... or nexa-test-...)

Headers

x-business-env
enum<string>
default:prod

Target environment selector (live production vs. simulated sandbox).

Available options:
prod,
test

Body

application/json
tv
string
required

Service provider code (e.g. dstv).

amount
number
required
smartCardNumber
string
required
subscription_type
enum<string>
required
Available options:
change,
renew
businessId
string

Response

202

Transaction initiated.