My DishTV 数据 API:套餐、余额与充值
My DishTV 是 Dish TV India Limited 推出的订户自助应用。这家印度直播卫星电视(DTH)运营商旗下拥有 DishTV 与 d2h 两大品牌,与 Tata Play、Airtel Digital TV 等同行竞争,服务全印度的预付费电视家庭。用户以注册手机号加短信一次性密码登录(与 DishTV 官网 My Account 使用同一套凭据),再在该号码名下的 DishTV、d2h 与 Smart+ 机顶盒之间切换。首页显示钱包余额、每月充值金额和停机日期;“即时充值”可为自己、为朋友或以稍后支付方式充值,经 Juspay 收银台结账,并支持 Amazon Pay 与 PhonePe。“管理我的套餐”逐个频道列出当前套餐,可按类型和语言浏览推荐套餐、Dish TV 组合包、超值套餐与单点频道,再增删频道和附加包。账户对账单、全部交易与“我的发票”集中保存充值记录和可下载的含税发票;频道指南提供节目单、简介、收藏与提醒;首页横幅推送限时充值优惠,包括与 Dish TV 旗下 Watcho 流媒体服务联动的活动;“问题追踪”可登记无信号、充值未到账和机顶盒故障,并给出分步排障指引。
视讯卡连接是所有记录的挂靠单位:每个 vcNumber 与其 stbId 机顶盒及 brand(DishTV、d2h 或 Smart+)配对,并归入注册手机号下的 subscriberId 与 subscriberName。每条连接都带有实时的印度卢比钱包状况——balanceAmount、monthlyRechargeAmount、switchOffDate、lastPaymentDate 与 lastPaymentAmount——以及 accountStatus 和含 packId、packType、endDate 的 currentPack。
频道阵容逐行记录:已订套餐给出 monthlyPrice、hdEnabled 与 channelCount,每个频道行带有 channelId、channelName、genre、language、quality、lcn 及 isAlaCarte 标记,付费 addOns 单独列出。套餐目录补充带价格的 recommended 推荐套餐、combos 组合包与 alaCarte 单点频道,套餐变更则返回 newMonthlyPrice、priceDelta 与 effectiveFrom。
资金流经三类相互关联的记录:充值订单(amount、offerId、discountAmount、payableAmount、payLater、rechargeForFriend、juspayOrderId 以及预计的 switchOffDateAfter)、账户对账单流水(txnId、txnDate、txnType、mode、status、narration)和发票(invoiceNumber、periodFrom、periodTo、GST taxAmount、totalAmount、pdfUrl)。优惠记录另含 discountType、discountValue、minRechargeAmount、validTill 与 applicablePackIds。
节目指南按 lcn 给出 programmeId、title、startTime、endTime 与 synopsis,并附每位观众的 isFavorite 与 reminderSet 标记;服务工单为每次机顶盒故障记录 category、errorCode、ticketId、ticketStatus、etaHours 与 troubleshootSteps。
家庭账单机器人按连接盯守 balanceAmount 与 switchOffDate,在机顶盒停机前以 monthlyRechargeAmount 作为建议充值额发出提醒;内容版权看板把一张视讯卡实际携带的频道与附加包同目录中的套餐和单点频道逐行比对;夜间财务任务将 txnId、mode、payableAmount 与 GST taxAmount 落入印度卢比记账本,并与 Juspay 订单对应;伴随客户端则把已订频道的 EPG 节目行转成与频道指南一致的观看提醒。openData Studio 把这些 DishTV 连接、频道阵容、账本与节目指南记录变为可供上述集成直接调用的开放数据。
应用截图
API 端点一览
请求/响应示例为依据应用界面重构的示意示例,并非实时抓包。
向注册手机号发送登录 OTP
POST
/api/SubApp/auth/otposint启动 My DishTV 登录:向订户的注册手机号(RMN)发送 6 位短信 OTP,并返回确认时所需的 otpTxnId。
认证方式: 无需认证。请求体为注册手机号(RMN),由原生加密插件对载荷做 JWT 签名。成功后返回的 otpTxnId 是验证步骤的必填项。
- rmn
- channel
- appVersion
- platform
- status
- message
- otpTxnId
- otpLength
- resendAfterSeconds
- maskedRmn
POST /api/SubApp/auth/otp HTTP/1.1 Content-Type: application/json X-App-Version: 10.1.9 { "rmn": "9876543210", "channel": "SMS", "appVersion": "10.1.9", "platform": "android" }{ "status": "SUCCESS", "message": "OTP sent", "otpTxnId": "otp-7c11e2", "otpLength": 6, "resendAfterSeconds": 30, "maskedRmn": "98XXXX3210" }校验 OTP 并签发订户会话
POST
/api/SubApp/auth/verifyosint确认短信 OTP,返回 Bearer 会话以及该 RMN 名下关联的观看卡连接列表(DishTV / d2h / Smart+ 机顶盒)。
认证方式: 无需认证。请求体携带 /api/SubApp/auth/otp 返回的 otpTxnId 和短信验证码。返回的 accessToken 在后续 SubApp 调用中以 Authorization: Bearer 发送。
- otpTxnId
- otp
- rmn
- status
- accessToken
- refreshToken
- subscriberId
- subscriberName
- connections
- vcNumber
- stbId
- brand
- tokenType
POST /api/SubApp/auth/verify HTTP/1.1 Content-Type: application/json X-App-Version: 10.1.9 { "otpTxnId": "otp-7c11e2", "otp": "482913", "rmn": "9876543210" }{ "status": "SUCCESS", "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session", "refreshToken": "rt-dishtv-9f2a", "subscriberId": "SUB-18482911", "rmn": "9876543210", "subscriberName": "Rahul Sharma", "connections": [ { "vcNumber": "012345678901", "stbId": "STB88421", "brand": "DISHTV", "status": "ACTIVE" } ], "tokenType": "Bearer" }获取账户概要(余额、套餐、停机日期)
GET
/api/SubApp/account/summaryopenbanking加载首页看板:观看卡身份、INR 钱包余额、月充值金额、停机日期以及当前订阅的频道包。
认证方式: Authorization: Bearer,accessToken 来自 /api/SubApp/auth/verify。RMN 名下有多台机顶盒时,查询参数 vcNumber 选择当前连接。
- vcNumber
- stbId
- subscriberName
- accountStatus
- balanceAmount
- currency
- monthlyRechargeAmount
- switchOffDate
- lastPaymentDate
- lastPaymentAmount
- currentPack
- packId
- packName
- packType
- endDate
GET /api/SubApp/account/summary?vcNumber=012345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOi... X-App-Version: 10.1.9{ "status": "SUCCESS", "vcNumber": "012345678901", "stbId": "STB88421", "subscriberName": "Rahul Sharma", "accountStatus": "ACTIVE", "balanceAmount": 186.50, "currency": "INR", "monthlyRechargeAmount": 399.00, "switchOffDate": "2026-10-12", "lastPaymentDate": "2026-09-12", "lastPaymentAmount": 399.00, "currentPack": { "packId": "PK-SUPER-FAMILY-HINDI", "packName": "Super Family Hindi", "packType": "BOUQUET", "endDate": "2026-10-12" } }列出当前套餐与已订频道
GET
/api/SubApp/packs/currentopendata返回 Manage My Pack 页展示的已订频道包、逐频道的 LCN / 类型 / 语言 / 画质行以及付费附加包。
认证方式: Authorization: Bearer accessToken。查询参数 vcNumber 选择机顶盒。
- vcNumber
- packId
- packName
- packType
- monthlyPrice
- hdEnabled
- channelCount
- channels
- channelId
- channelName
- genre
- language
- quality
- lcn
- isAlaCarte
- addOns
- addOnId
- addOnName
GET /api/SubApp/packs/current?vcNumber=012345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "vcNumber": "012345678901", "packId": "PK-SUPER-FAMILY-HINDI", "packName": "Super Family Hindi", "packType": "BOUQUET", "monthlyPrice": 399.00, "hdEnabled": true, "channelCount": 312, "channels": [ { "channelId": "CH-101", "channelName": "Star Plus", "genre": "GEC", "language": "Hindi", "quality": "HD", "lcn": 101, "isAlaCarte": false } ], "addOns": [ { "addOnId": "AO-SPORTS-HD", "addOnName": "Sports HD", "monthlyPrice": 49.00 } ] }搜索推荐套餐与单点频道
GET
/api/SubApp/packs/catalogopendata分页返回 Manage My Pack 使用的套餐目录:推荐频道包、Dish TV 组合包、超值包,以及可按类型和语言筛选的单点(a-la-carte)频道。
认证方式: Authorization: Bearer accessToken。可选的 genre、language 和 q 筛选来自套餐浏览器。
- genre
- language
- q
- recommended
- packId
- packName
- packType
- monthlyPrice
- channelCount
- isRecommended
- combos
- alaCarte
- channelId
- channelName
GET /api/SubApp/packs/catalog?vcNumber=012345678901&genre=GEC&language=Hindi&q=family HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "recommended": [ { "packId": "PK-VALUE-HINDI", "packName": "Value Hindi", "packType": "VALUE_PACK", "monthlyPrice": 249.00, "channelCount": 198, "isRecommended": true } ], "combos": [ { "packId": "PK-DISH-COMBO-1", "packName": "Dish TV Combo", "monthlyPrice": 449.00 } ], "alaCarte": [ { "channelId": "CH-401", "channelName": "Sony Liv Pack", "monthlyPrice": 19.00, "language": "Hindi" } ] }修改套餐(增减频道)
POST
/api/SubApp/packs/modifyopendata在 Manage My Pack 上应用频道与附加包的增减;若月费上涨,返回交给充值收银台的 paymentOrderId。
认证方式: Authorization: Bearer accessToken。写入作用于所选 vcNumber;月费变化时会在付款前先返回预览报价。
- vcNumber
- addChannelIds
- removeChannelIds
- addOnIds
- modificationId
- newMonthlyPrice
- priceDelta
- effectiveFrom
- requiresPayment
- paymentOrderId
POST /api/SubApp/packs/modify HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "vcNumber": "012345678901", "addChannelIds": ["CH-401"], "removeChannelIds": ["CH-218"], "addOnIds": ["AO-SPORTS-HD"] }{ "status": "SUCCESS", "modificationId": "MOD-55291", "vcNumber": "012345678901", "newMonthlyPrice": 448.00, "priceDelta": 49.00, "effectiveFrom": "2026-10-13", "requiresPayment": true, "paymentOrderId": "pay-8f21a4" }发起即时充值
POST
/api/SubApp/recharge/initiateopenfinance为所选观看卡(本人、好友或先用后付)创建 DishTV 充值订单并套用优惠,返回应用内收银台使用的 Juspay 订单。
认证方式: Authorization: Bearer accessToken。金额默认取账户概要中的 monthlyRechargeAmount;支付工具环节由 Juspay HyperSDK 完成。
- vcNumber
- amount
- currency
- offerId
- payLater
- rechargeForFriend
- orderId
- discountAmount
- payableAmount
- juspayClientId
- juspayOrderId
- paymentUrl
- switchOffDateAfter
POST /api/SubApp/recharge/initiate HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "vcNumber": "012345678901", "amount": 399.00, "currency": "INR", "offerId": "OFF-FESTIVE-50", "payLater": false, "rechargeForFriend": false }{ "status": "SUCCESS", "orderId": "DTV-RCH-884291", "vcNumber": "012345678901", "amount": 399.00, "discountAmount": 50.00, "payableAmount": 349.00, "currency": "INR", "juspayClientId": "dishtv", "juspayOrderId": "ordeh_9c1a", "paymentUrl": "https://payments.juspay.in/merchant/pay/ordeh_9c1a", "switchOffDateAfter": "2026-11-12" }列出账户流水 / 充值交易
GET
/api/SubApp/transactionsopenbanking分页返回 All Transactions 背后的账户流水:充值、改套餐和先用后付记录,含支付方式、状态和摘要说明。
认证方式: Authorization: Bearer accessToken。按 fromDate / toDate 和 vcNumber 分页。
- fromDate
- toDate
- page
- pageSize
- total
- transactions
- txnId
- txnDate
- txnType
- amount
- currency
- mode
- status
- narration
- vcNumber
GET /api/SubApp/transactions?vcNumber=012345678901&fromDate=2026-07-01&toDate=2026-09-29&page=1&pageSize=20 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "page": 1, "pageSize": 20, "total": 14, "transactions": [ { "txnId": "DTV-RCH-884291", "txnDate": "2026-09-12T18:41:02+05:30", "txnType": "RECHARGE", "amount": 399.00, "currency": "INR", "mode": "UPI", "status": "SUCCESS", "narration": "Instant recharge Super Family Hindi", "vcNumber": "012345678901" } ] }列出发票
GET
/api/SubApp/invoicesopenfinance返回 My Invoice 页面的账期、含税合计金额和 PDF 链接。
认证方式: Authorization: Bearer accessToken。vcNumber 限定计费账户。
- invoiceNumber
- invoiceDate
- periodFrom
- periodTo
- packName
- amount
- taxAmount
- totalAmount
- currency
- pdfUrl
- status
GET /api/SubApp/invoices?vcNumber=012345678901&page=1&pageSize=12 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "invoices": [ { "invoiceNumber": "INV-202609-4412", "invoiceDate": "2026-09-01", "periodFrom": "2026-08-13", "periodTo": "2026-09-12", "packName": "Super Family Hindi", "amount": 399.00, "taxAmount": 71.82, "totalAmount": 470.82, "currency": "INR", "pdfUrl": "/invoices/INV-202609-4412.pdf", "status": "PAID" } ] }获取 EPG 频道节目单
GET
/api/SubApp/epg/guideopendata提供 Channel Guide 背后的电子节目指南:按 LCN 的节目列表、简介、收藏标记和提醒状态。
认证方式: Authorization: Bearer accessToken。date 以及可选的 genre / language 筛选节目网格;subscribedOnly=true 只返回当前套餐内的频道。
- date
- genre
- subscribedOnly
- channels
- channelId
- channelName
- lcn
- isFavorite
- programmes
- programmeId
- title
- startTime
- endTime
- synopsis
- reminderSet
GET /api/SubApp/epg/guide?vcNumber=012345678901&date=2026-09-29&genre=GEC&subscribedOnly=true HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "date": "2026-09-29", "channels": [ { "channelId": "CH-101", "channelName": "Star Plus", "lcn": 101, "isFavorite": true, "programmes": [ { "programmeId": "EPG-101-1840", "title": "Anupamaa", "startTime": "2026-09-29T18:30:00+05:30", "endTime": "2026-09-29T19:00:00+05:30", "synopsis": "Daily soap", "reminderSet": false } ] } ] }列出优惠与限时套餐
GET
/api/SubApp/offersopendata返回首页横幅和 Offer limited 卡片展示的充值与套餐优惠(立减 / 折扣比例、最低金额、有效期、适用 packId)。
认证方式: Authorization: Bearer accessToken。可选 vcNumber 按当前套餐个性化推荐优惠。
- offers
- offerId
- title
- description
- discountType
- discountValue
- minRechargeAmount
- validTill
- applicablePackIds
- bannerUrl
GET /api/SubApp/offers?vcNumber=012345678901 HTTP/1.1 Authorization: Bearer eyJhbGciOi...{ "status": "SUCCESS", "offers": [ { "offerId": "OFF-FESTIVE-50", "title": "Festive ₹50 off", "description": "₹50 off on recharge of ₹399 or more", "discountType": "FLAT", "discountValue": 50.00, "minRechargeAmount": 399.00, "validTill": "2026-10-31", "applicablePackIds": ["PK-SUPER-FAMILY-HINDI"], "bannerUrl": "/banners/festive-50.webp" } ] }创建故障工单
POST
/api/SubApp/issuesopendata从 Issue Tracker 提交服务工单(无信号、充值未到账、机顶盒报错),返回 ticketId、状态和设备端排障步骤。
认证方式: Authorization: Bearer accessToken。可选附带相机拍摄的照片;工单绑定到 vcNumber。
- vcNumber
- category
- description
- stbOn
- errorCode
- ticketId
- ticketStatus
- createdAt
- etaHours
- troubleshootSteps
POST /api/SubApp/issues HTTP/1.1 Authorization: Bearer eyJhbGciOi... Content-Type: application/json { "vcNumber": "012345678901", "category": "NO_SIGNAL", "description": "No signal after recharge, error 101", "stbOn": true, "errorCode": "101" }{ "status": "SUCCESS", "ticketId": "SR-95017-88421", "vcNumber": "012345678901", "category": "NO_SIGNAL", "ticketStatus": "OPEN", "createdAt": "2026-09-29T18:12:04+05:30", "etaHours": 24, "troubleshootSteps": [ "Keep the set-top box powered on", "Reseat the LNB cable", "Wait for the next signal refresh" ] }
数据类别
- 身份信息
- 余额
- 交易记录
- 账单
- 套餐目录
- EPG 节目单
数据使用场景与案例
DTH 余额与停机监控
家庭账单机器人在完成 RMN OTP 会话后,按 vcNumber 调用 GET /api/SubApp/account/summary,当 balanceAmount 或 switchOffDate 落入设定窗口时发出提醒,并以 monthlyRechargeAmount 作为建议充值额。
套餐与频道阵容核对
内容版权看板拉取 GET /api/SubApp/packs/current(channelId、lcn、genre、quality、addOns),与 GET /api/SubApp/packs/catalog 做差异比对,让运营方看清某张观看卡实际包含哪些频道包和单点频道。
充值流水接入财务工具
夜间任务分页拉取 GET /api/SubApp/transactions 与 GET /api/SubApp/invoices,把 txnId、mode、payableAmount 和 GST taxAmount 落入 INR 现金账,并与 POST /api/SubApp/recharge/initiate 返回的 Juspay orderId 对账。
结合 EPG 的观看提醒
伴侣客户端读取 subscribedOnly=true 频道的 GET /api/SubApp/epg/guide,再用 programmeId / startTime / isFavorite 安排与应用内 Channel Guide 一致的节目提醒。
常见问题
My DishTV 如何认证订户?
应用通过 POST /api/SubApp/auth/otp 向注册手机号发送 6 位短信验证码,再在 /api/SubApp/auth/verify 用 otpTxnId + otp 换取 Bearer accessToken 及该 RMN 关联的 VC 号列表。后续 SubApp 调用携带 Authorization: Bearer;请求体由原生加密插件做 JWT 签名。
哪些字段描述 DishTV 账户的资金状态?
GET /api/SubApp/account/summary 返回 balanceAmount 与 currency(INR)、monthlyRechargeAmount、switchOffDate、lastPaymentDate / lastPaymentAmount,以及所选 vcNumber / stbId 的 currentPack 对象(packId、packName、endDate)。
API 中的即时充值如何实现?
POST /api/SubApp/recharge/initiate 为某个 vcNumber 与金额创建订单(可选 offerId、payLater、rechargeForFriend),响应含 orderId、payableAmount、juspayClientId / juspayOrderId 与 paymentUrl;由 Juspay HyperSDK(商户 dishtv)完成 UPI、银行卡、钱包或网银支付。产生的记录出现在 GET /api/SubApp/transactions。
除了余额,能否读取频道列表与 EPG?
可以。GET /api/SubApp/packs/current 返回已订频道(channelId、lcn、genre、language、quality)与附加包;GET /api/SubApp/packs/catalog 分页返回推荐/组合/单点条目;GET /api/SubApp/epg/guide 返回频道指南页的逐节目 title、startTime、synopsis 与 reminderSet。
与 My DishTV 相似的应用
- Tata Play — Tata Play(原 Tata Sky)是印度另一家大型 DTH 卫星电视运营商,其官方自助应用供订户查询余额、充值并管理套餐与频道。
- Airtel Thanks — Airtel 的一体化应用,除移动与宽带业务外还可管理 Airtel Digital TV,支持 DTH 余额查询、充值以及在 Manage DTH 页面增删频道。
- Paytm — 印度支付应用,其 DTH 充值板块支持 Dish TV、Tata Play、Airtel Digital TV 等账户,并为到期日提供充值提醒。
- My Sun Direct — 以南印度市场为主的 DTH 运营商 Sun Direct 的官方应用,用于管理机顶盒连接、套餐与充值。
- PhonePe — UPI 支付应用,其 DTH 充值覆盖 Dish TV、Tata Play、Sun Direct、d2h 等印度主要运营商,并提供小额返现。
- Freecharge — 充值类应用,设有各运营商专属的 DTH 充值页面,可为 Tata Play、Dish TV、Videocon d2h、Airtel Digital TV 账户充值。
相关主题
- My DishTV 数据 API
- Dish TV 订户接口
- DTH 充值接口
- VC 号余额
- DishTV 套餐目录
- 停机日期
- DishTV 发票
- EPG 频道指南
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业