Teledeus
Bill Payment API / Cable TV / GOtv

GOtv subscription payment API

Renew every GOtv bouquet instantly, with the customer’s name confirmed before you charge. The customer’s name is confirmed from their IUC number before you charge.

Provider
GOtv
Customer number
IUC number
Services
Subscription renewal, Bouquet change, IUC name check
Prices
Live bouquet list from the API, never out of date

How GOtv payments work

  1. Validate

    Send the IUC number and get the customer’s name back.

  2. Choose

    Pick a bouquet from the live list, or renew the current one.

  3. 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
  • IUC 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":"gotv","smartcard":"[CARD NO.]",
       "bouquet":"[BOUQUET CODE]","ref":"order-20932"}'

GOtv payment questions

How quickly is a GOtv subscription renewed?

Usually within seconds. The confirmation comes back in the API response and by webhook.

Can customers change their GOtv bouquet?

Yes. Fetch the current bouquet list from the API and send the one the customer chooses.

What happens if a GOtv payment fails?

The amount is reversed to your wallet automatically and you receive the final status by webhook.

Add GOtv payments to your product.