openData StudioEnglish
Mitra 图标

Mitra 零售商数据 API：钱包、充值与台账端点

Product Engg · 电信

在 Google Play 中打开

Mitra 是 Bharti Airtel 面向印度预付费手机零售市场的零售商应用，使用者是在 Airtel 各电信圈内代售充值的分销商和街边店主。零售商用手机号加短信 OTP 登录，首页围绕 LAPU（本地预付费单元）电子充值钱包及其低余额提醒展开：他们为客户的预付费号码充值 Airtel R-offer 套餐并以 mPIN 确认，办理新号开通，并在“我的交易”界面按客户号码、代理和日期范围查询每笔销售。收入看板按产品线展示当日与当月累计收益——LAPU 收入、R-offer 佣金、一次性费用（OTF）佣金与活动方案奖励；LAPU 现金台账则按天列出每一笔入账与扣款及其前后余额。每位零售商都对接一名负责钱包补款的 Airtel 外勤销售专员；在店铺柜台上，它与 Jio 的 JioPOS Lite、Vodafone Idea 的 Smart-Connect，以及 Spice Money、PayNearby 等多运营商代理平台争夺同一批零售点。

R-offer 充值在 Mitra 柜台成交后，都会写入一串相互关联的零售财务记录。一笔充值携带用户的 customerNumber、所选的 offerId 与 price、gst 税额、rechargeType 与 connectionType、零售商所在的 retailerCircle 以及门店的 latitude/longitude，并返回 transactionId、refTransactionNumber、售后的 accountBalance，以及服务该零售商的外勤销售专员的 fseNumber。

围绕它的是钱包与收益记录：钱包把 currentBalance 与低余额阈值 thresholdBalance 配对；收益以当日与当月累计（totalFtd、totalMtd）给出，并拆分为 lapuIncomeResponse、rOfferCommissionResponse、otfCommissionResponse 与 schemeRelatedCommissionResponses。充值历史逐笔分页记录 totalAmount、customerMobileNumber、transactionStatus、transactionDateTime 与经手的 agentName；LAPU 现金台账按日期归组 ledgerTransactions，每行带有 transactionType、senderMsisdn、senderCircle、preBalance、postBalance 与 isCredit 借贷标记。零售商身份以 userIdentifier 中的手机号为键，因此钱包、收益、历史与台账都能按同一个零售商号码关联。

这让这些记录可以直接接入分销商与合作方财务工具：ERP 可每晚把 currentBalance 与台账最后一条 postBalance 比对，在开店前标记缺失的入账；佣金结算看板可用 lapuIncomeMtd 与 rOfferCommissionResponse.mtd 按产品线对比 FTD 与 MTD 收益；客服在用户投诉充值失败时，可按客户号码与 startDate/endDate 日期窗口检索，再以 transactionId 关联充值结果；补货提醒则在 currentBalance 低于 thresholdBalance 时通知外勤销售专员。openData Studio 把 Mitra 的零售商钱包、佣金、充值与 LAPU 台账记录变为可调用的开放数据，供这些集成使用。

应用截图

  • Mitra 应用截图 1
  • Mitra 应用截图 2
  • Mitra 应用截图 3
  • Mitra 应用截图 4
  • Mitra 应用截图 5
  • Mitra 应用截图 6

API 端点一览

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

  • 校验零售商 OTP 并签发会话

    POST /v1/auth/otp/verify osint

    确认零售商手机号的短信 OTP，并返回会话令牌 / 用户令牌对，供后续钱包、收入、充值与台账请求携带。

    认证方式： 无前置会话。请求体携带零售商手机号、短信 OTP 与发送 OTP 步骤返回的 otpToken，外加 deviceId / application / appVersion。返回的会话令牌与用户令牌会附加到之后每个登录调用。

    • action
    • userIdentifier
    • otp
    • otpToken
    • isOtpThirdParty
    • deviceId
    • application
    • appVersion
    • userAgent
    • result
    • userToken
    • tokenId
    • status
    • message
    POST /v1/auth/otp/verify HTTP/1.1
