Paytm for Business 商户收款码与结算数据接口

Paytm - One97 Communications Ltd. · 支付

Paytm for Business 是 One97 Communications 面向印度杂货店、餐厅、诊所及其他受理 UPI 的门店的商户端应用，用于在 Paytm 收款码、Soundbox 与刷卡机上收款。店主用消费端同一 Paytm 账号登录，把静态或照片收款码贴在收银处，听音箱报出每笔入账，再在收款与结算页查看当日流水和随后的银行入账。可按当日或一日三次把货款打到绑定对公账户；顾客不在店时可用付款链接开远程账单。产品只服务印度，与 PhonePe Business、BharatPe for Business 争夺同一批街边店铺，消费端 Paytm 则是买家侧对应应用。

TWS 打款行把 merchantOrderId 与 settlementStatus 打在绑定的 bankAccountNo 上。当日账单再带 settlementBillId、settlementAmount 以及银行 UTR bankTxnId。收款码入账携带 acquirementId、txnAmount、payerName 与支付 mode。

门店身份落在 merchantId、merchantDisplayName 与 KYC bankVerifiedName。码牌给出 qrCodeId、UPI qrCodeString 与可分享 qrPaymentLink。首页金额条拆出 totalAmount、availableAmount 与 amountOnHold，再对比 alreadySettledToBank。

对账把收款接到 8/13/19 点的 TWS UTR，门店运营把实体码牌映射到 mid，调查按 merchantId 勾勒杂货店。openData Studio 把这些字段变成可调用的开放数据。

应用截图

API 端点一览

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

商户会话上下文

GET /v1/merchant/session osint

加载已登录商户的 merchantId、展示名与账户状态，供登录后首页抽屉使用。

认证方式：商户会话 Cookie 加用户令牌请求头；附带请求关联号头。

merchantId
merchantName
merchantDisplayName
merchantAccountState
posId

GET /v1/merchant/session HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
X-Request-Id: <request-id>
Accept: application/json

{
  "merchantId": "MRCH10482937461",
  "merchantName": "RAJ VERMA",
  "merchantDisplayName": "RAJ VERMA",
  "merchantAccountState": "ACTIVE",
  "posId": "5678"
}

商户基本资料

GET /v1/merchant/profile osint

读取商户资料卡：法定名称、展示名与脱敏结算银行账户。

认证方式：商户会话 Cookie 加用户令牌请求头。

merchantId
merchantName
merchantDisplayName
bankAccountNo
bankName

GET /v1/merchant/profile HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "merchantId": "MRCH10482937461",
  "merchantName": "RAJ VERMA",
  "merchantDisplayName": "Verma General Store",
  "bankAccountNo": "4821**7305",
  "bankName": "SAMPLE PAYMENTS BANK LIMITED"
}

商户 KYC 状态

GET /v1/merchant/verification osint

返回 KYC 结算类型与频次，以及 KYC 页使用的已核验银行名与 IFSC。

认证方式：商户会话 Cookie 加用户令牌请求头。

merchantId
kyc_settlement_type
kyc_settlement_freq
bankVerifiedName
bankIfscCode

GET /v1/merchant/verification HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "merchantId": "MRCH10482937461",
  "kyc_settlement_type": "BANK",
  "kyc_settlement_freq": "THRICE",
  "bankVerifiedName": "RAJ VERMA",
  "bankIfscCode": "SMPL0000001"
}

钱包看板汇总
GET /v1/balances/overview openbanking
加载首页收款条：当日 totalAmount、availableAmount、amountOnHold 与 alreadySettledToBank。
认证方式：商户会话 Cookie 加用户令牌请求头。
- totalAmount
- availableAmount
- amountOnHold
- amount_to_be_settled_header
- alreadySettledToBank
```
GET /v1/balances/overview HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json
```
```
{
  "totalAmount": "96480.00",
  "availableAmount": "90150.00",
  "amountOnHold": "6330.00",
  "amount_to_be_settled_header": "96480.00",
  "alreadySettledToBank": "71200.00"
}
```

