BharatPe 商户二维码、UPI 与结算数据接口

Resilient Innovations Private Limited · 支付

BharatPe for Business 是 Resilient Innovations Private Limited（BharatPe）面向印度杂货店、餐厅及其他受理 UPI 的门店的商户端应用。店主可打印或下载静态收款码，接收 UPI 入账，用带 TTS 的 Soundbox 报出每笔到账，再把货款结算到绑定银行账户，或留在 BharatPe 账户里向外打款。符合条件的商户可在同一登录下使用 Easy Loans。产品仅服务印度，与 Paytm for Business、PhonePe Business 争夺同一批街边店铺。

收款行的付款方写在 payerhandle，银行流水写在 bankRefNo（亦作 utr）。结算批次带 settlementId 与打往绑定 account / ifsc 的 utr。门店身份落在 mid、vpa / fullVpa、qrstring 以及资料页 qr_layer 的 vpas。

BharatPe 账户的 current_balance 与 today_collection 和首页卡片 Amount、当日 todayCollectionAmount / netSettlement 并列。向外打款保留 bp_txn_id 与线上拼写 benefiaciary_name；Easy Loans 行保留 edi_amount 与 paid_principle。

对账把收款接到结算 UTR，调查按 mid 与 VPA 勾勒杂货店，打款机器人从 BharatPe 账户往外付。openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

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

请求登录 OTP

POST /v1/merchant/login/otp/request osint

发起商户 OTP 登录，返回随后与 OTP 一并提交的 uuid。

认证方式：无需登录；请求体携带 mobileNumber 与短信 hashKey

mobileNumber
hashKey
uuid
isOtpScreen
status
msg

POST /v1/merchant/login/otp/request HTTP/1.1
Content-Type: application/json

{
  "mobileNumber": "9876543210",
  "hashKey": "AbCdEfGhIjK"
}

{
  "status": true,
  "msg": "OTP sent",
  "data": {
    "uuid": "8f2c1a90-4b11-4d22-9e33-aa44bb55cc66",
    "isOtpScreen": true
  }
}

OTP 登录

POST /v1/merchant/login/otp/verify osint

用已验证 OTP 换取 accessToken、refreshToken、mid 与 fullVpa。

认证方式：无需登录；请求体携带 otp、txnId、uuid、deviceInfo、fcmtoken

otp
txnId
uuid
deviceInfo
fcmtoken
accessToken
refreshToken
mid
fullVpa
deepLink
existingUser
hardUpdate
softUpdate
isApp

POST /v1/merchant/login/otp/verify HTTP/1.1
Content-Type: application/json

{
  "otp": "482913",
  "txnId": "TXN-OTP-9912",
  "uuid": "8f2c1a90-4b11-4d22-9e33-aa44bb55cc66",
  "deviceInfo": "android-14",
  "fcmtoken": "<fcm_token>"
}

{
  "status": true,
  "data": {
    "accessToken": "<access_token>",
    "refreshToken": "<refresh_token>",
    "mid": "BP12345678",
    "fullVpa": "shop@bharatpe",
    "deepLink": "bharatpe://home",
    "existingUser": true,
    "hardUpdate": false,
    "softUpdate": false,
    "isApp": true
  }
}

商户资料

GET /v1/merchant/me opendata

读取已登录商户的 mid、VPA、结算账户与收款码字符串。

认证方式：会话 token 请求头与 Deviceinfo JSON

mid
vpa
merchantname
businessname
acno
ifsc
bank_name
qrstring
mobile
settlement
isTTSEnabled

GET /v1/merchant/me HTTP/1.1
token: <access_token>
Deviceinfo: {"os":"android","appversion":"7.5.7.2"}

{
  "status": true,
  "data": {
    "mid": "BP12345678",
    "vpa": "shop@bharatpe",
    "merchantname": "Sharma Kirana",
    "businessname": "Sharma Kirana Store",
    "acno": "XXXXXXXX1234",
    "ifsc": "HDFC0001234",
    "bank_name": "HDFC Bank",
    "qrstring": "upi://pay?pa=shop@bharatpe&pn=Sharma%20Kirana",
    "mobile": "9876543210",
    "settlement": true,
    "isTTSEnabled": true
  }
}

