TeledeusDStv subscription payment API
Renew DStv subscriptions, change bouquets and add extra views from your app, website or POS. The customer’s name is confirmed from their smartcard (IUC) number before you charge.
- Provider
- DStv
- Customer number
- smartcard (IUC) number
- Services
- Subscription renewal, Bouquet change, Add-ons, Smartcard name check
- Prices
- Live bouquet list from the API, never out of date
How DStv payments work
Validate
Send the smartcard (IUC) number and get the customer’s name back.
Choose
Pick a bouquet from the live list, or renew the current one.
Pay and renew
Your wallet is debited and the confirmation comes back in the response and by webhook.
What you can do
- Subscription renewal
- Bouquet change
- Add-ons
- Smartcard name check
Failed payments are reversed to your wallet automatically, and every transaction reaches you by webhook.
# Example request (see the docs for exact fields)
curl -X POST https://[api.teledeus.com]/v1/cable \
-H "Authorization: Bearer $TELEDEUS_KEY" \
-d '{"provider":"dstv","smartcard":"[CARD NO.]",
"bouquet":"[BOUQUET CODE]","ref":"order-20932"}'DStv payment questions
How quickly is a DStv subscription renewed?
Usually within seconds. The confirmation comes back in the API response and by webhook.
Can customers change their DStv bouquet?
Yes. Fetch the current bouquet list from the API and send the one the customer chooses.
What happens if a DStv payment fails?
The amount is reversed to your wallet automatically and you receive the final status by webhook.