钱包收款流水

GET /v1/collections openbanking

分页返回钱包入账，含 merchantOrderId、acquirementId、txnAmount、payerName、支付方式与 settlementStatus。

认证方式：商户会话 Cookie 加用户令牌请求头。

orderList
merchantOrderId
acquirementId
txnAmount
txnDate
posId
merchantId
mode
payerName
remarks
settlementStatus

GET /v1/collections?from=2026-10-17&to=2026-10-17&pageNo=1&pageSize=20 HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "orderList": [
    {
      "merchantOrderId": "ORD20261017000412",
      "acquirementId": "ACQ20261017110830000412",
      "txnAmount": "250.00",
      "txnDate": "2026-10-17T16:24:57+05:30",
      "posId": "5678",
      "merchantId": "MRCH10482937461",
      "mode": "UPI",
      "payerName": "ANITA KUMAR",
      "remarks": "Payment received",
      "settlementStatus": "PENDING_LESS_THAN_ONE_DAY"
    }
  ]
}

钱包结算报表

GET /v1/payouts openfinance

列出钱包结算账单，含 settlementBillId、金额、目标银行与 settlementTime。

认证方式：商户会话 Cookie 加用户令牌请求头。

settlementBillArray
settlementBillId
settlementAmount
settlementBankName
settlementAccountNo
settlementStatus
settlementTime

GET /v1/payouts?from=2026-10-01&to=2026-10-17 HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "settlementBillArray": [
    {
      "settlementBillId": "BILL-20261017-0042",
      "settlementAmount": "71200.00",
      "settlementBankName": "SAMPLE PAYMENTS BANK LIMITED",
      "settlementAccountNo": "4821**7305",
      "settlementStatus": "SUCCESS",
      "settlementTime": "2026-10-17T19:05:00+05:30"
    }
  ]
}

结算 UTR 明细

GET /v1/payouts/bank-reference openfinance

返回结算账单对应的银行 UTR（bankTxnId），供商户与银行对账单核对入账。

认证方式：商户会话 Cookie 加用户令牌请求头。

settlementBillId
bankTxnId
settlementAmount
bankName
bankAccountNo
settlementStatus

GET /v1/payouts/bank-reference?settlementBillId=BILL-20261017-0042 HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "settlementBillId": "BILL-20261017-0042",
  "bankTxnId": "SMPL202610171905000042",
  "settlementAmount": "71200.00",
  "bankName": "SAMPLE PAYMENTS BANK LIMITED",
  "bankAccountNo": "4821**7305",
  "settlementStatus": "SUCCESS"
}

当日结算摘要
GET /v1/payouts/today openfinance
加载当日结算卡片：金额、settlementFreq、待结算/成功状态与下一档 settlementTime。
认证方式：商户会话 Cookie 加用户令牌请求头。
- settlementAmount
- settlementFreq
- settlementType
- settlementState
- settlementTime
- balanceFromFailedSettlement
```
GET /v1/payouts/today HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json
```
```
{
  "settlementAmount": "96480.00",
  "settlementFreq": "THRICE",
  "settlementType": "BANK",
  "settlementState": "PENDING",
  "settlementTime": "19:00",
  "balanceFromFailedSettlement": "0.00"
}
```

TWS 当日订单列表

GET /v1/collections/same-day openbanking

分页返回当日将结算（TWS）订单，驱动结算页订单列表。

认证方式：商户会话 Cookie 加用户令牌请求头。

orderList
merchantOrderId
txnAmount
mode
payerName
settlementStatus
posId

GET /v1/collections/same-day?pageNo=1&pageSize=20 HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "orderList": [
    {
      "merchantOrderId": "ORD20261017000977",
      "txnAmount": "499.00",
      "mode": "UPI",
      "payerName": "MEERA IYER",
      "settlementStatus": "PENDING_LESS_THAN_ONE_DAY",
      "posId": "5678"
    }
  ]
}