入账 UPI 交易

GET /v1/collections openfinance

列出入账 UPI 收款，含付款方 handle 与银行流水 / UTR。

认证方式：已认证会话；token 请求头

totalAmount
totalCount
transactions
amount
payerhandle
payerName
bankRefNo
paymentTimeStamp
status
vpaType

GET /v1/collections HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "totalAmount": 12450.00,
    "totalCount": 18,
    "transactions": [
      {
        "amount": 350.00,
        "payerhandle": "rahul@okaxis",
        "payerName": "Rahul Sharma",
        "bankRefNo": "AXIxxxxxxxx1234",
        "paymentTimeStamp": 1729123456,
        "status": "SUCCESS",
        "vpaType": "UPI"
      }
    ]
  }
}

结算记录

GET /v1/settlements openfinance

返回结算批次，含目标账户与银行 UTR。

认证方式：已认证会话；token 请求头

totalAmount
totalCount
settlement
amount
settlementId
settlementDate
settleTo
utr
status
timestamp

GET /v1/settlements HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "totalAmount": 48200.00,
    "totalCount": 3,
    "settlement": [
      {
        "amount": 16400.00,
        "settlementId": "STL-20261017-01",
        "settlementDate": "2026-10-17",
        "settleTo": "HDFC0001234",
        "utr": "HDFCxxxxxxxx7788",
        "status": "SUCCESS",
        "timestamp": 1729200000
      }
    ]
  }
}

结算银行设置

GET /v1/settlements/bank-account openbanking

读取绑定的结算银行账户、IFSC 与即时结算开关。

认证方式：会话 token 请求头

account
ifsc
beneficiaryName
branch
instantSettlement
disableSettlementButton
ifscLogo

GET /v1/settlements/bank-account HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "account": "XXXXXXXX1234",
    "ifsc": "HDFC0001234",
    "beneficiaryName": "Sharma Kirana",
    "branch": "Karol Bagh",
    "instantSettlement": true,
    "disableSettlementButton": false,
    "ifscLogo": "https://cdn.example/ifsc/hdfc.png"
  }
}

当日收款拆分

GET /v1/collections/today/summary openfinance

把当日入账总额拆成净结算、BharatPe 消费与 EDI 选项。

认证方式：已认证会话；token 请求头

todayCollection
todayCollectionAmount
netSettlement
spentOnBharatPe
edis

GET /v1/collections/today/summary HTTP/1.1
token: <access_token>

{
  "status": true,
  "todayCollection": {
    "todayCollectionAmount": 12450.00,
    "title": "Today's collection"
  },
  "netSettlement": {
    "amount": 11800.00
  },
  "spentOnBharatPe": [],
  "edis": []
}

首页 BP 卡片余额

GET /v1/wallet/dashboard-card openbanking

加载商户首页 BharatPe 卡片上展示的 Amount。

认证方式：已认证会话；token 请求头

Balance
Amount
Title
IsOrder
BPBItems
XCard

GET /v1/wallet/dashboard-card HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "Balance": {
      "Amount": 184250.50,
      "Title": "BharatPe Balance",
      "IsOrder": false
    },
    "BPBItems": [],
    "XCard": null
  }
}

BharatPe 账户

GET /v1/accounts/primary openbanking

读取 BharatPe 账户的 current_balance、利息与提现上限。

认证方式：已认证会话；token 请求头；查询参数 balanceInfo

balance_info
current_balance
current_interest
total_interest
current_principal
loan_due_amount
max_withdrawal_amount
max_principal_limit
today_collection
consent_taken
auto_settlement
earning_active

GET /v1/accounts/primary?balanceInfo=true HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "balance_info": {
      "current_balance": 184250.50,
      "current_interest": 12.40,
      "total_interest": 890.00,
      "current_principal": 150000.00,
      "loan_due_amount": 0,
      "max_withdrawal_amount": 184250.50,
      "max_principal_limit": 200000.00,
      "today_collection": 12450.00
    },
    "consent_taken": true,
    "auto_settlement": true,
    "earning_active": true
  }
}

