openData StudioEnglish
Airtel: Recharge, Bank & Loans 图标

Airtel 数据 API：充值、账单与火车票

Bharti Airtel Limited · 电信

在 Google Play 中打开

Airtel: Recharge, Bank & Loans 是印度 Bharti Airtel Limited 面向用户的超级应用，Play 商店以 Airtel Thanks / MyAirtel 上架。预付费用户在手机上浏览套餐并充值；后付费、宽带和 DTH 用户在同一登录里缴账单；首页还可进入 Airtel Payments Bank 钱包、UPI、贷款和定期存款，以及 IRCTC 火车票和骚扰电话识别。登录从 SplashScreenActivity 开始，用手机号短信验证码完成，随后首页按业务线堆叠账户卡片。它是零售端 Mitra（Airtel 给店主用的应用）的用户侧对应产品，在印度各电信圈子与 Jio 的 MyJio、Vodafone Idea 的 Vi App 竞争。

Thanks 会员档位会把 thanksTier 与 isThanksCustomer 写进会话，预付费套餐同时打上 packId、dataBenefit 与 validity；首页卡片给出 siNumber 与 lob，后付费行则给出 outstandingDetails 的 amount 和 dueDate。预付费扣减历史把这些行分页成 txBatches 里的 transactions，以 filterIndex 过滤，pageInfo 带 nextPageNumber；最近一次扣减抬头是 message 加 cta 的 uri。GPA 保险历史以 TRAN_ID 与 TRAN_AMT 列出 txnList。输入号码页的近期充值带 billerCircle 与 billerCode；提醒行以 reminderId 为键；骚扰电话查询返回 isSpam 与 callerName。钱包开通用 otpCode 对照 feSessionId 校验，随后露出 wallet 与 balance；UPI 绑卡返回 vpa、accountNumber 和 ifsc，收款请求再带 beneVpa 与 upiTxnId。车次列表以 trainNumber、fromStnCode 和 toStnCode 为键；订票历史打上 pnr 与 grossFare；PNR 查询补上 pnrNumber、ticketId 与 totalCollectibleAmount；铁路资料保存 irctcUserId。光纤改套餐行打上 dslId、landlineNumber 与 currentPlanPrice；获客邮编检查返回 servicable 与 lobMessage；设置露出 isWhatsAppReminder。UPI Autopay 行打上 umn、frequency 与付款 vpa；银行 ID 解析返回 customerId 与 feSessionId；最低 KYC 资格带 firstName、dob 与 pincode；车站目录以 stationCode 与 stationName 为键。Bharosa 储蓄账本在同一 Payments Bank 客户上打上 accNumber、currBalance 与 currentMonthMab。放贷、账单代缴、圈子运营、光纤和铁路系统用这些字段核对充值、欠费、Payments Bank 现金与车票；openData Studio 把它们做成可调用的开放数据。

应用截图

  • Airtel: Recharge, Bank & Loans 应用截图 1
  • Airtel: Recharge, Bank & Loans 应用截图 2
  • Airtel: Recharge, Bank & Loans 应用截图 3
  • Airtel: Recharge, Bank & Loans 应用截图 4
  • Airtel: Recharge, Bank & Loans 应用截图 5

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

  • 为手机号发送登录 OTP

    POST /v1/sessions/otp osint

    为订阅者 MSISDN 发起 Airtel Thanks 登录，返回 OTP 挑战载荷。

    认证方式： 无需会话。设备与号码头：x-line-msisdn、x-device-id、x-device-type、x-os、x-app-version、x-build-name；登录后调用带 x-session-token 与 x-access-token。

    • msisdn
    • isVerified
    • title
    • subTitle
    • callTitle
    • errorText
    POST /v1/sessions/otp HTTP/1.1
Content-Type: application/json
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210

