Vi Smart-Connect 零售商数据 API
Smart-Connect 是 Vodafone Idea 面向印度 Vi 零售渠道推出的门店应用,供社区手机店、销售终端代理和 SBA 合作伙伴在各电信业务大区销售 Vi 预付费新连接及办理充值。门店使用登记手机号和 MPIN 或指纹登录后,可从快捷入口式首页处理多项业务:SIMEX 用于新连接开户,包含基于 Aadhaar 的 eKYC、身份及地址证明采集、客户人脸比对与活体检测;MNP 用于从其他运营商携号转入;CYN 则可按号码模式、价格或特殊日期搜索并预留自选号码;充值界面支持主套餐、附加包和 chillar 小额充值,并使用 M-PIN 确认。充错号码时,门店可在 WRR 界面发起冲正;e-top-up 钱包显示余额、利润率和已赚取佣金;全部交易视图汇总 O2C、FRC、UPI 记录及其退款状态。零售商还可通过应用的奖励计划积累游戏化跑分、徽章及刮刮卡优惠券。Vodafone Idea 借助分销商和一线销售网络在印度各地推广这些业务流程,Smart-Connect 与 Airtel Mitra、JioPOS Lite,以及 Spice Money、PayNearby 等多运营商代理平台同为门店柜台使用的业务工具。
SIMEX 开户申请将客户的 msisdn、poiNumber 和 poaNumber,与 simSerialNo、upcCode、circleId 及证件核验返回的 kycRefId 关联起来。eKYC 结果包含 kycStatus、documentSanity、faceMatchScore、livenessScore 和提取出的 ocrFields。提交响应返回 txnId、serviceRequestId、txnStatus 和 activationDateTime;后续以 txnId 查询订单状态时,另行取得 actStatus、accountSubStatus 和 failureReason。
围绕开户记录,还可取得号码与资费数据:CYN 库存支持按号码模式、价格区间和特殊日期搜索,逐号返回 numberStatus 与 price;套餐目录则按业务大区和连接类型提供 planId、mrp、validityDays 和 dataBenefit。销售后的资金记录同样可以衔接:e-top-up 充值返回 rechargeStatus、walletBalanceAfter 和 commissionAmount;WRR 记录通过 originalTxnId 关联原充值,并提供 wrrStatus、reversedAmountWrr 与 adjustedWalletBalance。钱包将 etopupBalance 与 commissionMtd、lowBalanceThreshold 一并提供,而交易记录按充值、O2C、FRC 和 UPI 等类型列出 paymentStatus、refundStatus、creditTransactionId、debitTransactionId 和 frcTransactionId。携号转入预检还提供 donorOperator、donorCircle、portInExpectedDate 和 upcExpiryDays。
渠道运营团队可在留存开户申请中的 kycRefId 时,一并保存响应返回的 txnId,据此串联 eKYC 结果与后续开户状态,并按每份证件最多开通两个连接的规则核对 poiNumber/poaNumber 的重复使用情况。分销商财务可将 etopupBalance、commissionMtd 与交易借贷参考编号核对,再通过冲正记录的 originalTxnId 找到原充值,将 reversedAmountWrr 纳入对账。门户开发者可同步套餐目录和 CYN 的 numberStatus,携入业务人员则可在采集证件前先检查 eligibilityStatus。openData Studio 将这些 Vi 零售商记录转化为可调用的开放数据,支持上述集成。
应用截图
API 端点一览
请求/响应示例为依据应用界面重构的示意示例,并非实时抓包。
验证零售商身份并签发会话
POST
/v1/vi-smart-connect/session/loginosint验证零售商的手机号码和 MPIN,将会话绑定至已登记的手机,并返回后续功能使用的零售商身份、Vi 业务大区和合作伙伴类型。
认证方式: 无需已有会话。请求体携带零售商的 msisdn、mpin 以及已与门店手机绑定的设备标识符;返回的令牌将在后续每次调用中作为 Bearer 令牌发送。
- msisdn
- mpin
- deviceId
- appVersion
- os
- retailerId
- retailerName
- userType
- circleId
- token
- tokenExpiry
- deviceBound
POST /v1/vi-smart-connect/session/login HTTP/1.1 Content-Type: application/json { "msisdn": "9876543210", "mpin": "4821", "deviceId": "a1b2c3d4e5f6", "appVersion": "9.3.5", "os": "android" }{ "retailerId": "VI-RET-884210", "retailerName": "Ramesh Mobile Store", "userType": "SBA", "circleId": "MH", "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...", "tokenExpiry": "2026-10-26T09:15:00+05:30", "deviceBound": true }核验客户 KYC 证件并进行人脸比对
POST
/v1/vi-smart-connect/activation/ekyc/verifyosint对 Aadhaar、PAN、选民证或护照图像进行 OCR 识别及真实性检查,将证件照片与客户的实时自拍比对,并返回提交开户申请时使用的 KYC 参考编号。
认证方式: 使用登录调用返回的零售商会话 Bearer 令牌及已登记的 deviceId。上传内容包括证件正反面图像和客户实时人脸图像;销售终端须已完成设备绑定。
- docType
- docNumber
- customerName
- dob
- frontImage
- backImage
- faceImage
- deviceId
- kycRefId
- kycStatus
- documentSanity
- faceMatchScore
- livenessScore
- ocrFields
- rejectionReason
POST /v1/vi-smart-connect/activation/ekyc/verify HTTP/1.1 Content-Type: application/json Authorization: Bearer <retailer_token> { "docType": "in.aadhaar", "docNumber": "123456789012", "customerName": "Sunita Sharma", "dob": "14-08-1991", "frontImage": "base64-front", "backImage": "base64-back", "faceImage": "base64-live-face", "deviceId": "a1b2c3d4e5f6" }{ "kycRefId": "KYC-7f21ab", "kycStatus": "VERIFIED", "documentSanity": "OK", "faceMatchScore": 0.94, "livenessScore": 0.91, "ocrFields": { "name": "Sunita Sharma", "dob": "14-08-1991", "gender": "F" }, "rejectionReason": "" }附客户身份及地址证明提交 SIMEX 开户
POST
/v1/vi-smart-connect/activation/simexopenfinance使用已预留的号码、SIM 卡序列号和 UPC 创建新的 Vi 预付费连接,附上客户的身份证明、地址证明及 eKYC 参考编号,并返回 SIMEX 交易编号和服务请求编号。
认证方式: 使用零售商会话 Bearer 令牌,并以零售商 MPIN 确认开户。请求体引用已预留的 CYN 号码、SIM 卡序列号、UPC 和证件核验返回的 kycRefId。
- msisdn
- simSerialNo
- upcCode
- circleId
- connectionType
- customerType
- customerName
- poiType
- poiNumber
- poaType
- poaNumber
- kycRefId
- agentMsisdn
- planId
- mpin
- txnId
- txnStatus
- activationDateTime
- serviceRequestId
- mrp
- validityDays
- dayLimitRemaining
POST /v1/vi-smart-connect/activation/simex HTTP/1.1 Content-Type: application/json Authorization: Bearer <retailer_token> { "msisdn": "9000012345", "simSerialNo": "8991000123456789012", "upcCode": "UPC-884210", "circleId": "MH", "connectionType": "PREPAID", "customerType": "INDIVIDUAL", "customerName": "Sunita Sharma", "poiType": "AADHAAR", "poiNumber": "123456789012", "poaType": "AADHAAR", "poaNumber": "123456789012", "kycRefId": "KYC-7f21ab", "agentMsisdn": "9876543210", "planId": "VI-PRE-299", "mpin": "4821" }{ "txnId": "SIMEX-20261025-004821", "txnStatus": "SUBMITTED", "activationDateTime": "2026-10-25T11:42:16+05:30", "serviceRequestId": "SR-771902", "planId": "VI-PRE-299", "mrp": 299, "validityDays": 28, "dayLimitRemaining": 1 }轮询开户订单状态
GET
/v1/vi-smart-connect/activation/status/{txnId}openfinance返回已提交开户申请的当前状态,包括已开通、处理中或被拒绝,以及号码状态界面使用的 MSISDN、SIM 卡序列号、账户子状态和失败原因。
认证方式: 使用零售商会话 Bearer 令牌;交易须归属已登录零售商的业务大区,并通过查询参数携带 deviceId 留存设备记录。
- txnId
- msisdn
- actStatus
- accountSubStatus
- activationDateTime
- simSerialNo
- serviceRequestId
- failureReason
GET /v1/vi-smart-connect/activation/status/SIMEX-20261025-004821?circleId=MH&deviceId=a1b2c3d4e5f6 HTTP/1.1 Authorization: Bearer <retailer_token>{ "txnId": "SIMEX-20261025-004821", "msisdn": "9000012345", "actStatus": "ACTIVATED", "accountSubStatus": "ACTIVE", "activationDateTime": "2026-10-25T12:05:44+05:30", "simSerialNo": "8991000123456789012", "serviceRequestId": "SR-771902", "failureReason": "" }搜索并预留 CYN 自选号码
GET
/v1/vi-smart-connect/activation/numbersopendata按号码模式、价格区间、特殊日期或号码类型搜索 Vi 的自选号码池,返回号码可用性、逐号价格及预留时限。
认证方式: 使用零售商会话 Bearer 令牌。搜索参数指定业务大区和匹配方式;锁定号码前会检查零售商是否具有预留权限。
- circleId
- searchType
- pattern
- priceBand
- limit
- totalAvailable
- reserveExpiryMinutes
- numbers
- msisdn
- numberStatus
- price
- category
GET /v1/vi-smart-connect/activation/numbers?circleId=MH&searchType=pattern&pattern=98765&priceBand=1500-2500&limit=20 HTTP/1.1 Authorization: Bearer <retailer_token>{ "totalAvailable": 42, "reserveExpiryMinutes": 30, "numbers": [ { "msisdn": "9000098765", "numberStatus": "AVAILABLE", "price": 1800, "category": "SILVER" } ] }获取充值套餐目录
GET
/v1/vi-smart-connect/recharge/plansopendata列出指定业务大区可用的 Vi 资费套餐,包括主套餐、附加包、chillar 小额充值和流量包,并为充值选择界面提供 MRP 标价、有效期及套餐权益。
认证方式: 使用零售商会话 Bearer 令牌;可见套餐按零售商所在业务大区和客户连接类型筛选。
- circleId
- connectionType
- planCategory
- totalCount
- plans
- planId
- mrp
- talktime
- validityDays
- dataBenefit
- smsBenefit
- description
GET /v1/vi-smart-connect/recharge/plans?circleId=MH&connectionType=PREPAID&planCategory=ADDON HTTP/1.1 Authorization: Bearer <retailer_token>{ "totalCount": 2, "plans": [ { "planId": "VI-PRE-299", "mrp": 299, "talktime": 0, "validityDays": 28, "dataBenefit": "1.5GB/day", "smsBenefit": "100 SMS/day", "planCategory": "MAIN", "description": "Unlimited calls + 1.5GB/day" }, { "planId": "VI-ADD-49", "mrp": 49, "validityDays": 0, "dataBenefit": "3GB", "planCategory": "ADDON", "description": "Data add-on" } ] }执行 e-top-up 电子充值
POST
/v1/vi-smart-connect/recharge/etopupopenfinance从零售商的 e-top-up 钱包扣除套餐 MRP 标价,为客户的预付费号码充值,并返回交易编号、充值后钱包余额、GST 税额及本次佣金。
认证方式: 使用零售商会话 Bearer 令牌和确认对话框中输入的零售商 MPIN;钱包余额须足以支付 MRP 标价,请求还携带设备及位置信息。
- retailerMsisdn
- customerMsisdn
- planId
- rechargeAmount
- mrp
- connectionType
- mpin
- latitude
- longitude
- txnId
- rechargeStatus
- validityDays
- walletBalanceAfter
- commissionAmount
- gstAmount
- rechargeDateTime
POST /v1/vi-smart-connect/recharge/etopup HTTP/1.1 Content-Type: application/json Authorization: Bearer <retailer_token> { "retailerMsisdn": "9876543210", "customerMsisdn": "9810012345", "planId": "VI-PRE-299", "rechargeAmount": 299, "mrp": 299, "connectionType": "PREPAID", "mpin": "4821", "latitude": "19.0760", "longitude": "72.8777" }{ "txnId": "RCH-20261025-118842", "rechargeStatus": "SUCCESS", "mrp": 299, "validityDays": 28, "walletBalanceAfter": 18151.75, "commissionAmount": 9.57, "gstAmount": 45.61, "rechargeDateTime": "2026-10-25T12:31:08+05:30" }申请错号充值冲正(WRR)
POST
/v1/vi-smart-connect/recharge/wrropenfinance申请撤销充错号码的充值交易,返回 WRR 参考编号、冲正金额和调整后的钱包余额,同时受每日次数及金额上限约束。
认证方式: 使用零售商会话 Bearer 令牌及零售商 MPIN。原充值须属于同一零售商,并满足应用规定的每日一次 WRR 及金额限制。
- originalTxnId
- msisdn
- rechargeAmount
- wrrReason
- mpin
- wrrId
- wrrStatus
- reversedAmountWrr
- adjustedWalletBalance
- requestDate
- rejectionReason
POST /v1/vi-smart-connect/recharge/wrr HTTP/1.1 Content-Type: application/json Authorization: Bearer <retailer_token> { "originalTxnId": "RCH-20261025-118842", "msisdn": "9810012345", "rechargeAmount": 299, "wrrReason": "WRONG_NUMBER", "mpin": "4821" }{ "wrrId": "WRR-20261025-7712", "wrrStatus": "REVERSED", "reversedAmountWrr": 299, "adjustedWalletBalance": 18450.75, "requestDate": "2026-10-25T12:40:11+05:30", "rejectionReason": "" }获取零售商 e-top-up 钱包余额
GET
/v1/vi-smart-connect/wallet/balanceopenbanking返回零售商实时的 e-top-up 充值备付金、可用余额、本月至今累计佣金、利润率,以及钱包卡片显示的低余额阈值。
认证方式: 使用零售商会话 Bearer 令牌;查询范围限定为已登录零售商的 MSISDN 及其登记设备。
- retailerMsisdn
- etopupBalance
- availableBalance
- commissionMtd
- margin
- lowBalanceThreshold
- currency
- walletUpdatedAt
GET /v1/vi-smart-connect/wallet/balance?retailerMsisdn=9876543210 HTTP/1.1 Authorization: Bearer <retailer_token>{ "retailerMsisdn": "9876543210", "etopupBalance": 18450.75, "availableBalance": 18151.75, "commissionMtd": 12840.5, "margin": 3.2, "lowBalanceThreshold": 500.0, "currency": "INR", "walletUpdatedAt": "2026-10-25T12:31:08+05:30" }列出零售商交易与退款记录
GET
/v1/vi-smart-connect/transactionsopenbanking分页返回零售商的综合交易历史,包括应用充值、O2C、FRC 和 UPI 记录,并列出金额、支付状态、失败原因、退款状态及借贷参考编号。
认证方式: 使用零售商会话 Bearer 令牌;筛选范围限定为当前零售商,并接受交易类型、日期区间和分页游标。
- txnType
- fromDate
- toDate
- page
- size
- totalCount
- transactions
- txnId
- amount
- paymentStatus
- paymentDate
- customerMsisdn
- failureReason
- refundStatus
- refundAmount
- creditTransactionId
- debitTransactionId
- otcTransactionId
- frcTransactionId
GET /v1/vi-smart-connect/transactions?txnType=ALL&fromDate=2026-10-01&toDate=2026-10-25&page=1&size=20 HTTP/1.1 Authorization: Bearer <retailer_token>{ "totalCount": 1, "page": 1, "size": 20, "transactions": [ { "txnId": "RCH-20261025-118842", "txnType": "RECHARGE", "amount": 299, "paymentStatus": "SUCCESS", "paymentDate": "2026-10-25T12:31:08+05:30", "customerMsisdn": "9810012345", "failureReason": "", "refundStatus": "NOT_APPLICABLE", "refundAmount": 0, "creditTransactionId": "CR-77102", "debitTransactionId": "DR-77103", "otcTransactionId": "", "frcTransactionId": "FRC-4411" } ] }通过 UPI 收款请求为钱包充值
POST
/v1/vi-smart-connect/upi/collectopenbanking向零售商的 VPA 发起 UPI 收款请求,为 e-top-up 钱包补充资金,先返回待处理交易编号,随后结算时附上支付批准参考号。
认证方式: 使用零售商会话 Bearer 令牌及零售商 MPIN。支付异步完成:门店须先在其 UPI 应用中批准收款请求,资金才会记入钱包。
- retailerMsisdn
- upiAddress
- amount
- remarks
- mpin
- deviceId
- txnId
- paymentStatus
- vpa
- approvalRefNo
- initiatedAt
POST /v1/vi-smart-connect/upi/collect HTTP/1.1 Content-Type: application/json Authorization: Bearer <retailer_token> { "retailerMsisdn": "9876543210", "upiAddress": "ramesh.store@okhdfcbank", "amount": 5000, "remarks": "E-topup float", "mpin": "4821", "deviceId": "a1b2c3d4e5f6" }{ "txnId": "UPI-20261025-55210", "paymentStatus": "IN_PROGRESS", "vpa": "ramesh.store@okhdfcbank", "amount": 5000, "approvalRefNo": "", "initiatedAt": "2026-10-25T12:52:39+05:30" }携入前检查 MNP 携号转网资格
GET
/v1/vi-smart-connect/mnp/eligibilityosint检查号码能否转入 Vi,在提交携入申请前返回原运营商及业务大区、企业客户相关提示、预计携入日期和 UPC 有效期限。
认证方式: 使用零售商会话 Bearer 令牌;查询时须提供号码及其原运营商业务大区,结果反映该大区当前适用的携号转网规则。
- msisdn
- donorCircle
- donorOperator
- eligibilityStatus
- corporateCustomer
- portInExpectedDate
- upcRequired
- upcExpiryDays
- rejectionReason
GET /v1/vi-smart-connect/mnp/eligibility?msisdn=9810012345&donorCircle=DL HTTP/1.1 Authorization: Bearer <retailer_token>{ "msisdn": "9810012345", "donorOperator": "AIRTEL", "donorCircle": "DL", "eligibilityStatus": "ELIGIBLE", "corporateCustomer": false, "portInExpectedDate": "2026-10-29", "upcRequired": true, "upcExpiryDays": 4, "rejectionReason": "" }
数据类别
- 零售商身份与设备绑定
- SIM 卡开户与 eKYC 记录
- CYN 自选号码库存
- 资费与套餐目录
- 充值与 WRR 冲正交易
- 零售商 e-top-up 钱包
- 佣金与利润率
- 交易账本与退款
- UPI 结算
- MNP 携号转网资格
数据使用场景与案例
开户合规核对
使用 SIMEX 提交记录中的 txnId 和 kycRefId 关联 eKYC 结果与开户状态记录,在业务大区合规核查前,按每份证件最多开通两个连接的规则核对 poiNumber/poaNumber 的重复使用情况。
分销商备付金与佣金对账
将钱包的 etopupBalance 和 commissionMtd 与交易记录中的 debitTransactionId、creditTransactionId 及 reversedAmountWrr 对应记录匹配,完成各零售商每日充值备付金结算。
门店套餐及号码数据同步
将业务大区套餐目录和 CYN 号码可用性,包括 planId、mrp、validityDays、numberStatus 和 price,同步到分销商门户,供网点展示当前 Vi 资费及自选号码报价。
携号转入预检流程
查询 MNP 资格,核对 donorOperator、donorCircle 和 portInExpectedDate,仅为符合条件的号码继续处理 UPC 与客户证件,减少携入申请被拒绝的情况。
常见问题
哪些标识符可将 Vi 开户记录与 KYC 及充值记录关联?
证件核验返回 kycRefId,SIMEX 申请将其与 msisdn、upcCode 和 simSerialNo 一并提交。集成时需保存请求与响应之间的映射:SIMEX 返回 txnId 和 serviceRequestId,状态查询使用 txnId。充值结果有独立的 txnId,交易历史记录提供用于钱包对账的 creditTransactionId 和 debitTransactionId。此处列出的字段未提供从开户到充值的直接关联外键。
零售商钱包提供哪些信息?
钱包响应同时提供 etopupBalance、availableBalance、commissionMtd、margin 和 lowBalanceThreshold,货币为 INR,与应用 e-top-up 余额卡片展示的数值一致。
如何追踪错号充值的处理情况?
WRR 请求引用 originalTxnId,结果提供 wrrId、wrrStatus、reversedAmountWrr 和 adjustedWalletBalance,拒绝时由 rejectionReason 说明原因。应检查 wrrStatus,而非默认每次申请都能成功。每日规则为同一正确号码只允许一笔 WRR 交易,同时还受次数及金额上限约束。
提交前可用哪些字段了解携号转入情况?
资格查询返回 donorOperator、donorCircle、eligibilityStatus、portInExpectedDate、upcRequired 和 upcExpiryDays,并提供识别企业客户的 corporateCustomer 及说明资格检查失败原因的 rejectionReason;企业客户标志本身并未定义另一套携入流程。
与 Smart-Connect 相似的应用
- Mitra — Mitra 是 Bharti Airtel 面向印度预付费渠道的零售商应用,分销商和社区门店通过 LAPU 电子充值钱包为客户充值、用 mPIN 确认销售 R-offer,并办理新连接开户。
- Spice Money — Spice Money 是面向印度社区代理的辅助银行平台,在一个应用里提供基于 Aadhaar 的 AePS 取现、存款和余额查询、国内汇款,以及手机充值和账单支付。
- PayNearby — PayNearby 是 Nearby Technologies 面向印度商业代理零售商的应用,供杂货店柜台办理基于 Aadhaar 的 AePS 取现与存款、国内汇款、BBPS 账单支付和预付费手机充值。
- Mobirec — Mobirec 是面向印度杂货店柜台的独立多运营商充值应用,零售商按电信业务大区销售 Jio、Airtel 和 Vi 充值,以及 DTH 套餐和 BBPS 账单,钱包通过 UPI 补充资金。
- Airtel Thanks — Airtel Thanks 是 Bharti Airtel 的用户端应用,用户可在一次登录中为预付费号码充值,缴纳后付费、宽带和 DTH 账单,并使用 Airtel Payments Bank、UPI 和奖励权益。
- MyJio — MyJio 是 Reliance Jio 面向预付费用户的自助服务应用,用户可浏览不限量 4G 和 5G 流量套餐,并在线购买预付费充值包。
- Vi App — Vi App 是 Vodafone Idea 自己的用户端应用,预付费用户可办理充值、浏览不限量和流量套餐、订购新 SIM 卡,并在不更换号码的情况下携号转入 Vi。
相关主题
- Vi Smart-Connect API
- Vodafone Idea 零售商 API
- SIMEX 开户 API
- Vi eKYC 数据
- CYN 自选号码库存
- Vi 充值 API
- 零售商钱包余额
- MNP 携号转网资格 API
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业