Mobile Recharge Commission App 图标

Mobirec 零售商钱包、充值与佣金接口

Mobirec Private Limited · 电信

Mobile Recharge Commission App(对外品牌 Mobirec)是 Mobirec Private Limited 面向印度街角充值柜台的多运营商零售客户端。店主用手机号加短信 OTP 登录后,按电信圈区出售 Jio/Airtel/Vi 预付费、DTH 套餐、BBPS 公用事业账单,以及经 Hubble 接入的 Amazon、Flipkart、Swiggy 等品牌券;周转金放在首页钱包、通过 UPI 加款。Margin 页列出各运营商佣金,报表覆盖充值、台账与加款流水,PAN KYC 与强制 Gmail/邮编资料是开通柜台的门槛。它和 Airtel Mitra、JioPOS Lite、PayNearby 抢同一批烟杂店,但是独立的多运营商佣金应用,而不是单家运营商的 LAPU 钱包。

零售商周转金落在登录会话的 balance 与 ub 上,amSys 控制是否开放加款,utilityUse 记录能否做 BBPS 扣款。预付费结账携带 rcNumber、rcOperator、rcCircle 以及套餐行的 rs、validity、data;佣金板展示各运营商的 commissions[].margin 与 margin_type。

未结 BBPS 与 DTH 账单先给出 customerName、dueDate、billDate 与 refId,随后结账写入 txnId 与 optRef。台账与充值报表在 from/to 日期之间分页返回这些行的 amount、profit 与 status;PAN KYC 提交 pan 加 name 并返回轮换后的 token。报表卡片给出 todaySale/todayProfite 对照 totalSale,推荐板用 qualifiedReferred 对照 next_milestone。分销商、佣金引擎与店铺 ERP 用这套字段对账周转金、比较运营商佣金并匹配 BBPS 回单——openData Studio 把它变成可调用的开放数据。

应用截图

  • Mobile Recharge Commission App 应用截图 1
  • Mobile Recharge Commission App 应用截图 2
  • Mobile Recharge Commission App 应用截图 3
  • Mobile Recharge Commission App 应用截图 4
  • Mobile Recharge Commission App 应用截图 5
  • Mobile Recharge Commission App 应用截图 6