{"msisdn": "9876543210"}
    {"data": {"isVerified": false, "title": "Verify OTP", "subTitle": "OTP sent to 9876543210", "callTitle": "Call me instead", "errorText": ""}, "respCode": 200, "requestId": "req-8f21a4"}

  • 获取首页账户卡片与提醒

    GET /v1/home/cards opendata

    返回登录后首页：每个 SI 一张账户卡片，含家庭计划标记与提醒文案。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn、x-device-id、x-os、x-app-version。

    • headerTitle
    • siNumber
    • lob
    • message
    • title
    • subTitle
    • state
    • familyParent
    • onFamilyPlan
    • accountCardSubData
    GET /v1/home/cards HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": [{"headerTitle": "Prepaid", "siNumber": "9876543210", "lob": "PREPAID", "message": "2.4 GB left today", "title": "Thanks Silver", "subTitle": "Validity 12 Oct", "state": "ACTIVE", "familyParent": true, "onFamilyPlan": true, "accountCardSubData": []}]}

  • 获取 Thanks 应用配置

    GET /v1/home/config opendata

    加载首页应用配置：Thanks 会员标记及控制首页磁贴的功能与支付配置。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn、x-device-id。

    • thanksData
    • isThanksLive
    • isThanksCustomer
    • isEligibleForThanks
    • thanksTier
    • thanksTitle
    • theme
    • featureConfig
    • appConfig
    • hummingBirdStackCardResponse
    • digitalRechargeResponse
    GET /v1/home/config HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"thanksData": {"isThanksLive": true, "isThanksCustomer": true, "isEligibleForThanks": true, "thanksTier": "SILVER", "thanksTitle": "Thanks Silver", "theme": "light"}, "featureConfig": {}, "appConfig": {}, "hummingBirdStackCardResponse": {}, "digitalRechargeResponse": {}}}

  • 读取订阅者资料

    GET /v1/subscriber/profile osint

    读取已认证订阅者的 SI 号码与 emailId，展示在「我的账户」资料页。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • siNumber
    • emailId
    GET /v1/subscriber/profile HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"siNumber": "9876543210", "emailId": "[email protected]"}}

  • 列出预付费与后付费套餐

    GET /v1/catalog/tariff-packs opendata

    返回预付费与后付费的浏览套餐行：金额、有效期、流量及 data/call/sms 权益，供充值与改套餐页使用。

    认证方式： OTP 会话的 x-session-token 与 x-access-token；查询标识 SI（siNumber、lob、circleId）。

    • packId
    • amount
    • paymentAmount
    • mrp
    • validity
    • volume
    • dataBenefit
    • callBenefit
    • smsBenefit
    • siNumber
    • circleId
    • lob
    • offerId
    • benefits
    • currentPlanId
    • newPlanId
    GET /v1/catalog/tariff-packs?siNumber=9876543210&lob=PREPAID&circleId=14 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"packs": [{"packId": "P18765", "amount": "299", "paymentAmount": "299", "mrp": 299, "validity": "28 days", "volume": "2 GB/day", "dataBenefit": "2 GB/day", "callBenefit": "Unlimited", "smsBenefit": "100 SMS/day", "siNumber": "9876543210", "circleId": "14", "lob": "PREPAID", "offerId": "OFF-299", "benefits": "Unlimited calls + 2 GB/day", "currentPlanId": "CUR-199", "newPlanId": "NEW-299"}]}}

  • 列出近期预付费充值

    GET /v1/recharges/recent opendata

    返回预付费近期充值套餐，含分类标题与权益映射，供浏览套餐页使用。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • packs
    • categoryTitleList
    • packBenefitsMap
    • packId
    • amount
    • validity
    • dataBenefit
    • siNumber
    GET /v1/recharges/recent HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"packs": [{"packId": "P18765", "amount": "299", "validity": "28 days", "dataBenefit": "2 GB/day", "siNumber": "9876543210"}], "categoryTitleList": [{"title": "Last recharge"}], "packBenefitsMap": {}}}

  • 读取 NDS 圈子与用户类型

    GET /v1/account/line-info opendata

    返回该 SI 的线路信息（充值前使用）：电信圈子、展示名、用户类型与账户标记。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • circle
    • circlDisplayName
    • userType
    • corporateUser
    • dataUser
    • creationDate
    • jk10
    GET /v1/account/line-info HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"circle": "Delhi", "circlDisplayName": "Delhi NCR", "userType": "PREPAID", "corporateUser": false, "dataUser": true, "creationDate": 1694764800000, "jk10": false}}

  • 读取家庭宽带 / 后付费欠费金额

    GET /v1/bills/outstanding openfinance

    返回家庭宽带/后付费欠费金额与 dueDate，含行明细与页脚，渲染在缴费页。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • outstandingDetails
    • amount
    • dueDate
    • headerDetails
    • outerPayNow
    • popupData
    • rowDetails
    • footerTitle
    GET /v1/bills/outstanding HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"outstandingDetails": {"amount": 1849.0, "dueDate": "2026-10-21", "headerDetails": {}, "outerPayNow": {}, "popupData": {}}, "rowDetails": [], "footerTitle": []}}

  • 校验 Payments Bank 钱包 OTP

    POST /v1/wallet/otp/verify openbanking

    确认 Payments Bank 最低 KYC 钱包 OTP。

    认证方式： 应用会话的 x-session-token；请求体带钱包开户 OTP 字段（feSessionId、otpCode、verificationToken）。

    • feSessionId
    • custType
    • requestType
    • partnerId
    • otpCode
    • verificationToken
    • customerId
    • dbtConsent
    • languageId
    • ver
    • message
    POST /v1/wallet/otp/verify HTTP/1.1
