Freecharge 钱包、UPI 与账单数据 API

FreechargeBiz - An Axis Bank Subsidiary · 支付

Freecharge UPI & Bill Payments 是 FreechargeBiz 面向个人用户的应用——FreechargeBiz 是 Axis Bank 的子公司，2017 年 Axis 收购 Freecharge 后，接手了这款诞生于 Snapdeal 的钱包。印度用户用它收发 UPI 款项、扫描商户二维码、缴纳电费及其他 BBPS 账单、为预付费手机号充值、持有预付 Freecharge 钱包、保留一笔 UPI Lite 余额用于小额轻触支付，并买卖数字黄金。登录方式为手机号 OTP；发送款项由关联银行账户的 UPI PIN 授权，周期性商户则由 Autopay 授权委托覆盖。产品仅在印度运营，在日常卢比支付场景中与 PhonePe、Google Pay 和 Paytm 并列，而 Axis Mobile 仍是集团的全功能银行应用。

预付钱包在 Axis 旗下的账户里把 CREDITABLE_BALANCE 与 DEBITABLE_BALANCE、VOUCHER_BALANCE 分桶记录；已关联 UPI 账户的余额查询则为所选 VPA 返回 availableBalance 与 outstandingBalance。收款请求与 P2P 付款写入时会盖上 NPCI 的 rrn；账单查询为 BBPS 收款机构返回 billAmount、billerId 与 billFetchId；UPI Lite 开通后交回 lrn；数字黄金持仓则在 goldBalance 克数旁给出 cumulativeGoldBalanceInRs。

放贷机构与个人理财应用可在一次印度会话内把钱包现金与银行、黄金合并轧差；收款机构可确认账单查询与支付状态；商户分析可把免 PIN 的 Lite 轻触支付与完整的 UPI 付款区分开。openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

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

读取预付钱包余额

GET /v1/wallet/balances openbanking

读取预付 Freecharge 钱包余额，按 creditable、debitable、general、voucher 与 withdrawable 分桶，供钱包首页使用。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头；查询参数含客户端平台、渠道与版本。

CREDITABLE_BALANCE
DEBITABLE_BALANCE
GENERAL_BALANCE
TOTAL_BALANCE
TOTAL_COMPOSITE_BALANCE
VOUCHER_BALANCE
CREDITABLE_VOUCHER_BALANCE
withDrawableBalance
minWithdrawableBalance
maxGeneralBalance
walletStatus

GET /v1/wallet/balances?platform=android&channel=app&version=<client-version> HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Accept: application/json

{
  "walletResponse": {
    "balanceDetails": {
      "CREDITABLE_BALANCE": "850.00",
      "DEBITABLE_BALANCE": "850.00",
      "GENERAL_BALANCE": "850.00",
      "TOTAL_BALANCE": "1200.00",
      "TOTAL_COMPOSITE_BALANCE": "1200.00",
      "VOUCHER_BALANCE": "350.00",
      "CREDITABLE_VOUCHER_BALANCE": "350.00",
      "CREDITABLE_VOUCHER_AVAILABLE_COUNT": "2",
      "withDrawableBalance": "850.00"
    },
    "totalBalance": "1200.00",
    "totalCompositeBalance": "1200.00",
    "minWithdrawableBalance": "1.00",
    "maxGeneralBalance": "10000.00",
    "walletStatus": "ACTIVE"
  }
}

发送钱包款项

POST /v1/wallet/transfers openbanking

从预付钱包向另一个手机号 handle 发起 P2P 转账，以 idempotencyId 作为幂等键。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头；使用登录时签发的钱包标识。

amount
fromHandle
toHandle
payHandle
receiverIdentity
idempotencyId
eventContext

POST /v1/wallet/transfers HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "amount": 250.0,
  "fromHandle": "9876543210",
  "fromHandleType": "MOBILE",
  "toHandle": "9123456789",
  "toHandleType": "MOBILE",
  "payHandle": "9123456789",
  "payHandleType": "MOBILE",
  "receiverIdentity": "9123456789",
  "receiverIdentityType": "MOBILE",
  "idempotencyId": "fc-idem-8f21c4",
  "eventContext": {"communicatorInfo": {"command": "SEND_MONEY", "domain": "P2P"}}
}