API 端点一览

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

  • 请求零售商登录 OTP

    POST /v1/session/otp/request osint

    为零售商手机号发起短信 OTP 登录,并可附带安装/深链带来的推荐码。

    认证方式: 无前置会话。手机号经 RSA/AES 封装为 hashKey;设备上的短信 OTP 监听器在确认步骤填入验证码。

    • hashKey
    • phone
    • ref
    • response
    • message
    POST /v1/session/otp/request HTTP/1.1
    Content-Type: application/json
    
    {
      "hashKey": "<rsa-aes phone+ref>"
    }
    {
      "response": true,
      "message": "OTP sent",
      "data": {
        "phone": "9876543210",
        "ref": "MRC8K2"
      }
    }
  • 校验 OTP 并签发会话令牌

    POST /v1/session/otp/confirm osint

    确认短信 OTP,返回会话令牌,写入 token cookie,并在后续 API 调用中以 token 请求头携带。

    认证方式: 无前置会话。请求体携带手机号与 OTP 的 hashKey;返回的 token 写入 cookie 并以 token 请求头用于后续调用。

    • hashKey
    • phone
    • otp
    • token
    • user
    • status
    • name
    • response
    POST /v1/session/otp/confirm HTTP/1.1
    Content-Type: application/json
    
    {
      "hashKey": "<rsa-aes phone+otp>"
    }
    {
      "response": true,
      "token": "<sessionToken>",
      "user": {
        "phone": "9876543210",
        "status": "Verified",
        "name": "Ravi Sharma"
      }
    }
  • 读取零售商钱包余额

    POST /v1/wallet/balance openbanking

    返回首页钱包卡片上的实时柜台余额:主余额、未占用/冻结桶、BBPS 扣款开关,以及是否开放加款。

    认证方式: 短信 OTP 校验后签发的 token 请求头,可经会话刷新轮换。

    • balance
    • ub
    • utilityUse
    • amSys
    • response
    POST /v1/wallet/balance HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": {
        "balance": "18450.75",
        "ub": "1200.00",
        "utilityUse": true,
        "amSys": 1
      }
    }
  • 获取已登录零售商资料

    POST /v1/retailer/profile osint

    加载应用作为门槛的零售商身份:Verified 状态、Gmail、性别以及开通柜台前使用的邮编地址。

    认证方式: OTP 校验签发的 token 请求头。status 非 Verified 会跳到身份核验页。

    • name
    • email
    • gender
    • phone
    • status
    • pin
    • city
    • dist
    • state
    • address
    • response
    POST /v1/retailer/profile HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": {
        "name": "Ravi Sharma",
        "email": "[email protected]",
        "gender": "male",
        "phone": "9876543210",
        "status": "Verified",
        "pin": "110001",
        "city": "Connaught Place",
        "dist": "New Delhi",
        "state": "Delhi",
        "address": "Connaught Place, New Delhi, Delhi - 110001"
      }
    }
  • 更新零售商资料并完成注册

    POST /v1/retailer/profile/save osint

    写入强制引导资料(仅 Gmail 邮箱、由邮编解析的城市/区/邦),并在 status 变为 Verified 时可能轮换会话令牌。

    认证方式: token 请求头。multipart 表单含 name/email/gender/ref/pin/city/dist/state/address。

    • name
    • email
    • gender
    • ref
    • pin
    • city
    • dist
    • state
    • address
    • token
    • user
    • status
    • message
    • response
    POST /v1/retailer/profile/save HTTP/1.1
    token: <sessionToken>
    Content-Type: multipart/form-data
    
    name=Ravi Sharma&[email protected]&gender=male&ref=MRC8K2&pin=110001&city=Connaught Place&dist=New Delhi&state=Delhi&address=Connaught Place, New Delhi, Delhi - 110001
    {
      "response": true,
      "message": "Profile verified successfully!",
      "data": {
        "token": "<sessionToken>",
        "user": {
          "status": "Verified",
          "name": "Ravi Sharma",
          "email": "[email protected]"
        }
      }
    }
  • 按邮编解析邮局地址

    GET /v1/geo/postcode osint

    把 6 位邮编解析成邮局 Name/District/State,供强制资料表在提交保存前填入 city、dist、state 与 address。

    认证方式: 无需会话的同源查询。查询参数 pin 为 6 位邮编;未命中时回退到印度邮政公开邮编目录。

    • pin
    • success
    • data
    • Name
    • District
    • State
    • Pincode
    GET /v1/geo/postcode?pin=110001 HTTP/1.1
    Accept: application/json
    {
      "success": true,
      "data": [
        {
          "Name": "Connaught Place",
          "District": "New Delhi",
          "State": "Delhi",
          "Pincode": "110001"
        }
      ]
    }
  • 列出运营商与佣金档位

    POST /v1/catalog/operators/{serviceId}/{page} opendata

    返回 Margin 页渲染的按服务运营商目录,含每个运营商以百分比或固定额表示的佣金档。

    认证方式: token 请求头。serviceId 来自首页服务目录,page 默认 0。

    • id
    • name
    • icon
    • operators
    • commissions
    • margin_type
    • margin
    • response
    POST /v1/catalog/operators/prepaid/0 HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": [
        {
          "id": "jio",
          "name": "Jio",
          "operators": [
            {
              "id": "jio-in",
              "name": "Reliance Jio",
              "icon": "https://cdn.example.com/icons/jio.svg",
              "commissions": [
                {
                  "margin_type": "Percent",
                  "margin": "2.40"
                }
              ]
            }
          ]
        }
      ]
    }
  • 搜索预付费充值套餐

    POST /v1/plans/search opendata

    按圈区返回该手机号的预付费套餐(roffer=yes 时含 R-offer 行),供零售商在结账前选择 rs/validity/data。

    认证方式: token 请求头。套餐按手机号、运营商与圈区过滤。

    • hashData
    • number
    • circle
    • operator
    • roffer
    • rcNumber
    • rcOperator
    • rcCircle
    • rs
    • desc
    • validity
    • data
    • sms
    • response
    POST /v1/plans/search HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes number+circle+operator+roffer>"
    }
    {
      "response": true,
      "data": {
        "rcNumber": "9876543210",
        "rcOperator": "Jio",
        "rcCircle": "Delhi NCR",
        "plans": [
          {
            "rs": "299",
            "desc": "2GB/day + unlimited calls",
            "validity": "28 days",
            "data": "2 GB/day",
            "sms": "100/day"
          }
        ]
      }
    }
  • 校验所选预付费套餐

    POST /v1/plans/validate opendata

    确认所选套餐金额对该手机号、运营商与电信圈区有效,然后才进入充值结账。

    认证方式: token 请求头。校验 number/circle/operator/amount 组合是否可售。

    • hashData
    • number
    • circle
    • operator
    • amount
    • message
    • response
    POST /v1/plans/validate HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes number+circle+operator+amount>"
    }
    {
      "response": true,
      "message": "Plan verified",
      "data": {
        "number": "9876543210",
        "circle": "Delhi NCR",
        "operator": "Jio",
        "amount": 299
      }
    }
  • 识别预付费运营商与圈区

    POST /v1/plans/lookup-operator opendata

    查询该手机号归属运营商与电信圈区,供预付费抽屉在套餐列表加载前预选 rcOperator/rcCircle。

    认证方式: token 请求头。手机号封装为 hashData。

    • hashData
    • phone
    • Number
    • Operator
    • Circle
    • response
    POST /v1/plans/lookup-operator HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes phone>"
    }
    {
      "response": true,
      "data": {
        "Number": "9876543210",
        "Operator": "Jio",
        "Circle": "Delhi NCR"
      }
    }
  • 列出预付费电信圈区

    POST /v1/plans/circles opendata

    返回预付费圈区名称列表,圈区抽屉用它去匹配运营商查询返回的 Circle 字符串。

    认证方式: token 请求头。返回圈区名称列表供抽屉匹配。

    • circleList
    • Circle
    • response
    POST /v1/plans/circles HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    [
      "Delhi NCR",
      "Mumbai",
      "Kolkata",
      "Maharashtra",
      "Tamil Nadu"
    ]
  • 提交预付费、DTH 或 BBPS 充值

    POST /v1/orders/place openfinance

    扣减零售商钱包并发起预付费/DTH/公用事业交易;兑换与账单支付确认复用同一调用。

    认证方式: token 请求头。number/amount/operator 以及 BBPS 的 option1-3、refId 封装为 hashData。

    • hashData
    • number
    • amount
    • operator
    • option1
    • option2
    • option3
    • refId
    • txnId
    • status
    • optRef
    • response
    • message
    POST /v1/orders/place HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes number+amount+operator+refId>"
    }
    {
      "response": true,
      "message": "Recharge accepted",
      "data": {
        "txnId": "MRC24019876",
        "status": "Success",
        "amount": 299,
        "operator": "Jio",
        "number": "9876543210",
        "optRef": "JIO9X21"
      }
    }
  • 拉取 BBPS 或 DTH 账单详情

    POST /v1/bills/lookup openfinance

    查询未结 BBPS/DTH 账单,供零售商在提交订单前确认金额与 refId。

    认证方式: token 请求头。公用事业/DTH 账单拉取把消费者账号封装为 hashData。

    • hashData
    • number
    • operator
    • amount
    • billDate
    • dueDate
    • customerName
    • refId
    • response
    POST /v1/bills/lookup HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes bill-account payload>"
    }
    {
      "response": true,
      "data": {
        "number": "DL123456789",
        "operator": "BSES Rajdhani",
        "amount": 1860.5,
        "billDate": "2026-09-12",
        "dueDate": "2026-09-28",
        "customerName": "Ravi Sharma",
        "refId": "BBPS9F2A11"
      }
    }
  • 创建加款 UPI 订单

    POST /v1/wallet/topup openbanking

    为零售商周转金创建加款订单;应用通过应用内 UPI 支付面板拉起返回的 UPI payment_url。

    认证方式: token 请求头。amount 与 channel=APP 封装为 hashData。

    • hashData
    • amount
    • channel
    • payment_url
    • redirect_url
    • txn_id
    • txnId
    • response
    POST /v1/wallet/topup HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes amount+channel=APP>"
    }
    {
      "response": true,
      "data": {
        "payment_url": "upi://pay?pa=retailer@upi&am=5000.00&tn=MRC24019899",
        "redirect_url": "https://app.example.com/wallet/topup/callback",
        "txn_id": "MRC24019899"
      }
    }
  • 列出加款金额预设

    POST /v1/wallet/topup-presets openbanking

    返回加款页上的预设金额筹码,供零售商选择周转金补充额度。

    认证方式: 短信 OTP 校验后签发的 token 请求头,可经会话刷新轮换。

    • amount
    • response
    POST /v1/wallet/topup-presets HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": [
        {
          "amount": 500
        },
        {
          "amount": 1000
        },
        {
          "amount": 2000
        },
        {
          "amount": 5000
        },
        {
          "amount": 10000
        }
      ]
    }
  • 分页查询充值、台账与投诉历史

    POST /v1/reports/search openfinance

    分页返回交易报表、台账与投诉列表,含运营商 head/subhead、金额、利润与运营商参考号;台账行另含 open_bal/close_bal。

    认证方式: token 请求头。from/to/page/for/search 封装为 hashKey;for 取 Recharge、Complain、Ledger 等。

    • hashKey
    • from
    • to
    • page
    • for
    • search
    • total
    • data
    • txnId
    • head
    • subhead
    • status
    • amount
    • profit
    • date
    • optRef
    • icon
    • response
    • open_bal
    • close_bal
    POST /v1/reports/search HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashKey": "<rsa-aes from+to+page+for=Recharge>"
    }
    {
      "response": true,
      "total": 86,
      "data": [
        {
          "txnId": "MRC24019876",
          "head": "Jio Prepaid",
          "subhead": "9876543210",
          "status": "Success",
          "amount": 299,
          "profit": 7.18,
          "date": "2026-10-08 18:42",
          "optRef": "JIO9X21",
          "icon": "https://cdn.example.com/icons/jio.svg"
        }
      ]
    }
  • 获取单笔交易报表

    POST /v1/reports/item openfinance

    为详情页与投诉跟进加载单笔充值或台账记录。

    认证方式: token 请求头。id(txnId)与 for(报表类型)封装为 hashKey。

    • hashKey
    • id
    • for
    • txnId
    • head
    • subhead
    • status
    • amount
    • profit
    • date
    • optRef
    • message
    • response
    POST /v1/reports/item HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashKey": "<rsa-aes id+for=Recharge>"
    }
    {
      "response": true,
      "data": {
        "txnId": "MRC24019876",
        "head": "Jio Prepaid",
        "subhead": "9876543210",
        "status": "Success",
        "amount": 299,
        "profit": 7.18,
        "date": "2026-10-08 18:42",
        "optRef": "JIO9X21",
        "message": "Recharge successful"
      }
    }
  • 核验零售商 PAN KYC

    POST /v1/kyc/pan osint

    从 KYC 页提交 PAN 与法定姓名;核验成功后会存储轮换后的 token。

    认证方式: token 请求头。pan 与 name 封装为 hashData。

    • hashData
    • pan
    • name
    • token
    • status
    • message
    • response
    POST /v1/kyc/pan HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes pan+name>"
    }
    {
      "response": true,
      "message": "Your PAN KYC has been successfully completed.",
      "token": "<sessionToken>",
      "data": {
        "pan": "ABCDE1234F",
        "name": "RAVI SHARMA",
        "status": "Verified"
      }
    }
  • 列出某服务最近三笔充值

    POST /v1/orders/recent opendata

    为预付费/DTH/公用事业号码录入页的「最近充值」条提供数据,方便零售商一键重选手机号。

    认证方式: token 请求头。for=服务名封装为 hashKey。

    • hashKey
    • for
    • number
    • amount
    • operator
    • status
    • response
    POST /v1/orders/recent HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashKey": "<rsa-aes for=Prepaid>"
    }
    {
      "response": true,
      "data": [
        {
          "number": "9876543210",
          "amount": 299,
          "operator": "Jio",
          "status": "Success"
        },
        {
          "number": "9123456780",
          "amount": 199,
          "operator": "Airtel",
          "status": "Success"
        }
      ]
    }
  • 刷新零售商会话令牌

    POST /v1/session/refresh osint

    轮换已登录零售商 JWT;status 为 Verified 则进入首页,否则跳到身份核验页。

    认证方式: 已有 token 请求头。成功时 data.token 与 data.user.status 写回会话。

    • token
    • user
    • status
    • phone
    • name
    • response
    POST /v1/session/refresh HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": {
        "token": "<sessionToken>",
        "user": {
          "phone": "9876543210",
          "status": "Verified",
          "name": "Ravi Sharma"
        }
      }
    }
  • 读取当日与累计柜台汇总

    POST /v1/reports/totals openfinance

    填充报表首页的当日与累计「加款/销售/利润」卡片(线上字段拼写为 Profite)。

    认证方式: 短信 OTP 校验后签发的 token 请求头,可经会话刷新轮换。

    • todayAddMoney
    • todaySale
    • todayProfite
    • totalAddMoney
    • totalSale
    • totalProfite
    • response
    POST /v1/reports/totals HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": {
        "todayAddMoney": 5000,
        "todaySale": 12840,
        "todayProfite": 186.5,
        "totalAddMoney": 185000,
        "totalSale": 942310,
        "totalProfite": 14280.75
      }
    }
  • 读取推荐里程碑进度

    POST /v1/referrals/progress opendata

    驱动推荐页:达标充值的好友数、距钱包奖金还差几人,以及奖金金额。

    认证方式: 短信 OTP 校验后签发的 token 请求头,可经会话刷新轮换。

    • qualifiedReferred
    • totalReferred
    • next_milestone
    • remaining_referrals
    • qualifiedBonuses
    • new_bounded_amount
    • bonus_credited
    • response
    POST /v1/referrals/progress HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": {
        "qualifiedReferred": 11,
        "totalReferred": 14,
        "next_milestone": 15,
        "remaining_referrals": 4,
        "qualifiedBonuses": 0,
        "new_bounded_amount": 349,
        "bonus_credited": 0
      }
    }
  • 列出首页服务目录

    POST /v1/catalog/services opendata

    返回登录后首页服务目录;界面按 type 为 Mobile/DTH 与其他账单服务分组,再用各 id 拉运营商佣金列表。

    认证方式: 短信 OTP 校验后签发的 token 请求头,可经会话刷新轮换。

    • id
    • name
    • type
    • icon
    • response
    POST /v1/catalog/services HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": [
        {
          "id": "prepaid",
          "name": "Mobile Recharge",
          "type": "Mobile",
          "icon": "https://cdn.example.com/icons/prepaid.svg"
        },
        {
          "id": "dth",
          "name": "DTH",
          "type": "DTH",
          "icon": "https://cdn.example.com/icons/dth.svg"
        }
      ]
    }
  • 获取应用元数据与客服联系方式

    GET /v1/config/app/{changes} opendata

    带版本的配置:Changes 使缓存失效,AppUrl 驱动应用内更新,contactDetails.WhatsApp 是客服聊天深链。

    认证方式: 短信 OTP 校验后签发的 token 请求头,可经会话刷新轮换。

    • Changes
    • AppUrl
    • appUrl
    • playStoreUrl
    • contactDetails
    • WhatsApp
    • Refer
    • Switch
    • Amount
    GET /v1/config/app/0 HTTP/1.1
    token: <sessionToken>
    {
      "Changes": "12",
      "AppUrl": "https://play.google.com/store/apps/details?id=com.FreeRechargeApp",
      "contactDetails": {
        "WhatsApp": "919876543210"
      },
      "Refer": {
        "Switch": true,
        "Amount": 349
      }
    }
  • 结账前查询 DTH 订户

    POST /v1/dth/subscriber opendata

    在资料提交页解析 DTH 订户,随后零售商才带着 option1-3 提交充值订单。

    认证方式: token 请求头。订户号与运营商封装为 hashData。

    • hashData
    • number
    • operator
    • operatorName
    • customerName
    • response
    POST /v1/dth/subscriber HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes number+operator>"
    }
    {
      "response": true,
      "data": {
        "number": "3012345678",
        "operator": "Tata Play",
        "operatorName": "Tata Play",
        "customerName": "Ravi Sharma"
      }
    }
  • 提交交易投诉

    POST /v1/reports/complaint openfinance

    从详情页对充值或加款 txnId 发起投诉(处理中、钱包未入账、BBPS 未调账等)。

    认证方式: token 请求头。id(txnId)、for(报表类型)与 message 封装为 hashKey。

    • hashKey
    • id
    • for
    • message
    • status
    • response
    POST /v1/reports/complaint HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashKey": "<rsa-aes id+for=Recharge+message>"
    }
    {
      "response": true,
      "message": "Complaint registered",
      "data": {
        "id": "MRC24019876",
        "for": "Recharge",
        "status": "Open"
      }
    }
  • 提交充值并同时加款

    POST /v1/orders/place-with-topup openfinance

    与标准下单相同的预付费/DTH/兑换/BBPS 出单,但同时补充周转金,用于柜台余额不够单独扣款时。

    认证方式: token 请求头。number/amount/operator 以及 option1-3 封装为 hashData;在柜台余额不足时与加款一并发起。

    • hashData
    • number
    • amount
    • operator
    • option1
    • option2
    • option3
    • txnId
    • status
    • payment_url
    • response
    • message
    POST /v1/orders/place-with-topup HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {
      "hashData": "<rsa-aes number+amount+operator>"
    }
    {
      "response": true,
      "message": "Recharge accepted",
      "data": {
        "txnId": "MRC24019901",
        "status": "Pending",
        "amount": 299,
        "operator": "Jio",
        "number": "9876543210",
        "payment_url": "upi://pay?pa=retailer@upi&am=299.00"
      }
    }
  • 签发 Hubble 礼品卡 mock token

    POST /v1/vouchers/session-token opendata

    签发 Hubble 礼品卡 SDK 所需的 mockToken,随后券页才能打开礼品卡结账 iframe。

    认证方式: token 请求头。返回 mockToken 供 Hubble iframe 会话使用。

    • mockToken
    • response
    POST /v1/vouchers/session-token HTTP/1.1
    Content-Type: application/json
    token: <sessionToken>
    
    {}
    {
      "response": true,
      "data": {
        "mockToken": "<hubbleMockToken>"
      }
    }
  • 创建 Hubble 礼品卡结账会话

    GET /v1/vouchers/checkout opendata

    把品牌 title 与 Hubble mockToken 换成 iframe 的 url/baseUrl,用于 Amazon/Flipkart/OTT 礼品卡结账。

    认证方式: 查询参数 token 为券会话令牌调用返回的 mockToken。同源 BFF;iframe 再加载 Hubble 结账页上的 url。

    • title
    • token
    • url
    • baseUrl
    GET /v1/vouchers/checkout?title=amazon&token=<hubbleMockToken> HTTP/1.1
    {
      "url": "https://vouchers.example.com/sdk?session=hbl_sess_91",
      "baseUrl": "https://vouchers.example.com/sdk?session=hbl_sess_91"
    }