创建打款交易

POST /v1/merchant/supplier-transfers openfinance

创建向外打款交易，返回 bp_txn_id 及可选 deeplink。

认证方式：会话 token 请求头

common_params
params
amount
device_id
install_id
source
txn_note
bp_txn_id
deeplink
otp_flow
is_redirect

POST /v1/merchant/supplier-transfers HTTP/1.1
token: <access_token>
Content-Type: application/json

{
  "common_params": {},
  "params": {
    "amount": 2500.00,
    "device_id": "<device_id>",
    "install_id": "<install_id>",
    "source": "send_money",
    "txn_note": "Supplier payout"
  }
}

{
  "status": true,
  "data": {
    "bp_txn_id": "BP-SM-778812",
    "deeplink": "upi://pay?pa=vendor@okicici",
    "otp_flow": false,
    "is_redirect": false,
    "source": "send_money"
  }
}

打款交易列表

GET /v1/merchant/supplier-transfers/log openfinance

列出向外打款记录，含线上拼写 benefiaciary_name 字段。

认证方式：会话 token 请求头

txns
amount
benefiaciary_name
bp_txn_id
mode
status
status_text
timestamp

GET /v1/merchant/supplier-transfers/log HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "txns": [
      {
        "amount": 2500.00,
        "benefiaciary_name": "Vendor Traders",
        "bp_txn_id": "BP-SM-778812",
        "mode": "UPI",
        "status": "SUCCESS",
        "status_text": "Paid",
        "timestamp": 1729129999
      }
    ]
  }
}

下载收款码

GET /v1/merchant/qr/image opendata

返回可打印商户收款码图片 url 与 qrStatus。

认证方式：已认证会话；token 请求头

url
msg
qrStatus

GET /v1/merchant/qr/image HTTP/1.1
token: <access_token>

{
  "status": true,
  "data": {
    "url": "https://cdn.example/qr/BP12345678.png",
    "msg": "OK",
    "qrStatus": true
  }
}

商户界面资料

GET /v1/merchant/profile-card opendata

加载资料页收款码卡片的 qr_layer VPA、qr_string 与 download_url。

认证方式：已认证会话；token 请求头

qr_layer
merchant_status
beneficiary_name
business_name
deeplink
vpas
download_url
qr_string
status
bp_protect
cohortId

GET /v1/merchant/profile-card HTTP/1.1
token: <access_token>

{
  "success": true,
  "response_code": 200,
  "data": {
    "qr_layer": {
      "merchant_status": "ACTIVE",
      "beneficiary_name": "Sharma Kirana",
      "business_name": "Sharma Kirana Store",
      "deeplink": "bharatpe://qr",
      "vpas": [
        {
          "download_url": "https://cdn.example/qr/shop.png",
          "qr_string": "upi://pay?pa=shop@bharatpe",
          "status": "ACTIVE"
        }
      ]
    },
    "bp_protect": {},
    "cohortId": "c-merchant-in"
  }
}

商户贷款

GET /v1/credit/loans openfinance

列出 Easy Loans 记录，含 EDI 应还金额与线上拼写 paid_principle。

认证方式：已认证会话；token 请求头

success
message
loadDetailDeeplink
payEdiDeeplink
loans
loan_amount
edi_amount
due_amount
pending_amount
paid_principle
status

GET /v1/credit/loans HTTP/1.1
token: <access_token>

{
  "success": true,
  "message": "OK",
  "loadDetailDeeplink": "bharatpe://loan/detail",
  "payEdiDeeplink": "bharatpe://loan/edi",
  "loans": [
    {
      "loan_amount": 50000.00,
      "edi_amount": 4200.00,
      "due_amount": 4200.00,
      "pending_amount": 21000.00,
      "paid_principle": 29000.00,
      "status": "ACTIVE"
    }
  ]
}

数据类别

余额
交易
商户资料
结算
收款码
贷款