{
  "status": "SUCCESS",
  "idempotencyId": "fc-idem-8f21c4",
  "amount": 250.0,
  "fromHandle": "9876543210",
  "toHandle": "9123456789"
}

列出已关联的 UPI 银行账户

POST /v1/upi/linked-accounts/search openbanking

列出 UPI 账户页展示的银行及已关联 UPI 账户（VPA、脱敏账号、IFSC、Lite 标志）。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头。

code
result
bankName
bankCode
txnLimit
vpa
maskedAccnumber
ifsc
iin
accRefNumber
isPrimary
isLiteEnabled
name

POST /v1/upi/linked-accounts/search HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "device": {"app": "android", "mobile": "9876543210"}
}

{
  "code": "00",
  "result": "SUCCESS",
  "data": [
    {
      "bankName": "Axis Bank",
      "bankCode": "UTIB",
      "txnLimit": "100000",
      "logo": "https://cdn.example.com/logo.png",
      "accounts": [
        {
          "vpa": "user@freecharge",
          "name": "RAJ SHARMA",
          "bankName": "Axis Bank",
          "maskedAccnumber": "XXXXXX4321",
          "ifsc": "UTIB0000123",
          "iin": "508534",
          "accRefNumber": "ACC987654",
          "isPrimary": true,
          "isLiteEnabled": true,
          "isLiteCompatible": true,
          "type": "SAVINGS"
        }
      ]
    }
  ]
}

UPI 账户余额查询

POST /v1/upi/accounts/balance-checks openbanking

在输入 UPI PIN 后，查询所选关联银行账户的可用余额与未结余额，并带有 UPI Lite 标志。

认证方式：会话 Cookie 加 CSRF 令牌请求头；UPI PIN 在 NPCI 通用库步骤之后封装进 cred 对象。

code
result
isUpiLiteBalance
availableBalance
outstandingBalance
customerId
bankId
txnid

POST /v1/upi/accounts/balance-checks HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "bankId": "73",
  "txnid": "FCUPI20261019120001",
  "clVersion": "1.8",
  "requestTimestamp": "2026-10-19T12:00:01+05:30",
  "ac": {"vpa": "user@freecharge", "accRefNumber": "ACC987654", "ifsc": "UTIB0000123"},
  "cred": {"type": "PIN", "data": "<npci-encrypted-pin>"},
  "device": {"app": "android", "mobile": "9876543210"}
}

{
  "code": "00",
  "result": "SUCCESS",
  "isUpiLiteBalance": false,
  "data": {
    "availableBalance": "18450.75",
    "outstandingBalance": "0.00"
  }
}

校验收款人 VPA

POST /v1/upi/payees/verification openbanking

在进入发送页之前，把收款人 VPA 解析为已验证的姓名、MCC、spam/unsafe 标志与历史交易笔数。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头。

vpa
beneVpa
maskedBeneVpa
beneName
beneVPAVerified
isBeneNameVerified
mcc
maxTxnLimit
spam
unsafe
txnHistoryCount

POST /v1/upi/payees/verification HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "vpa": "shop@okaxis",
  "customerid": "C123456789",
  "purpose": "P2M",
  "category": "MERCHANT",
  "countryCode": "IN",
  "isGlobal": false,
  "isTipsAndConvFee": false
}

{
  "responseBody": {
    "code": "00",
    "result": "SUCCESS",
    "beneVpa": "shop@okaxis",
    "maskedBeneVpa": "sh**@okaxis",
    "beneName": "KIRANA STORE",
    "beneVPAVerified": true,
    "isBeneNameVerified": "Y",
    "mcc": "5411",
    "maxTxnLimit": "100000",
    "spam": false,
    "unsafe": false,
    "txnHistoryCount": 3
  }
}

UPI P2P / P2M 付款

POST /v1/upi/payments openbanking

发起 UPI P2P 或商户付款，返回成功页所用的 NPCI rrn 与状态。

认证方式：会话 Cookie 加 CSRF 令牌请求头；UPI PIN 在 NPCI 通用库步骤之后封装进 cred 对象。