数据类别

  • 余额
  • 交易
  • 充值
  • 佣金
  • 实名认证
  • 推荐

数据使用场景与案例

  • 分销周转金对账

    夜间任务拉取 balance 与 ub,再匹配加款 txn_id 与台账贷记/借记 status,让上级分销商看到哪些烟杂店钱包在下一笔 UPI 加款前已经见底。

  • 运营商佣金引擎

    佣金引擎从服务-运营商目录读取每个运营商的 commissions[].margin 与 margin_type,并与充值历史行上的 profit 比较,标出低佣金圈区。

  • BBPS 回单匹配

    财务机器人把拉账单的 refId/customerName/dueDate 与后续充值的 txnId、optRef 关联,让公用事业收款与零售商钱包扣款对齐。

  • 开店准入核验

    合规队列在新柜台被允许扣减周转金之前,检查 PAN 核验(pan、name、status)以及资料完整度(email、pin、city、dist、state)。

常见问题

Mobirec 为零售商暴露哪些钱包字段?

登录后的余额调用返回 balance(实时柜台)、ub(占用/未用桶)、utilityUse(是否允许 BBPS 扣款)和 amSys(是否开放 UPI 加款)。加款随后返回 UPI 意图所需的 payment_url、redirect_url 与 txn_id。

预付费套餐和佣金如何表示?