Content-Type: application/json
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210

{"feSessionId": "fes-9c11", "custType": "CUSTOMER", "requestType": "WALLET_ONBOARD", "partnerId": "THANKS", "otpCode": "482913", "verificationToken": "vt-55c17a", "customerId": "cust-1001", "dbtConsent": true, "languageId": "en", "ver": "v1"}
    {"data": {"message": "OTP verified"}}

  • 读取钱包状态与余额

    GET /v1/wallet/status openbanking

    OTP 后读取最低 KYC 钱包状态：钱包句柄与余额。

    认证方式： 应用会话的 x-session-token 与 x-line-msisdn；钱包调用另带 x-transact-token。

    • wallet
    • balance
    • additionalParams
    GET /v1/wallet/status HTTP/1.1
x-session-token: sess-c91e2b
x-transact-token: txn-9c11
    {"data": {"wallet": "9876543210", "balance": 1250.5, "additionalParams": {}}}

  • 读取 Bharosa 储蓄与 sweep-out 余额

    GET /v1/savings/{customerId}/balances openbanking

    返回 Bharosa 储蓄余额明细及 sweep-out 子账本。

    认证方式： x-session-token 与 x-line-msisdn。路径代入银行会话返回的 Payments Bank customerId；mab=1 查月均余额；无请求体。

    • sba
    • ssfb
    • accNumber
    • productCode
    • title
    • eodBalance
    • status
    • currBalance
    • type
    • custId
    • bank
    • natlId
    • currentMonthMab
    GET /v1/savings/cust-1001/balances?mab=1 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"sba": {"accNumber": "910012345678", "productCode": 101, "title": "Bharosa Savings", "eodBalance": 8420.5, "status": "ACTIVE", "currBalance": 8510.0, "type": "SBA", "custId": "cust-1001", "bank": "Airtel Payments Bank", "natlId": "XXXX1234", "currentMonthMab": 6100.0}, "ssfb": {"accNumber": "910098765432", "status": "ACTIVE", "currBalance": 2500.0, "custId": "cust-1001", "bank": "Airtel Payments Bank", "natlId": "XXXX1234", "eodBalance": 2500.0}}}

  • 列出已绑定的 UPI 账户

    GET /v1/payments/upi/accounts openfinance

    返回绑定到 Payments Bank 钱包的 UPI 账户（VPA 行与 IFSC 账户）及启用状态。

    认证方式： x-session-token 与 x-line-msisdn；UPI 调用另带 x-transact-token。

    • status
    • recentPayList
    • vpa
    • name
    • amount
    • remarks
    • iconUrl
    • upiAccountIfscDto
    • bank
    • accountNumber
    • ifsc
    GET /v1/payments/upi/accounts HTTP/1.1