Content-Type: application/json

{
  "action": "consumeAPI",
  "userIdentifier": "9876543210",
  "otp": "482913",
  "otpToken": "otp-tok-9f2a",
  "isOtpThirdParty": "0",
  "deviceId": "a1b2c3d4e5f6",
  "application": "Retailer",
  "appVersion": "635",
  "userAgent": "android"
}
    {
  "result": {
    "deviceId": "a1b2c3d4e5f6",
    "userIdentifier": "9876543210",
    "userToken": "usr-tok-7c11",
    "tokenId": "sess-4e90ab"
  },
  "status": {
    "status": "SUCCESS",
    "message": "OTP verified"
  }
}

  • 查询零售商钱包余额

    POST /v1/retailers/wallet openbanking

    返回零售商的实时预付费 / LAPU 钱包余额，以及 Mitra 首页展示的低余额阈值。

    认证方式： 来自 OTP 校验调用的会话令牌，与零售商手机号、deviceId 一起在会话信封中发送。

    • token
    • currentBalance
    • thresholdBalance
    • status
    • message
    POST /v1/retailers/wallet HTTP/1.1
Content-Type: application/json

{
  "action": "consumeAPI",
  "userIdentifier": "9876543210",
  "tokenID": "sess-4e90ab",
  "deviceId": "a1b2c3d4e5f6",
  "application": "Retailer",
  "appVersion": "635",
  "userAgent": "android",
  "additionalRequestParams": {
    "token": "sess-4e90ab"
  }
}
    {
  "responseObject": {
    "currentBalance": 18450.75,
    "thresholdBalance": 500.0
  },
  "status": {
    "status": "SUCCESS",
    "message": "Balance fetched"
  }
}

  • 查询零售商收入与佣金

    POST /v1/retailers/earnings openfinance

    返回当月累计与当日累计的零售商收入，按 LAPU 收入、R-offer 佣金、OTF 佣金与活动方案奖励拆分。

    认证方式： 来自 OTP 校验调用的会话令牌，与零售商手机号、deviceId 一起在会话信封中发送。

    • token
    • totalMtd
    • totalFtd
    • lapuIncomeResponse
    • lapuIncomeMtd
    • lapuIncomeFtd
    • lapuIncome
    • rOfferCommissionResponse
    • mtd
    • ftd
    • amount
    • transactionId
    • date
    • otfCommissionResponse
    • schemeRelatedCommissionResponses
    POST /v1/retailers/earnings HTTP/1.1
Content-Type: application/json

{
  "action": "consumeAPI",
  "userIdentifier": "9876543210",
  "tokenID": "sess-4e90ab",
  "deviceId": "a1b2c3d4e5f6",
  "application": "Retailer",
  "appVersion": "635",
  "additionalRequestParams": {
    "token": "sess-4e90ab"
  }
}
    {
  "responseObject": {
    "totalMtd": 12840.5,
    "totalFtd": 960.0,
    "lapuIncomeResponse": {
      "lapuIncomeMtd": 4100.0,
      "lapuIncomeFtd": 250.0,
      "lapuIncome": 4100.0
    },
    "rOfferCommissionResponse": {
      "mtd": 6200.0,
      "ftd": 480.0,
      "amount": 6200.0,
      "transactionId": 88421109,
      "date": "2026-09-26"
    },
    "otfCommissionResponse": {
      "mtd": 2540.5,
      "ftd": 230.0
    },
    "schemeRelatedCommissionResponses": []
  },
  "status": {
    "status": "SUCCESS",
    "message": "OK"
  }
}

  • 列出历史充值交易

    POST /v1/transactions/search openbanking

    分页返回零售商的充值历史，包含金额、客户手机号、代理、时间戳与成功 / 失败状态，供“我的交易”界面使用。

    认证方式： 来自 OTP 校验调用的会话令牌。请求体还携带 pageNumber、size、可选的 customerNumber / agentNumber 以及 startDate-endDate 时间窗口。

    • token
    • pageNumber
    • size
    • customerNumber
    • startDate
    • endDate
    • agentNumber
    • statusCode
    • statusDesc
    • isWLREnabled
    • totalSize
    • lastFiveTransactionDetails
    • totalAmount
    • customerMobileNumber
    • transactionId
    • transactionStatus
    • transactionDateTime
    • wlrtransaction
    • agentName
    • agentNumber
    POST /v1/transactions/search HTTP/1.1