amount
txnId
payerName
remarks
mcc
purpose
purposeCode
beneVpa
beneName
bamount
rrn
status
timestamp
arpc

POST /v1/upi/payments HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "amount": "499.00",
  "txnId": "FCUPI20261019124500",
  "payerName": "RAJ SHARMA",
  "remarks": "Groceries",
  "mcc": "5411",
  "purpose": "P2M",
  "purposeCode": "00",
  "saveAsBeneficiary": true,
  "payees": [
    {"beneVpa": "shop@okaxis", "beneName": "KIRANA STORE", "bamount": "499.00", "ifsc": "UTIB0000456"}
  ],
  "ac": {"vpa": "user@freecharge", "accRefNumber": "ACC987654"},
  "cred": {"type": "PIN", "data": "<npci-encrypted-pin>"}
}

{
  "payResponseBody": {
    "rrn": "629012345678",
    "status": "SUCCESS",
    "timestamp": "2026-10-19T12:45:02+05:30",
    "arpc": "<arpc>"
  }
}

发起 UPI 收款请求

POST /v1/upi/collect-requests openbanking

针对付款人 VPA 创建带有效期的 UPI 收款请求，返回 rrn 与待处理状态。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头。

vpa
payerVpa
payerName
amount
expiry
remarks
txnId
rrn
status
message
timestamp

POST /v1/upi/collect-requests HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "vpa": "user@freecharge",
  "payerVpa": "friend@okicici",
  "payerName": "AMIT KUMAR",
  "amount": "200.00",
  "expiry": "2026-10-19T18:00:00+05:30",
  "remarks": "Split dinner",
  "txnId": "FCCOL20261019130000",
  "saveAsBeneficiary": false
}

{
  "collectResponseBody": {
    "rrn": "629098765432",
    "status": "PENDING",
    "message": "Collect request sent",
    "timestamp": "2026-10-19T13:00:01+05:30"
  }
}

收款人近期 UPI 交易

POST /v1/upi/payees/activity openbanking

分页返回某个收款人 VPA 名下近期的 UPI 借记/贷记记录，供聊天式历史条使用。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头。

customerId
beneVpa
txnId
amount
operationType
status
txnDate
txnDateTimeEpoch
logo

POST /v1/upi/payees/activity HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "beneVpa": "shop@okaxis"
}

{
  "status": "SUCCESS",
  "data": [
    {
      "txnId": "FCUPI20261018184500",
      "amount": "499.00",
      "operationType": "DEBIT",
      "status": "SUCCESS",
      "txnDate": "2026-10-18 18:45:02",
      "txnDateTimeEpoch": 1760793302000,
      "logo": "https://cdn.example.com/logo.png"
    }
  ]
}

查询 BBPS 账单

POST /v1/bills/lookups opendata

为已保存的收款机构查询 BBPS 账单，返回金额、到期信息与结账前使用的 billFetchId。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头。

billFetchId
billAmount
billerId
billerName
billerLogo
blockId
category
categoryCode
categoryId
status

POST /v1/bills/lookups HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "billerId": "MAHA00000MUM01",
  "category": "Electricity",
  "categoryCode": "ELECTRICITY",
  "userDetails": {"customerId": "C123456789", "mobileNumber": "9876543210"}
}

{
  "billFetchId": "BF-88990011",
  "billAmount": "1840.00",
  "billerId": "MAHA00000MUM01",
  "billerName": "MSEDCL",
  "billerLogo": "https://cdn.example.com/logo.png",
  "blockId": "BLK-4411",
  "category": "Electricity",
  "categoryCode": "ELECTRICITY",
  "categoryId": 1,
  "status": "SUCCESS",
  "additionalDetails": {"dueDate": "2026-10-28", "billNumber": "E202610001"}
}

数字黄金持仓

GET /v1/gold/holdings openfinance

读取数字黄金克数、按市价折算的卢比价值，以及黄金保管页所用的 KYC/交割标志。

认证方式： OTP 登录后携带会话 Cookie 与 CSRF 令牌请求头。