x-session-token: sess-c91e2b
x-transact-token: txn-9c11
    {"data": {"status": "ACTIVE", "recentPayList": [{"vpa": "9876543210@airtel", "name": "R Sharma", "amount": "500", "remarks": "Recharge", "iconUrl": ""}], "upiAccountIfscDto": [{"bank": "Airtel Payments Bank", "accountNumber": "910012345678", "ifsc": "AIRP0000001", "name": "R Sharma", "amount": "0", "remarks": ""}]}}

  • 解析号码所属运营商与圈子

    GET /v1/lookup/operator osint

    在输入号码充值流程中查询目标号码所属运营商圈子。

    认证方式： 应用会话的 x-session-token。查询为目标充值 MSISDN（本机或其他号码）。

    • enableNds
    • walletResponse
    • circle
    GET /v1/lookup/operator?msisdn=9876543210 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"enableNds": true, "walletResponse": {"circle": "Delhi"}}}

  • 加载输入号码页的近期充值

    GET /v1/recharges/recipients opendata

    加载预付费输入号码页及各运营商的近期充值行。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；参数为目标 MSISDN（空为本机）。

    • header
    • subHeader
    • title
    • recentRecharges
    • subTitle
    • operatorIcon
    • buttonText
    • billerCircle
    • billerCode
    • billerName
    • bsbCircleId
    • circleAlias
    • lob
    • amount
    GET /v1/recharges/recipients HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"header": "Recharge any number", "subHeader": "Airtel, Jio, Vi and more", "title": "Recent recharges", "recentRecharges": [{"title": "9876543210", "subTitle": "Airtel Delhi", "operatorIcon": "", "buttonText": "Recharge", "billerCircle": "Delhi", "billerCode": "ATLDL", "billerName": "Airtel", "bsbCircleId": "14", "circleAlias": "DL", "lob": "PREPAID", "amount": 299.0}]}}

  • 查询来电号码是否为骚扰电话

    GET /v1/calls/spam-check osint

    按入电号码查询运营商骚扰图谱，返回 JSON 判定。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；入电号码为唯一参数，返回 JSON 判定。

    • isSpam
    • callerName
    • cnapWasThisSpam
    GET /v1/calls/spam-check HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"isSpam": true, "callerName": "Promo", "cnapWasThisSpam": false}}

  • 发起 UPI 收款请求

    POST /v1/payments/upi/collect openfinance

    向收款 VPA 发起 UPI 收款请求，返回交易状态与过期时间。

    认证方式： x-session-token 与 x-line-msisdn；UPI 调用另带 x-transact-token。

    • type
    • amount
    • remarks
    • upiTxnStatus
    • upiTxnId
    • vpa
    • name
    • beneVpa
    • beneName
    • collectExpiry
    • refId
    • isMarkedAsSafe
    • description
    POST /v1/payments/upi/collect HTTP/1.1
Content-Type: application/json
x-session-token: sess-c91e2b
x-transact-token: txn-9c11