套餐是按圈区的行,含 rs、desc、validity、data、sms,并按 number/operator/circle/amount 校验。佣金页列出 operators[].commissions[],含 margin_type(Percent 或固定额)与 margin。

BBPS 账单如何对上钱包扣款?

拉账单返回 number、operator、amount、billDate、dueDate、customerName 与 refId;后续订单行带 txnId、optRef、amount 与 status,财务任务即可把回单对上柜台扣款。

可以分页哪些历史记录?

history 调用分页返回充值、台账与投诉列表,字段包括 txnId、head、subhead、amount、profit、status、optRef 与 date。详情调用按 txnId 加载单行;投诉再对该 id 提交一条 message。

与 Mobile Recharge Commission App 相似的应用

  • Mitra — Mitra 是 Bharti Airtel 的零售商应用,用于管理 Airtel LAPU 钱包、查看各圈区资费、给顾客充值,并跟踪实时与月度充值佣金。
  • JioPOS Lite — JioPOS Lite 是 Reliance Jio 的合作伙伴应用,个人可注册为 Jio 代理、给钱包加款并为 Jio 用户充值,收益看板显示每日佣金。
  • PayNearby — PayNearby 面向杂货店等零售点,可在店内代收手机和 DTH 充值、公用事业账单与 EMI 现金,并提供存取款、转账等无网点银行服务。
  • Spice Money — Spice Money 是 DiGiSPICE 的农村金融网络,Adhikari 代理可在街边店办理账单缴费以及手机、OTT 和 FASTag 充值,并提供汇款和迷你 ATM 取现。
  • Paytm — Paytm 是 One97 的印度支付应用,商店页覆盖 UPI 转账、账单缴费和预付费充值,已经收 Paytm 的烟杂店也用同一部手机卖充值。
  • PhonePe — PhonePe 是班加罗尔的 UPI 支付应用,同一钱包除了店内扫码付款,还可充手机和 DTH、缴纳公用事业账单。
  • Eko — Eko Bharat Ventures 提供充值门户和按佣金计费的零售工具,街边店可代售充值、代缴公用事业账单,并办理 Aadhaar 取现和汇款。

相关主题

  • mobirec api
  • 零售商充值钱包
  • 预付费佣金
  • bbps 账单
  • upi 加款
  • pan kyc

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

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

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

获取报价