Content-Type: application/json

{
  "token": "sess-4e90ab",
  "pageNumber": "1",
  "size": "20",
  "customerNumber": "9810012345",
  "startDate": "2026-09-01",
  "endDate": "2026-09-26",
  "agentNumber": "9890011122"
}
    {
  "responseObject": {
    "statusCode": "200",
    "statusDesc": "SUCCESS",
    "isWLREnabled": "Y",
    "totalSize": 2,
    "lastFiveTransactionDetails": [
      {
        "totalAmount": "299.00",
        "customerMobileNumber": "9810012345",
        "transactionId": "TXN88421109",
        "transactionStatus": "SUCCESS",
        "transactionDateTime": "2026-09-26 10:14:03",
        "wlrtransaction": false,
        "wlrtransactionStatus": 0,
        "agentName": "Ramesh",
        "agentNumber": "9890011122"
      }
    ],
    "transactionStatusResponses": []
  }
}

  • 下单 R-offer 充值

    POST /v1/recharge/subscribe openfinance

    使用零售商钱包执行一笔预付费 R-offer 充值，在 mPIN 确认后返回新的 accountBalance 与 transactionId。

    认证方式： 来自 OTP 校验调用的会话令牌。请求体还需要零售商 mPIN 以及 retailerNumber / customerNumber / offerId / price。

    • retailerNumber
    • customerNumber
    • offerId
    • price
    • mpin
    • rechargeType
    • channelId
    • retailerCircle
    • connectionType
    • gst
    • latitude
    • longitude
    • httpStatus
    • responseMessage
    • transactionId
    • refTransactionNumber
    • chillarAmount
    • gstText
    • accountBalance
    • fseNumber
    POST /v1/recharge/subscribe HTTP/1.1
Content-Type: application/json

{
  "retailerNumber": "9876543210",
  "customerNumber": "9810012345",
  "offerId": "ROFFER_299",
  "price": "299",
  "mpin": "2580",
  "rechargeType": "PREPAID",
  "channelId": "MITRA",
  "retailerCircle": "DL",
  "connectionType": "PREPAID",
  "gst": "53.82",
  "latitude": "28.6139",
  "longitude": "77.2090"
}
    {
  "httpStatus": "200",
  "status": {
    "status": "SUCCESS",
    "message": "Recharge successful"
  },
  "responseObject": {
    "responseMessage": "Recharge of INR 299 successful",
    "transactionId": "TXN88421109",
    "refTransactionNumber": "REF772190",
    "chillarAmount": "0",
    "gstText": "Incl. GST",
    "retailerAccountBalanceAndFSEDetails": {
      "accountBalance": "18151.75",
      "fseNumber": "FSE44021"
    }
  }
}

  • 查询 LAPU 台账流水

    POST /v1/ledger/entries openbanking

    按日期分组返回 LAPU 台账流水，包含金额、付款方手机号、preBalance/postBalance 与借贷标记，供零售商现金台账使用。

    认证方式： 来自 OTP 校验调用的会话令牌。过滤条件为零售商手机号加可选的 startDate/endDate 与交易类型；pageParams 携带 pageState/pageOffset。

    • filterParams
    • retailerMsisdn
    • startDate
    • endDate
    • queryParam
    • parentTransactionTypeId
    • pageParams
    • pageState
    • pageOffset
    • ledgerTransactions
    • transactionId
    • amount
    • channel
    • senderCircle
    • senderMsisdn
    • transactionDateTime
    • transactionType
    • retailerCircle
    • preBalance
    • postBalance
    • isCredit
    • note
    • status
    POST /v1/ledger/entries HTTP/1.1
Content-Type: application/json