{"type": "COLLECT", "amount": "500", "remarks": "Recharge", "vpa": "9876543210@airtel", "name": "Rahul Sharma", "beneVpa": "shop@okicici", "beneName": "Corner Shop", "description": "Prepaid pack"}
    {"data": {"type": "COLLECT", "amount": "500", "remarks": "Recharge", "upiTxnStatus": "PENDING", "upiTxnId": "AXId9f2a11", "vpa": "9876543210@airtel", "name": "R Sharma", "beneVpa": "shop@okicici", "beneName": "Shop", "collectExpiry": "2026-10-15T18:30+05:30", "refId": "ref-55c17a", "isMarkedAsSafe": false}}

  • 列出首页提醒卡片

    GET /v1/home/reminders opendata

    返回首页提醒列表：过期时间、排序及按 SI 和业务线索引的提醒行。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；参数一般为 SI。

    • expiryTimeInMillis
    • leftTitle
    • rank
    • dismissData
    • reminders
    • reminderId
    • siNumber
    • lob
    • title
    • subTitle
    • offerText
    • offerText2
    • imgUrl
    • isMandatory
    • isPrimary
    GET /v1/home/reminders HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"expiryTimeInMillis": 1697328000000, "leftTitle": "Reminders", "rank": 1, "dismissData": {}, "reminders": [{"reminderId": "rem-299", "siNumber": "9876543210", "lob": "PREPAID", "title": "Validity ending", "subTitle": "Recharge to keep 2 GB/day", "offerText": "Pack from ₹299", "offerText2": "", "imgUrl": "", "isMandatory": false, "isPrimary": true}]}}

  • 查询两站之间的列车

    GET /v1/rail/trains/{fromStation}/{toStation}/{journeyDate} opendata

    按出发站、到达站与日期返回车次，含时刻、历时与里程。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • trainBtwnStnsList
    • trainNumber
    • trainName
    • fromStnCode
    • fromStnName
    • toStnCode
    • toStnName
    • departureTime
    • arrivalTime
    • durationSec
    • distance
    • selectedQuota
    • avlClasses
    • quotaList
    • stickers
    GET /v1/rail/trains/NDLS/BCT/20261020 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"trainBtwnStnsList": [{"trainNumber": "12952", "trainName": "Mumbai Rajdhani", "fromStnCode": "NDLS", "fromStnName": "New Delhi", "toStnCode": "BCT", "toStnName": "Mumbai Central", "departureTime": "16:55", "arrivalTime": "08:35", "durationSec": 56400, "distance": "1384", "selectedQuota": "GN", "avlClasses": []}], "quotaList": [], "stickers": []}}

  • 读取 IRCTC 订票历史

    GET /v1/rail/bookings opendata

    返回已登录铁路账号的订票历史：车次、车站、席别、票价与状态标签。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • bookingHistory
    • pnr
    • trainNumber
    • trainName
    • bookingFromStationCode
    • bookingFromStationName
    • bookingUpToStationCode
    • bookingUpToStationName
    • journeyClass
    • departureTime
    • passengerCount
    • grossFare
    • statusLabel
    • prId
    GET /v1/rail/bookings HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"bookingHistory": [{"pnr": "2613498210", "trainNumber": "12952", "trainName": "Mumbai Rajdhani", "bookingFromStationCode": "NDLS", "bookingFromStationName": "New Delhi", "bookingUpToStationCode": "BCT", "bookingUpToStationName": "Mumbai Central", "journeyClass": "3A", "departureTime": 1760964300000, "passengerCount": "2", "grossFare": 4560.0, "statusLabel": "Confirmed", "prId": "pr-8821"}]}}

  • 读取 IRCTC 用户资料

    GET /v1/rail/profile osint

    读取已绑定铁路客户资料，含常用乘客与订票上限。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • irctcUserId
    • emailId
    • mobileNumber
    • maxBookingAllowed
    • recentPassengers
    • quickBookings
    • recentInfants
    GET /v1/rail/profile HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"irctcUserId": "airtel_ndls_user", "emailId": "[email protected]", "mobileNumber": "9876543210", "maxBookingAllowed": "6", "recentPassengers": [], "quickBookings": [], "recentInfants": []}}

  • 查询 IRCTC PNR 车票详情

    GET /v1/rail/pnr/{pnrNumber} opendata

    按 PNR 返回车票详情：车次、席别、费用、车票标识与乘客列表。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；PNR 字符串为路径参数。

    • purpose
    • pnrNumber
    • trainNumber
    • trainName
    • fromStationCode
    • toStationCode
    • journeyClass
    • dateOfJourney
    • boardingPoint
    • grossFare
    • gstCharge
    • serviceCharge
    • totalCollectibleAmount
    • ticketId
    • ticketUrl
    • passengerList
    GET /v1/rail/pnr/2613498210 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"purpose": {"pnrNumber": "2613498210", "trainNumber": "12952", "trainName": "Mumbai Rajdhani", "fromStationCode": "NDLS", "toStationCode": "BCT", "journeyClass": "3A", "dateOfJourney": "2026-10-20", "boardingPoint": "NDLS", "grossFare": 4560.0, "gstCharge": 205.2, "serviceCharge": 40.0, "totalCollectibleAmount": "4805.2", "ticketId": "tkt-8821", "ticketUrl": "https://example.invalid/tkt", "passengerList": []}}}

  • 读取 WhatsApp 提醒设置

    GET /v1/settings/reminders opendata

    读取首页账单与有效期提醒使用的 isWhatsAppReminder 开关。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn。

    • isWhatsAppReminder
    GET /v1/settings/reminders HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"isWhatsAppReminder": true}}

  • 获取宽带改套餐详情

    GET /v1/broadband/plan-change opendata

    返回光纤/DSL 改套餐详情：当前套餐、DSL 编号、固话号码与可选套餐。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；查询标识 DSL 账户（dslId / landlineNumber）。

    • currentPlan
    • accountId
    • dslId
    • landlineNumber
    • packId
    • arpCode
    • currentPlanPrice
    • endDate
    • billPlanDto
    • name
    • title
    • billPlanType
    • technology
    • price
    • planID
    • prospectivePlans
    • currentPlanEligibility
    GET /v1/broadband/plan-change?dslId=DSL-4411 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"currentPlan": {"accountId": "acc-4411", "dslId": "DSL-4411", "landlineNumber": "01123456789", "packId": "BB-999", "arpCode": "ARP-12", "currentPlanPrice": 999, "endDate": "2026-11-15", "billPlanDto": {"name": "200 Mbps", "title": "Fibre 200", "billPlanType": "UNLIMITED", "technology": "GPON", "price": "999", "planID": "PL-200"}}, "prospectivePlans": {}, "currentPlanEligibility": {}}}

  • 查询邮编宽带可开通性

    POST /v1/coverage/pincode opendata

    按邮编判断能否新装宽带/DTH，返回可服务性文案与 CTA。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；请求体为邮编与 LOB 字符串。

    • pinCode
    • lob
    • message
    • messageColor
    • servicable
    • lobMessage
    • lobMessageColor
    • cta
    POST /v1/coverage/pincode HTTP/1.1
Content-Type: application/json
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210

