Skip to main content
support@a1topup.com
+91 91610 19161 +91 81259 43396
Login Free Demo
  1. Home
  2. Blog
  3. Recharge API
  4. DTH Recharge API: Operators, Customer Info and Common Errors

DTH Recharge API: Operators, Customer Info and Common Errors

2 min read By A1Topup Team Recharge API
DTH Recharge API: Operators, Customer Info and Common Errors

Key takeaways

  • DTH is a monthly repeat service, so accuracy matters more than speed
  • Confirm the customer name before paying
  • Treat pending as pending, never as failed

Mobile recharges bring a customer in once. DTH brings the same family back every month, often for years. That is why getting DTH right, every single time, is worth a little extra care in your integration.

Operators and codes

OperatorCodeSubscriber ID looks like
Tata PlayTTV10-digit subscriber ID
Airtel Digital TVATVCustomer ID or registered mobile
Dish TVDTVVC number (11 digits)
Videocon d2hVTVCustomer ID

Codes and parameters are in the API documentation; check them there before going live.

The safe flow

  1. Customer gives the subscriber ID.
  2. Fetch the customer info: name and current pack.
  3. Customer confirms, you send the recharge with a new order id.
  4. Show the final status and keep the operator reference for complaints.
Pro tip

Show the customer’s current pack and the amount it needs on the confirm screen. Most "recharge done but TV still off" complaints are short payments.

Errors you will see

  • Wrong ID format: a mobile number sent where the VC number is needed
  • Amount below the pack price, so the recharge succeeds but the channels stay off
  • Retrying a pending DTH recharge and paying twice

Conclusion

DTH rewards careful shops. Confirm the name, match the pack amount and let pending recharges finish. The A1Topup recharge API covers mobile and DTH on the same wallet.

Add DTH to your app

Mobile and DTH on one API and one wallet.

Recharge APIAPI documentation

For the product side of this, see our recharge API for your app.

Check any number with our free mobile & DTH plan finder →

Frequently asked questions

Which DTH operators does the A1Topup API support?
Tata Play, Airtel Digital TV, Dish TV and Videocon d2h.
Why fetch customer info before a DTH recharge?
It confirms the customer name and pack, so the recharge does not go to a wrong subscriber ID.
What should I do if a DTH recharge is pending?
Do not retry; wait for the callback or check the status API with the same order id.

Have a question? Talk to our team

We respect your privacy. Your details are only used to contact you about A1Topup.

Related articles

WhatsApp