aggregatorUserId
goldBalance
totalGoldBalance
cumulativeGoldBalanceInRs
currentGoldRupeesBalance
totalGoldInvestedAmount
percentageGoldGrowth
isKycDone
registeredUser
isDeliveryDone
showDelivery

GET /v1/gold/holdings HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Accept: application/json

{
  "aggregatorUserId": "AG-442211",
  "goldBalance": 2.45,
  "totalGoldBalance": 2.45,
  "cumulativeGoldBalanceInRs": 18420.50,
  "currentGoldRupeesBalance": 18610.00,
  "totalGoldInvestedAmount": 17000.00,
  "percentageGoldGrowth": 9.47,
  "isKycDone": true,
  "registeredUser": true,
  "isDeliveryDone": false,
  "showDelivery": true,
  "phoneUpdated": true
}

开通 UPI Lite

POST /v1/upi-lite/activations openbanking

在已关联账户上注册 UPI Lite，返回用于免 PIN 小额轻触支付的 LRN 与 lite keys。

认证方式：会话 Cookie 加 CSRF 令牌请求头；UPI PIN 在 NPCI 通用库步骤之后封装进 cred 对象。

accRefNumber
lrn
liteKeys
txnId
payerLiteAccountNumber

POST /v1/upi-lite/activations HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "accRefNumber": "ACC987654",
  "txnId": "FCLITE20261019140000"
}

{
  "data": {
    "accRefNumber": "ACC987654",
    "lrn": "LITE991122",
    "liteKeys": "<lite-key-blob>",
    "txnId": "FCLITE20261019140000",
    "payerLiteAccountNumber": "XLITE4321"
  }
}

充值 UPI Lite

POST /v1/upi-lite/top-ups openbanking

从已关联银行账户向 UPI Lite 余额充入卢比，返回 NPCI rrn 与风险评分。

认证方式：会话 Cookie 加 CSRF 令牌请求头；UPI PIN 在 NPCI 通用库步骤之后封装进 cred 对象。

amount
txnId
liteKeyType
purpose
rrn
status
timestamp
arpc
upiRc
upiIrc
riskScoreValue

POST /v1/upi-lite/top-ups HTTP/1.1
Cookie: session=<session-token>
X-CSRF-Token: <csrf-token>
Content-Type: application/json

{
  "customerId": "C123456789",
  "amount": "2000.00",
  "txnId": "FCLITEUP20261019140100",
  "purpose": "LITE_TOPUP",
  "purposeCode": "00",
  "liteKeyType": "INITIAL",
  "ac": {"vpa": "user@freecharge", "accRefNumber": "ACC987654"}
}

{
  "data": {
    "rrn": "629055667788",
    "status": "SUCCESS",
    "timestamp": "2026-10-19T14:01:02+05:30",
    "arpc": "<arpc>",
    "upiRc": "00",
    "upiIrc": "00",
    "riskScoreValue": "0",
    "message": "Lite top-up successful"
  }
}

数据类别

余额
交易
UPI 账户
账单
数字黄金

数据使用场景与案例

钱包加银行对账
夜间任务从预付钱包拉取 CREDITABLE_BALANCE、DEBITABLE_BALANCE 与 withDrawableBalance，再对每个关联 VPA 发起 UPI 余额查询以获取 availableBalance，让公积金或放贷系统能够在钱包与银行之间轧差，核算卢比流动性。
BBPS 账单支付确认
公用事业聚合方为电力及其他 BBPS 收款机构拉取 billAmount、billerId 与 billFetchId，再匹配之后 P2P 付款或收款请求产生的 UPI rrn，证明账单已结清。
数字黄金财富快照
财富看板读取 goldBalance 克数，并与 cumulativeGoldBalanceInRs、percentageGoldGrowth 并列（以 isKycDone 为前提），把 Freecharge 黄金与银行及钱包现金放在一起展示。
UPI Lite 小额支付通道
商户分析可识别已启用 Lite 的账户（isLiteEnabled、lrn）以及充值产生的 rrn 与 riskScoreValue，把免 PIN 的轻触支付与需输入完整 UPI PIN 的发送区分开。

常见问题

Freecharge 数据 API 暴露哪些余额？