{"pinCode": "110001", "lob": "BROADBAND"}
    {"data": {"message": "Fibre available", "messageColor": "#008000", "servicable": true, "lobMessage": "Airtel Black fibre in this pin", "lobMessageColor": "#111111", "cta": {}}}

  • 列出 UPI Autopay 委托扣款

    GET /v1/payments/mandates openfinance

    返回 UPI Autopay 委托行：金额、频率、起止日期、状态与收付款 VPA。

    认证方式： x-session-token 与 x-line-msisdn；委托调用另带 x-transact-token。列表按 offset/limit 分页，单笔按 UMN 获取。

    • mandateList
    • amount
    • remarks
    • frequency
    • startDate
    • endDate
    • amountRule
    • umn
    • txnid
    • accountId
    • displayStatus
    • title
    • subTitle
    • isExecutable
    • txnStatus
    • isRevokable
    • isModifiable
    • isAcceptable
    • custRefNo
    • vpa
    • name
    • bankName
    • accountNumber
    • isVerifiedMerchant
    GET /v1/payments/mandates?offset=0&limit=20 HTTP/1.1
x-session-token: sess-c91e2b
x-transact-token: txn-9c11
    {"data": {"mandateList": [{"amount": 499.0, "remarks": "DTH pack", "frequency": "MONTHLY", "startDate": "2026-10-01", "endDate": "2027-09-30", "amountRule": "MAX", "umn": "UMN1234567890@airtel", "txnid": "AXImandate01", "accountId": "acc-9100", "displayStatus": "ACTIVE", "title": "Airtel DTH", "subTitle": "Autopay ₹499", "isExecutable": true, "txnStatus": 1, "isRevokable": true, "isModifiable": true, "isAcceptable": false, "custRefNo": "cref-4411", "beneInfo": {"vpa": "dth@airtel", "name": "Airtel DTH", "bankName": "Airtel Payments Bank", "accountNumber": "910012345678", "isVerifiedMerchant": true}}]}}

  • 读取 Payments Bank 客户与设备 ID

    POST /v1/banking/session openbanking

    解析同一登录下钱包、UPI 与借记卡调用所需的客户与会话 ID。

    认证方式： 应用会话的 x-session-token 与 x-line-msisdn；请求体为 JSON 设备 / 会话载荷。

    • messageText
    • code
    • errorCode
    • feSessionId
    • customerId
    • deviceId
    POST /v1/banking/session HTTP/1.1
Content-Type: application/json
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210

{"deviceId": "8f21a4c2-9b11-4e0a-a3d1-55c17a91f0e2"}
    {"data": {"messageText": "OK", "code": "0", "errorCode": "", "feSessionId": "fes-9c11", "customerId": "cust-1001", "deviceId": "8f21a4c2-…-55c17a91f0e2"}}

  • 查询最低 KYC 钱包开通资格

    POST /v1/wallet/eligibility openbanking

    返回最低 KYC 钱包资格响应：注册类型及客户资料。

    认证方式： 应用会话的 x-session-token 与 x-line-msisdn；请求体带合作方 / 渠道及资格字段。

    • registrationType
    • walletEligibilityConfigMap
    • walletEligibilityCustomerDetails
    • firstName
    • middleName
    • lastName
    • email
    • pincode
    • dob
    POST /v1/wallet/eligibility HTTP/1.1
Content-Type: application/json
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210