TWS 结算列表

GET /v1/payouts/batches openfinance

列出 TWS 打款批次（一日一次/两次/三次），含 settlementAmount 与 settlementStatus。

认证方式：商户会话 Cookie 加用户令牌请求头。

settlementBillArray
settlementBillId
settlementAmount
settlementStatus
settlementTime
settlementBankName

GET /v1/payouts/batches?pageNo=1&pageSize=20 HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "settlementBillArray": [
    {
      "settlementBillId": "BATCH-20261017-01",
      "settlementAmount": "32400.00",
      "settlementStatus": "SUCCESS",
      "settlementTime": "2026-10-17T08:15:00+05:30",
      "settlementBankName": "SAMPLE PAYMENTS BANK LIMITED"
    }
  ]
}

商户收款码

GET /v1/qr-plates opendata

列出店铺收款码牌，含 qrCodeId、UPI qrCodeString、可分享 qrPaymentLink 与 qrType。

认证方式：商户会话 Cookie 加用户令牌请求头。

qrCodeId
qrCodeString
qrPaymentLink
qrType
merchantDisplayName

GET /v1/qr-plates?type=ALL HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "qrCodes": [
    {
      "qrCodeId": "QR-20481376",
      "qrCodeString": "upi://pay?pa=verma.store@examplebank&pn=Verma%20General%20Store",
      "qrPaymentLink": "https://pay.example.com/l/Ab12Cd34",
      "qrType": "STATIC",
      "merchantDisplayName": "Verma General Store"
    }
  ]
}

把实体收款码映射到商户

POST /v1/qr-plates/bind opendata

在扫码映射流程后，把扫到的实体收款码牌绑定到已登录商户。

认证方式：商户会话 Cookie 加用户令牌请求头。

qrCodeId
qrCodeString
merchantId
qrType
status

POST /v1/qr-plates/bind HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Content-Type: application/json

{"qrCodeId":"QR-20481376","qrCodeString":"upi://pay?pa=verma.store@examplebank"}

{
  "qrCodeId": "QR-20481376",
  "merchantId": "MRCH10482937461",
  "qrType": "STATIC",
  "status": "MAPPED"
}

付款链接

GET /v1/payment-requests openbanking

列出远程付款链接，含金额、可分享 qrPaymentLink 与 merchantOrderId。

认证方式：商户会话 Cookie 加用户令牌请求头。

qrPaymentLink
txnAmount
merchantDisplayName
status
merchantOrderId

GET /v1/payment-requests?pageNo=1&pageSize=20 HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "links": [
    {
      "qrPaymentLink": "https://pay.example.com/l/Zx98Yw76",
      "txnAmount": "2500.00",
      "merchantDisplayName": "Verma General Store",
      "status": "ACTIVE",
      "merchantOrderId": "PL-20261017-0033"
    }
  ]
}

结算银行资料

GET /v1/merchant/settlement-account openfinance

读取绑定结算银行：脱敏账号、IFSC、户名与已核验姓名。

认证方式：商户会话 Cookie 加用户令牌请求头。

bankAccountNo
bankName
bankIfscCode
bankAccountHolderName
bankVerifiedName

GET /v1/merchant/settlement-account HTTP/1.1
Cookie: session=<session-token>
X-User-Token: <user-token>
Accept: application/json

{
  "bankAccountNo": "4821**7305",
  "bankName": "SAMPLE PAYMENTS BANK LIMITED",
  "bankIfscCode": "SMPL0000001",
  "bankAccountHolderName": "RAJ VERMA",
  "bankVerifiedName": "RAJ VERMA"
}

数据类别

商户资料
交易
结算
收款码
KYC
银行账户

数据使用场景与案例