预付钱包返回 CREDITABLE_BALANCE、DEBITABLE_BALANCE、GENERAL_BALANCE、VOUCHER_BALANCE 与 withDrawableBalance。另有 UPI 余额查询，为已关联银行账户返回 availableBalance 与 outstandingBalance；查询 Lite 钱包时还会带上 isUpiLiteBalance 标志。

除了余额，还能读取 UPI 付款吗？

可以。P2P/P2M 付款与收款请求都会返回 NPCI 的 rrn，外加 status 与 timestamp。近期收款人活动按 VPA 列出 txnId、amount、operationType 与 txnDate。收款人校验会在发送前解析出 beneName、mcc 以及 spam/unsafe 标志。

Freecharge 是否提供账单与黄金数据？

账单查询为 BBPS 收款机构返回 billAmount、billerId、billerName、billFetchId 与 categoryCode。数字黄金持仓返回 goldBalance 克数、cumulativeGoldBalanceInRs、percentageGoldGrowth 与 isKycDone。

应用如何为这些调用做身份认证？

手机号 OTP 登录会签发会话 Cookie 与 CSRF 令牌，随后续调用一并携带，同时附上客户端平台与版本参数。UPI PIN 写入请求把 NPCI 加密后的凭据封装在 cred 对象中；登录还会为预付钱包签发钱包标识与令牌。

与 Freecharge UPI & Bill Payments 相似的应用

PhonePe — PhonePe 是 Flipkart 旗下的印度 UPI 应用，用户可用它收发款项、为手机和 DTH 充值、缴纳公用事业账单，并扫描店内收款码。
Google Pay — Google Pay（前称 Tez）是谷歌面向印度的 UPI 应用，用于银行账户间收发款项、扫描二维码以及缴纳公用事业账单。
Paytm — Paytm 是印度支付应用，最初做预付费手机和 DTH 充值，随后加入钱包、UPI 以及电费、燃气费和水费缴纳。
BHIM — BHIM 是印度国家支付公司（NPCI）推出的官方 UPI 应用，可通过 UPI ID、二维码或银行账户信息收发款项，并提供用于小额机上支付的 UPI Lite。
Amazon Pay — Amazon Pay UPI 是亚马逊印度站内的 UPI 服务，与 Axis Bank 合作推出，为用户签发 UPI ID，可在亚马逊及其他 UPI 商户付款。
MobiKwik — MobiKwik 是印度金融科技应用，提供印度储备银行授权的半封闭钱包，以及 UPI 转账、手机和 DTH 充值、公用事业与信用卡账单支付。
CRED — CRED 是印度应用，最初以信用卡账单还款奖励起家，后扩展到 UPI 支付、房租缴纳及其他金融服务。
Airtel: Recharge, Bank & Loans — Airtel Thanks 是 Bharti Airtel 面向印度用户的应用，用于预付费充值和后付费账单，并通过 Airtel Payments Bank 提供 UPI 支付与转账。

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

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

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

获取报价

Freecharge 钱包、UPI 与账单数据 API

应用截图

API 端点一览

读取预付钱包余额

发送钱包款项

列出已关联的 UPI 银行账户

UPI 账户余额查询

校验收款人 VPA

UPI P2P / P2M 付款

发起 UPI 收款请求

收款人近期 UPI 交易

查询 BBPS 账单

数字黄金持仓

开通 UPI Lite

充值 UPI Lite

数据类别

数据使用场景与案例

钱包加银行对账

BBPS 账单支付确认

数字黄金财富快照

UPI Lite 小额支付通道

常见问题

与 Freecharge UPI & Bill Payments 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Freecharge 钱包、UPI 与账单数据 API

应用截图

API 端点一览

读取预付钱包余额

发送钱包款项

列出已关联的 UPI 银行账户

UPI 账户余额查询

校验收款人 VPA

UPI P2P / P2M 付款

发起 UPI 收款请求

收款人近期 UPI 交易

查询 BBPS 账单

数字黄金持仓

开通 UPI Lite

充值 UPI Lite

数据类别

数据使用场景与案例

钱包加银行对账

BBPS 账单支付确认

数字黄金财富快照

UPI Lite 小额支付通道

常见问题

相关应用

与 Freecharge UPI & Bill Payments 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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