{"partnerId": "THANKS", "custType": "CUSTOMER"}
    {"data": {"registrationType": "MIN_KYC", "walletEligibilityConfigMap": {}, "walletEligibilityCustomerDetails": {"firstName": "Rahul", "middleName": "", "lastName": "Sharma", "email": "[email protected]", "pincode": "110001", "dob": "1992-04-18"}}}

  • 列出 IRCTC 车站

    GET /v1/rail/stations opendata

    返回铁路车站目录（全部与热门车站），供车次查询前使用。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；全量列表无查询，关键字搜索为同资源变体。

    • stations
    • popularStations
    • id
    • stationCode
    • stationName
    • city
    • weight
    • lastAccessedTime
    GET /v1/rail/stations HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"stations": [{"id": "NDLS", "stationCode": "NDLS", "stationName": "New Delhi", "city": "Delhi", "weight": 9.8, "lastAccessedTime": 1760500000000}], "popularStations": [{"id": "BCT", "stationCode": "BCT", "stationName": "Mumbai Central", "city": "Mumbai", "weight": 9.5, "lastAccessedTime": 0}]}}

  • 列出预付费余额扣减历史

    GET /v1/prepaid/deductions opendata

    分页返回预付费余额扣减：余额抬头、筛选与分批交易。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；查询参数含 msisdn、lob、source、circle、pageIndex、filterIndex。

    • balance
    • title
    • pageInfo
    • nextPageNumber
    • filter
    • options
    • id
    • name
    • isSelected
    • txBatches
    • transactions
    • titleMap
    • subtitle
    • icon
    • amount
    • txDetail
    • description
    • status
    • deductionDetail
    • ctas
    • date
    • tag
    • noData
    GET /v1/prepaid/deductions?msisdn=9876543210&lob=PREPAID&source=THANKS&circle=Delhi&pageIndex=0&density=xxhdpi&siNumber=9876543210&filterIndex=ALL HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"balance": {"title": "₹48.20"}, "pageInfo": {"nextPageNumber": 1, "title": "Load more"}, "filter": {"title": "Filter", "options": [{"id": "ALL", "name": "All", "isSelected": true}]}, "txBatches": [{"title": "Today", "transactions": [{"title": "Data deduction", "titleMap": "", "subtitle": "2 GB pack", "icon": "", "amount": {"title": "-₹10"}, "txDetail": {"description": "Daily data pack", "status": {}, "deductionDetail": [], "ctas": []}, "date": "15 Oct 2026", "tag": {}}]}], "noData": null}}

  • 读取最近一次预付费余额扣减抬头

    GET /v1/prepaid/deductions/latest opendata

    返回最近一次扣减文案及指向完整扣减列表的 CTA。

    认证方式： OTP 会话：x-session-token、x-access-token，外加 x-line-msisdn；查询参数含 circle、lob、siNumber、source、msisdn。

    • message
    • cta
    • title
    • uri
    GET /v1/prepaid/deductions/latest?circle=Delhi&lob=PREPAID&siNumber=9876543210&source=THANKS&msisdn=9876543210 HTTP/1.1
x-session-token: sess-c91e2b
x-line-msisdn: 9876543210
    {"data": {"message": "Last deduction ₹10 on 15 Oct", "cta": {"title": "View history", "uri": "myairtel://txnhistory"}}}

  • 列出 GPA 保险钱包流水

    GET /v1/wallet/insurance/transactions openfinance

    返回 Payments Bank 钱包的团体意外险（GPA）流水。

    认证方式： x-session-token 与 x-line-msisdn；钱包 / 银行调用另带 x-transact-token。

    • txnList
    • TRAN_ID
    • TRAN_DATE
    • CR_DR_INDICATOR
    • TRAN_PARTICULARS
    • TRAN_AMT
    • status
    • color
    • benVPA
    • benName
    • PAYMENT_STATUS
    • MODE
    • GST
    • TDS
    • SERVICE_CHARGE
    GET /v1/wallet/insurance/transactions HTTP/1.1
x-session-token: sess-c91e2b
x-transact-token: txn-9c11
    {"data": {"txnList": [{"TRAN_ID": "INS-4411", "TRAN_DATE": "15-10-2026 10:22:00", "CR_DR_INDICATOR": "CR", "TRAN_PARTICULARS": "GPA cover", "TRAN_AMT": "0", "status": "SUCCESS", "color": "#008000", "benVPA": "", "benName": "GPA", "PAYMENT_STATUS": "SUCCESS", "MODE": "account", "GST": "0", "TDS": "0", "SERVICE_CHARGE": "0"}]}}

数据类别

  • 资料
  • 套餐
  • 充值
  • 账单
  • 钱包
  • UPI
  • Thanks
  • 圈子
  • 骚扰电话
  • 提醒
  • 火车票
  • PNR
  • 宽带
  • 可服务性
  • 设置
  • 委托扣款
  • KYC
  • 车站
  • Bharosa 储蓄
  • 储蓄账户
  • 月均余额
  • 余额扣减
  • 保险