当日 TWS 对账
夜间财务任务把 TWS orderList 行（merchantOrderId、txnAmount、payerName）接到 settlementBillId 批次与 bankTxnId UTR，杂货店不必等下一轮 Soundbox 报账就能核对 8/13/19 点打款。
收款码牌台账
门店运营工具拉取 qrCodeId、qrCodeString 与 qrPaymentLink，扫到新实体码牌后再提交映射到该 mid。
按 mid 做商户 OSINT
调查方把 merchantId 解析为 merchantDisplayName、bankVerifiedName 与脱敏 bankAccountNo，勾勒用 Paytm 收款码进账的店铺。
在途与已结算货款
ERP 机器人读取钱包看板的 totalAmount、availableAmount 与 amountOnHold，标出 alreadySettledToBank 落后于当日流水的店铺。

常见问题

哪一个标识把 Paytm for Business 店铺和它的收款码绑在一起？

上下文与资料返回 merchantId；收款码列表对每块码牌重复该 mid，并给出 qrCodeId、qrCodeString 与 qrPaymentLink。

入账 UPI 如何识别？

每条钱包流水带 merchantOrderId、acquirementId、txnAmount、payerName、mode 与 settlementStatus。

结算 UTR 出现在哪里？

UTR 明细按 settlementBillId 给出 bankTxnId；结算列表再给出 settlementAmount、settlementBankName 与 settlementTime。

这个应用里的 TWS 是什么？

Today-will-settle：当日打款批次，一日三次的商户通常在 8、13、19 点出账。

与 Paytm for Business 相似的应用

BharatPe for Business — BharatPe for Business 是 Resilient Innovations 面向印度店铺的商户应用，提供 UPI 收款码、BharatPe Speaker 语音播报、BharatPe Swipe 刷卡终端，以及打款到绑定银行账户。
PhonePe Business — PhonePe Business 是 PhonePe 面向印度店铺的商户应用，提供店内收款码贴纸、SmartSpeaker 语音确认、可收银行卡和 UPI 的 POS，以及交易与结算跟踪工具。
Razorpay POS — Razorpay POS 向印度商户提供刷卡终端、Growth DQR 收款码以及可在店内收 UPI 和银行卡的 Bharat Soundbox。
Pine Labs — Pine Labs Mini 是把 POS、UPI 收款码和音箱合在一起的紧凑 Android 设备，印度零售商可用它收拍卡、插卡和二维码付款，并即时语音播报。
Mswipe — Mswipe 是持有印度储备银行支付聚合牌照的收单商，其 Wisepos 终端和 Boombox 音箱让印度店铺可收银行卡、动态 UPI 收款码和付款链接。
PayU — PayU 向印度商户提供店内和上门收款用的 Bharat QR，以及 POS 和覆盖银行卡、UPI 与网银的支付网关。

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

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

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

获取报价

Paytm for Business 商户收款码与结算数据接口

应用截图

API 端点一览

商户会话上下文

商户基本资料

商户 KYC 状态

钱包看板汇总

钱包收款流水

钱包结算报表

结算 UTR 明细

当日结算摘要

TWS 当日订单列表

TWS 结算列表

商户收款码

把实体收款码映射到商户

付款链接

结算银行资料

数据类别

数据使用场景与案例

当日 TWS 对账

收款码牌台账

按 mid 做商户 OSINT

在途与已结算货款

常见问题

与 Paytm for Business 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Paytm for Business 商户收款码与结算数据接口

应用截图

API 端点一览

商户会话上下文

商户基本资料

商户 KYC 状态

钱包看板汇总

钱包收款流水

钱包结算报表

结算 UTR 明细

当日结算摘要

TWS 当日订单列表

TWS 结算列表

商户收款码

把实体收款码映射到商户

付款链接

结算银行资料

数据类别

数据使用场景与案例

当日 TWS 对账

收款码牌台账

按 mid 做商户 OSINT

在途与已结算货款

常见问题

相关应用

与 Paytm for Business 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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