{
  "filterParams": {
    "retailerMsisdn": "9876543210",
    "startDate": "2026-09-01",
    "endDate": "2026-09-26",
    "queryParam": "",
    "parentTransactionTypeId": "RECHARGE"
  },
  "pageParams": {
    "pageState": null,
    "pageOffset": 0
  }
}
    {
  "httpStatus": "200",
  "status": {
    "status": "SUCCESS",
    "message": "OK"
  },
  "body": {
    "pageState": "eyJvIjoxMH0",
    "ledgerTransactions": {
      "2026-09-26": [
        {
          "transactionId": "LED99102",
          "amount": "299.00",
          "channel": "MITRA",
          "senderCircle": "DL",
          "senderMsisdn": "9810012345",
          "transactionDateTime": "2026-09-26 10:14:03",
          "transactionType": "RECHARGE",
          "retailerMsisdn": "9876543210",
          "retailerCircle": "DL",
          "status": "SUCCESS",
          "preBalance": "18450.75",
          "postBalance": "18151.75",
          "isCredit": false,
          "note": "R-offer 299"
        }
      ]
    }
  }
}

数据类别

  • 零售商身份
  • 钱包余额
  • 佣金
  • 充值交易
  • LAPU 台账

数据使用场景与案例

  • LAPU 钱包夜间对账

    从钱包接口拉取 currentBalance，并与台账流水接口中最后一条 postBalance 比对，让 ERP 能在开店前标记缺失的入账。

  • 佣金结算看板

    读取收入接口的 totalMtd、lapuIncomeMtd 与 rOfferCommissionResponse.mtd，按产品线构建合作方财务视图，对比 FTD 与 MTD 收入。

  • 充值争议查询

    按 customerNumber 与 startDate/endDate 查询交易搜索接口，再用 transactionId 关联充值下单结果，处理用户反馈的充值失败。

  • 低余额补货提醒

    每次充值下单后比较 currentBalance 与 thresholdBalance，当零售商钱包需要补款时通知外勤销售代理（fseNumber）。

常见问题

Mitra 登录后会携带哪些会话字段？

OTP 校验调用为零售商手机号（userIdentifier）返回会话令牌与用户令牌。之后的调用把它们与设备 id、应用标识和版本号一起包在同一个会话信封里。

哪个端点返回零售商钱包？

POST /v1/retailers/wallet 返回 currentBalance 与 thresholdBalance。充值完成后，下单接口还会回显 accountBalance 与外勤销售代理编号（fseNumber）。

佣金如何拆分？

POST /v1/retailers/earnings 返回当日与当月累计总额，以及按产品线嵌套的 LAPU 收入、优惠佣金与一次性费用佣金对象。

LAPU 现金台账在哪里？

POST /v1/ledger/entries 按日期分组分页返回台账流水，包含金额、付款方手机号、preBalance、postBalance 与借贷标记。

与 Mitra 相似的应用

  • JioPOS Lite — JioPOS Lite 是 Reliance Jio 的合作伙伴应用，个人可在其中成为 Jio 代理，用钱包给 Jio 用户充值，并查看收益看板与存折。
  • Smart-Connect — Smart-Connect 是 Vodafone Idea 面向 Vi 渠道商的零售应用，用于 Vi 网络上的充值、开户及相关零售活动。
  • Spice Money — Spice Money 的 Adhikari 代理应用可对所有运营商做即时话费充值，并在店内办理缴费、取现和汇款。
  • Paytm — Paytm 是印度支付应用，也提供 Airtel、Jio、Vi、BSNL 和 MTNL 的预付费充值与后付费话费缴纳。
  • PayNearby — PayNearby 面向杂货店等零售点，可在店内办理手机和 DTH 充值、公用事业缴费以及 Aadhaar 相关取现服务。

更多电信类应用

相关主题

  • Mitra API
  • Airtel 零售商 API
  • LAPU 台账
  • 零售商钱包余额
  • R-offer 充值
  • Mitra 佣金
  • airtel mitra 端点

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

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

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

获取报价