数据使用场景与案例

  • 预付费套餐与充值对账

    夜间任务把首页 siNumber/lob 卡片与 packId、dataBenefit、validity 行对齐，再对照近期充值套餐以及预付费 txBatches（filterIndex、pageInfo 的 nextPageNumber），让财务看清哪些 Thanks 预付费号码真正买了套餐、余额如何被扣减。

  • 后付费与家庭宽带缴费通道

    催收台读取 OutstandingDetails 的 amount 与 dueDate，坐席在用户确认前报出缴费页数字，同一登录下的 familyParent 线路一并覆盖。

  • Payments Bank 钱包与 UPI 绑定

    开户运营用 feSessionId/otpCode 确认钱包 OTP，再轮询 wallet/balance 以及已绑定 UPI 的 vpa/accountNumber/ifsc，让最低 KYC 钱包和 IFSC 账户与 Thanks 会话保持同步。同一登录再读取 Bharosa 储蓄账本的 currBalance、eodBalance 与 currentMonthMab，对照 accNumber/custId，使储蓄现金与钱包句柄对齐。

  • IRCTC 车次查询与 PNR 历史

    出行运营把 trainBtwnStnsList（trainNumber、fromStnCode、toStnCode）与 bookingHistory 的 pnr/grossFare、PNR 状态（pnrNumber、ticketId、totalCollectibleAmount）以及铁路资料 irctcUserId 对齐，使应用内车票能对上订阅者 MSISDN。

  • 宽带改套餐与邮编覆盖

    光纤运营把 currentPlan 的 packId、dslId、currentPlanPrice 与获客接口的 servicable/lobMessage 对齐，让 Thanks 登录能在用户付费前判断该邮编能否新装宽带套餐。

  • UPI Autopay 委托与钱包 KYC

    催收运营把委托的 umn/amount/frequency 与付款 vpa、Payments Bank 的 customerId/feSessionId 对齐，再对照 walletEligibilityCustomerDetails 的 firstName/dob，使 Thanks 登录下的 Autopay 行能对上同一 MSISDN 的最低 KYC 钱包。

常见问题

Airtel 号码如何对应到套餐和账单？

首页卡片和套餐行以 siNumber 加 lob（预付费、后付费、宽带）为键。套餐另有 packId、circleId 和 offerId；家庭账单给出 outstandingDetails.amount 与 dueDate。

Thanks 登录会露出哪些钱包和 UPI 字段？

钱包开户用 feSessionId、partnerId 和 verificationToken 校验 otpCode，再读取 wallet 与 balance。已绑定 UPI 账户返回 vpa、bank、accountNumber 和 ifsc，并带激活状态。

Thanks 会员如何表示？

应用配置返回 thanksData，含 isThanksLive、isThanksCustomer、isEligibleForThanks、thanksTier 和 thanksTitle，首页用它们给账户卡片换肤。

套餐、账单和钱包之外还有哪些面？

套餐、账单和钱包之外还有多个数据面：输入号码页的近期充值带 billerCircle、billerCode 与 lob；骚扰查询返回 isSpam、callerName 与 cnapWasThisSpam；提醒行以 reminderId 为键；UPI 覆盖已绑定 vpa/accountNumber/ifsc、带 upiTxnId 的收款请求和带 umn、frequency 的 Autopay 委托。IRCTC 列出 fromStnCode 与 toStnCode 之间的 trainNumber，订票历史打上 pnr 与 grossFare，PNR 查询给出 pnrNumber、ticketId 与 totalCollectibleAmount，铁路资料保存 irctcUserId 与 stationCode 车站目录。宽带改套餐暴露 dslId、landlineNumber 与 currentPlanPrice；邮编检查返回 servicable 与 lobMessage；设置暴露 isWhatsAppReminder。Bharosa 储蓄账本返回 accNumber、currBalance、eodBalance 与 currentMonthMab；预付费扣减历史按 filterIndex 分页 txBatches；GPA 保险列出带 TRAN_ID 与 TRAN_AMT 的 txnList。

与 Airtel: Recharge, Bank & Loans 相似的应用

  • MyJio — MyJio 是 Reliance Jio 面向印度用户的自助应用：同一登录下可预付费充值、缴后付费账单、管理 JioFiber 宽带并使用 JioMart。
  • Vi App — Vi App 是 Vodafone Idea 在印度的官方用户应用，覆盖预付费充值、后付费账单以及与移动账户并行的 Vi 影视服务。
  • Mitra — Mitra 是 Bharti Airtel 给经销商和社区店使用的零售应用，用于售卖 Airtel 充值，是 Thanks 用户端应用的渠道侧对应产品。
  • Paytm — Paytm 是印度支付超级应用，其钱包、UPI 与生活缴费能力与 Thanks 内的 Airtel Payments Bank 和 UPI 功能重叠。

更多电信类应用

相关主题

  • airtel thanks api
  • airtel 数据 api
  • airtel packId
  • airtel siNumber
  • airtel outstandingDetails
  • airtel 钱包
  • airtel upi vpa
  • airtel 充值 dataBenefit
  • airtel irctc pnr
  • airtel dslId
  • airtel servicable
  • airtel umn
  • airtel customerId
  • airtel currBalance
  • airtel currentMonthMab
  • airtel TRAN_AMT

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

  • 每个项目均签 NDA 与 SOW
  • 3–7 天交付
  • 验收通过后才付款
  • 仅在授权范围内作业

获取报价