数据使用场景与案例

结算 UTR 对账
夜间财务任务把入账 payerhandle 行与结算 utr 批次对齐，店铺不必等下一轮 Soundbox 报账就能核对银行入账。
按 mid 做收款 OSINT
调查方可对已知 mid 拉取 merchantname、fullVpa 与当日 todayCollectionAmount，勾勒杂货店的 UPI 进账。
从 BharatPe 账户向供应商打款
ERP 机器人读取 current_balance 后提交打款，再轮询 bp_txn_id / benefiaciary_name 直至 status 为 SUCCESS。
Easy Loans EDI 日历
放贷系统摄入 due_amount 与 edi_amount，把下一期 Easy Loans 分期与当日 UPI 收款放在一起看。

常见问题

哪一个标识把 BharatPe 店铺和它的 VPA 绑在一起？

登录返回 mid 与 fullVpa；商户资料对同一店铺重复 mid、vpa、merchantname 与 qrstring。

入账 UPI 如何识别？

每条收款带 payerhandle、payerName、amount 与 bankRefNo（也可写作 utr）。

结算 UTR 出现在哪里？

结算批次给出 settlementId、settleTo、amount 与 utr；银行设置再给出 account、ifsc 与 beneficiaryName。

向外打款能否追踪？

创建打款后，列表返回 bp_txn_id、benefiaciary_name、mode、status 与 timestamp。

与 BharatPe for Business 相似的应用

Paytm for Business — Paytm for Business 是 One97 Communications 面向印度店铺的商户端，覆盖 All-in-One 收款码、Soundbox 语音播报、刷卡 POS 以及每日银行结算。
PhonePe Business — PhonePe Business 是 PhonePe 面向印度店铺的商户应用，可申领店内收款码贴纸、用 SmartSpeaker 播报到账，并在 POS 上收卡和 UPI。
Razorpay POS — Razorpay POS 向印度商户提供刷卡终端、Growth DQR 收款码以及可在店内收 UPI 和银行卡的 Bharat Soundbox。
Pine Labs — Pine Labs 出售 Android POS 终端以及把 POS、收款码和 Soundbox 合在一起的 Mini 设备，供印度零售商在柜台收 UPI 和银行卡。
Mswipe — Mswipe 是经印度储备银行批准的支付聚合商，其 Wisepos 终端和 Boombox 音箱让印度店铺可收银行卡、动态 UPI 收款码和付款链接。
Google Pay for Business — Google Pay for Business 是谷歌面向印度商户的收款控制台，用于收取 UPI 款项，含二维码受理与结算账户管理。
PayU — PayU 向印度商户提供店内和上门收款用的 Bharat QR，以及 POS 和覆盖银行卡、UPI 与网银的支付网关。

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

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

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

获取报价

BharatPe 商户二维码、UPI 与结算数据接口

应用截图

API 端点一览

请求登录 OTP

OTP 登录

商户资料

入账 UPI 交易

结算记录

结算银行设置

当日收款拆分

首页 BP 卡片余额

BharatPe 账户

创建打款交易

打款交易列表

下载收款码

商户界面资料

商户贷款

数据类别

数据使用场景与案例

结算 UTR 对账

按 mid 做收款 OSINT

从 BharatPe 账户向供应商打款

Easy Loans EDI 日历

常见问题

与 BharatPe for Business 相似的应用

更多支付类应用

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

Dhan Barse

相关主题

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

BharatPe 商户二维码、UPI 与结算数据接口

应用截图

API 端点一览

请求登录 OTP

OTP 登录

商户资料

入账 UPI 交易

结算记录

结算银行设置

当日收款拆分

首页 BP 卡片余额

BharatPe 账户

创建打款交易

打款交易列表

下载收款码

商户界面资料

商户贷款

数据类别

数据使用场景与案例

结算 UTR 对账

按 mid 做收款 OSINT

从 BharatPe 账户向供应商打款

Easy Loans EDI 日历

常见问题

相关应用

与 BharatPe for Business 相似的应用

更多支付类应用

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

Dhan Barse

相关主题

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