udaan 零售商数据 API

Udaan.com · 电商

udaan 是印度夫妻店、药店与餐饮（HoReCa）采购方使用的 B2B 批发应用，可采购品牌日百商品，在结账时使用 Hiveloop 贸易信用额度，或从内置电子钱包付款。它是印度最大的 B2B 市场之一，覆盖快消、医药与生活方式品类，连接小型零售商与品牌及分销商。

作为数据源，该应用呈现完整的零售商工作流：携带 gstin 与 kycStatus 的商户资料、带 mrpPaise 与 sellerOrgId 的目录商品、按卖家拆分的购物车、带 awbNumber 的订单配送、含 availableCreditPaise 与 outstandingAmount 的信用额度，以及钱包余额与已保存的提现账户。集成方在其之上构建补货机器人、信用对账、GST/KYC 入驻核查与打款路由。

udaan: B2B for Retailers 是 Hiveloop Technology 面向印度的 B2B 批发市场应用，夫妻店、药店与餐饮（HoReCa）采购方在应用内浏览品牌快消目录、跨卖家拼车下单，以贸易信用额度或内置电子钱包结账，并跟踪配送进度。这些界面背后是一套完整的零售商数据集：含 GSTIN 与 KYC 状态的店铺资料、带 MRP 的目录商品、按卖家拆分的购物车与订单、挂接发票的信用支用记录、钱包余额与提现银行账户。这些数据可支撑自动补货、营运资金对账、GST/KYC 入驻核查与打款集成。

应用截图

API 端点一览

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

手机号登录与条款确认
POST /v1/auth/otp-session opendata
OTP 验证后开启已登录的零售商会话。返回的刷新令牌与会话 Cookie 将附加到之后每一次目录、购物车、信用与 KYC 调用。
认证方式：无需认证的引导调用。查询字符串中的客户端 ID 标识 Android 应用；响应的 Set-Cookie 即会话，之后的每次调用都会携带。
- orgId
- orgUnitId
- userId
- phoneNumber
- refreshToken
- isSignupUser
- appFlavour
```
POST /v1/auth/otp-session?cid=android-client HTTP/1.1
Content-Type: application/json
x-app-flavour: kirana

{
  "phoneNumber": "9876543210",
  "otp": "482193",
  "deviceId": "a1b2c3d4e5f6",
  "acceptTnc": true
}
```
```
{
  "orgId": "org_7c11ab",
  "orgUnitId": "ou_91f2",
  "userId": "usr_44aa",
  "phoneNumber": "9876543210",
  "refreshToken": "rt_8f21c0",
  "isSignupUser": false,
  "appFlavour": "kirana"
}
```
- 依据应用的手机号 OTP 登录流程重建。
- 配套调用负责刷新会话并记录条款确认。
零售商组织资料
GET /v1/organisation/profile osint
返回已登录的采购组织——店铺名称、GSTIN、FSSAI 许可与 KYC 标记——账户与结账界面会将这些信息印在订单上。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- orgId
- orgUnitId
- shopName
- businessName
- gstin
- gstinNumber
- fssai
- pincode
- kycStatus
```
GET /v1/organisation/profile HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "orgId": "org_7c11ab",
  "orgUnitId": "ou_91f2",
  "shopName": "Sharma Kirana Store",
  "businessName": "Sharma Traders",
  "gstin": "29AABCU9603R1ZX",
  "gstinNumber": "29AABCU9603R1ZX",
  "fssai": "11223344556677",
  "pincode": "560001",
  "kycStatus": "VERIFIED"
}
```
- 与账户及结账界面展示的商户信息一致。
- 相关调用返回组织单元及含位置的紧凑资料。
目录类目分组
GET /v1/catalog/browse-groups opendata
为市场首页的类目频道供数：分组与类目 ID、商品标题、以派萨计的 MRP，以及每张卡片背后的卖家组织。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- categoryGroupId
- categoryId
- brandName
- listingTitle
- listingId
- mrpPaise
- sellerOrgId
- sellerName
```
GET /v1/catalog/browse-groups HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "categoryGroups": [{
    "categoryGroupId": "cg_fmcg",
    "categoryId": "cat_staples",
    "brandName": "Aashirvaad",
    "listingTitle": "Aashirvaad Atta 10 kg",
    "listingId": "lst_9k21",
    "mrpPaise": 42500,
    "sellerOrgId": "org_seller_11",
    "sellerName": "Karnataka Staples Hub"
  }]
}
```
- 与登录后应用渲染的市场首页类目频道一致。
- 相关调用解析按应用形态区分的商品列表与品牌页。
搜索筛选
GET /v1/search/refine opendata
为应用内搜索框返回分面搜索结果——品牌、类目、商品 ID 与 MRP——供商品搜索与筛选标签使用。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- searchType
- q
- brandId
- brandName
- categoryId
- listingId
- mrpPaise
- qty
```
GET /v1/search/refine?q=atta&brandId=br_aashirvaad HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "searchType": "product",
  "q": "atta",
  "facets": [{
    "brandId": "br_aashirvaad",
    "brandName": "Aashirvaad",
    "categoryId": "cat_staples",
    "listingId": "lst_9k21",
    "mrpPaise": 42500,
    "qty": 24
  }]
}
```
- 支撑应用内搜索框及其筛选标签。
- 相关调用提供品牌与药品的自动补全。
卖家购物车快照
GET /v1/basket/snapshot opendata
读取零售商即将结账的按卖家拆分购物车：行项目数量、以派萨计的 MRP 与应付金额，以及已应用的促销。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- cartId
- resource_id
- sellerOrgId
- promotionId
- cartLineId
- listingId
- qty
- mrpPaise
- amountPaise
- payableAmount
```
GET /v1/basket/snapshot?resource_id=org_seller_11 HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "cartId": "cart_88c1",
  "resource_id": "org_seller_11",
  "sellerOrgId": "org_seller_11",
  "promotionId": "promo_dotd",
  "lines": [{
    "cartLineId": "cl_01",
    "listingId": "lst_9k21",
    "qty": 4,
    "mrpPaise": 42500,
    "amountPaise": 170000
  }],
  "payableAmount": 170000
}
```
- 与结账界面读取的按卖家拆分购物车一致。
- 配套调用负责添加行项目并读取卖家级购物篮。
准备结账订单表单
POST /v1/checkout/draft-order opendata
基于当前购物车构建结账表单：配送时段、预计送达日期、应付派萨金额，以及零售商可选的支付方式（UdaanPay、CreditBuy、UPI）。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- orderFormId
- cartId
- deliverySlotId
- expectedDeliveryDate
- payableAmount
- amountInPaise
- paymentMethods
```
POST /v1/checkout/draft-order HTTP/1.1
Cookie: session=<session>
Content-Type: application/json
x-app-flavour: kirana

{
  "cartId": "cart_88c1",
  "orgId": "org_7c11ab",
  "orgUnitId": "ou_91f2",
  "deliverySlotId": "slot_thu_am"
}
```
```
{
  "orderFormId": "of_3310",
  "cartId": "cart_88c1",
  "deliverySlotId": "slot_thu_am",
  "expectedDeliveryDate": "2026-10-02",
  "payableAmount": 170000,
  "amountInPaise": 170000,
  "paymentMethods": ["UDAAN_PAY", "CREDIT_BUY", "UPI"]
}
```
- 依据将购物车转为应付订单的结账流程重建。
- 配套调用列出支付方式与配送时段。
零售商订单列表
GET /v1/orders/history opendata
分页返回“你的订单”列表，携带发票、配送、AWB 与预计送达字段，供订单详情与物流跟踪界面渲染。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- orderId
- invoiceId
- sellerOrgId
- shipmentId
- orderDate
- expectedDeliveryDate
- shipmentStatus
- awbNumber
- payableAmount
```
GET /v1/orders/history HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "orders": [{
    "orderId": "ord_5e20",
    "invoiceId": "inv_4411",
    "sellerOrgId": "org_seller_11",
    "shipmentId": "shp_19aa",
    "orderDate": "2026-09-28",
    "expectedDeliveryDate": "2026-10-02",
    "shipmentStatus": "OUT_FOR_DELIVERY",
    "awbNumber": "UDEX123456789",
    "payableAmount": 170000
  }]
}
```
- 分页支撑订单详情与跟踪界面背后的“你的订单”列表。
- 相关调用分页返回已完结订单、即将到来的配送与订单详情。
贸易信用额度
GET /v1/financing/credit-lines openfinance
列出 Credit 标签页上的 Hiveloop 贸易信用额度：以派萨计的核准与可用限额、已用限额与未结应付。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- creditLineId
- creditLineName
- availableCreditPaise
- availableLimit
- creditLimitPaise
- creditLimitUsed
- sanctionedAmount
- outstandingAmount
```
GET /v1/financing/credit-lines HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "creditLines": [{
    "creditLineId": "cln_88",
    "creditLineName": "Hiveloop Trade Credit",
    "availableCreditPaise": 25000000,
    "availableLimit": 250000,
    "creditLimitPaise": 50000000,
    "creditLimitUsed": 25000000,
    "sanctionedAmount": 50000000,
    "outstandingAmount": 25000000
  }]
}
```
- 与应用 Credit 标签页上的额度卡片一致。
- 相关调用分页返回付款明细与还款选项。
CreditBuy 台账
GET /v1/financing/bnpl-ledger openfinance
分页返回 CreditBuy 流水账——挂接发票的支用记录、未结派萨金额与还款到期日——即融资/待付发票界面展示的内容。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- page_num
- creditLineId
- invoiceId
- drawdownIds
- amountPaise
- outstandingAmount
- repaymentDueDate
- status
```
GET /v1/financing/bnpl-ledger?page_num=1 HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "page_num": 1,
  "entries": [{
    "creditLineId": "cln_88",
    "invoiceId": "inv_4411",
    "drawdownIds": ["dd_102"],
    "amountPaise": 170000,
    "outstandingAmount": 170000,
    "repaymentDueDate": "2026-10-15",
    "status": "OPEN"
  }]
}
```
- 依据待付发票流水账流程重建。
- 相关调用列出待结算支用与近期账单。
电子钱包摘要
GET /v1/wallet/snapshot openbanking
返回 UdaanPay 电子钱包快照——以派萨计的余额、Udaan Coin 数量与 VPA——供预付款钱包卡片与收款页脚使用。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- walletBalanceInPaise
- udaanCoins
- orgId
- vpa
- currency
```
GET /v1/wallet/snapshot HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "walletBalanceInPaise": 125000,
  "udaanCoins": 340,
  "orgId": "org_7c11ab",
  "vpa": "sharma@udaan",
  "currency": "INR"
}
```
- 支撑钱包卡片与收款页脚。
- 配套调用将钱包资金转出至银行账户。
店铺 KYC 状态
GET /v1/compliance/kyc-state osint
读取入驻向导所门槛的店铺 KYC 状态：GSTIN、PAN、Aadhaar 掩码与市场类型，与“店铺 KYC 状态”界面一致。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- kycStatus
- gstin
- panNumber
- aadhaar
- shopName
- marketTypes
```
GET /v1/compliance/kyc-state HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "kycStatus": "VERIFIED",
  "gstin": "29AABCU9603R1ZX",
  "panNumber": "AABCU9603R",
  "aadhaar": "masked",
  "shopName": "Sharma Kirana Store",
  "marketTypes": ["KIRANA", "FMCG"]
}
```
- 与入驻向导的“店铺 KYC 状态”界面一致。
- 相关调用读取 KYC 资料、市场类型与 PAN 上传状态。
奖励月度台账
GET /v1/rewards/monthly-ledger opendata
分页返回与目标任务挂钩的 Udaan Coin 月度台账——按商品数量计入的奖励币——即奖励/目标任务界面展示的内容。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- page
- udaanCoins
- targets_definition_id
- listingId
- qty
- status
```
GET /v1/rewards/monthly-ledger?page=1 HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "page": 1,
  "udaanCoins": 340,
  "entries": [{
    "targets_definition_id": "tgt_sep26",
    "listingId": "lst_9k21",
    "qty": 4,
    "udaanCoins": 20,
    "status": "CREDITED"
  }]
}
```
- 分页支撑奖励界面背后的月度奖励币台账。
- 相关调用给出目标任务细则与台账优惠。
已保存银行账户
GET /v1/payouts/bank-accounts openbanking
列出“管理银行账户”界面的打款账户——IFSC、掩码账号与收款人——用于钱包转银行与 CreditBuy 还款。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- ifscCode
- bankName
- accountNumber
- accountHolderName
- beneficiaryName
- orgId
```
GET /v1/payouts/bank-accounts HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "accounts": [{
    "ifscCode": "HDFC0000123",
    "bankName": "HDFC Bank",
    "accountNumber": "XXXXXX3210",
    "accountHolderName": "Ravi Sharma",
    "beneficiaryName": "Ravi Sharma",
    "orgId": "org_7c11ab"
  }]
}
```
- 列出“管理银行账户”界面的打款去向。
- 相关调用覆盖钱包转银行转账与发票明细。
买家退货摘要
GET /v1/returns/buyer-summary opendata
汇总进行中的买家退货——数量、原因、以派萨计的退款与 RVP 取件时段——供退货汇总与退货详情界面使用。
认证方式：会话 Cookie 由手机号 OTP 登录签发；查询字符串携带客户端 ID，后续调用附带应用形态请求头。
- returnId
- orderId
- listingId
- returnQty
- returnReason
- refundAmountPaise
- pickupSlot
```
GET /v1/returns/buyer-summary HTTP/1.1
Cookie: session=<session>
x-app-flavour: kirana
```
```
{
  "returns": [{
    "returnId": "ret_77c",
    "orderId": "ord_5e20",
    "listingId": "lst_9k21",
    "returnQty": 1,
    "returnReason": "Damaged pack",
    "refundAmountPaise": 42500,
    "pickupSlot": "2026-10-03T09:00:00+05:30"
  }]
}
```
- 汇总退货界面上的进行中买家退货。
- 相关调用获取退货政策配置与退货详情。

数据类别

商品目录
购物车
订单
贸易信用
电子钱包
店铺 KYC
奖励
银行账户
退货

数据使用场景与案例

夫妻店自动补货
门店运营机器人拉取 /v1/catalog/browse-groups 与 /v1/search/refine 获取 MRP 与 listingId，再读取 /v1/basket/snapshot 确认 qty 与 payableAmount，随后才由零售商下单。
CreditBuy 营运资金对账
记账方每晚读取 /v1/financing/credit-lines（availableCreditPaise、outstandingAmount），并分页遍历 /v1/financing/bnpl-ledger 中的 invoiceId 支用记录，使店铺台账与资金方账目保持一致。
GST 与店铺 KYC 入驻核查
入驻审核在签发零售商首笔信用额度前，先调用 /v1/organisation/profile 获取 gstin 与 fssai，再调用 /v1/compliance/kyc-state 核对 kycStatus 与 panNumber。
钱包提现至店铺银行账户
财务在钱包转银行之前读取 /v1/wallet/snapshot（walletBalanceInPaise）与 /v1/payouts/bank-accounts（ifscCode、accountNumber），确认收款账户无误。

常见问题

udaan 应用加载哪些目录字段？

GET /v1/catalog/browse-groups 为市场首页频道返回 categoryGroupId、listingId、listingTitle、mrpPaise、sellerOrgId 与 sellerName；/v1/search/refine 的搜索细化再补充 brandId 与 qty。

贸易信用在 Credit 标签页如何呈现？

GET /v1/financing/credit-lines 列出 creditLineId、availableCreditPaise、creditLimitPaise、sanctionedAmount 与 outstandingAmount；发票级支用记录在 /v1/financing/bnpl-ledger 分页返回。

零售商会话如何认证？

在 POST /v1/auth/otp-session 完成手机号 OTP 登录后签发会话 Cookie；后续调用携带该 Cookie，外加查询参数中的客户端 ID 与应用形态请求头。这些是登录后使用的第一方接口，并非公开的开发者 API。

UdaanPay 钱包余额在哪里？

GET /v1/wallet/snapshot 返回 walletBalanceInPaise、udaanCoins 与 vpa；已保存的提现账户（ifscCode、accountNumber、beneficiaryName）来自 /v1/payouts/bank-accounts。

与 udaan: B2B for Retailers 相似的应用

IndiaMART — IndiaMART 是印度最大的在线 B2B 市场，零售商在这里按全品类寻找供应商并发起询价，而不是从平台自营的批发目录下单。
Jumbotail — Jumbotail 是面向印度夫妻店的全自营 B2B 食品杂货批发平台，自建仓储物流，支持次日达且没有最低起订量。
Flipkart Wholesale — Flipkart Wholesale 是沃尔玛支持的 B2B 批发平台，在 Flipkart 收购沃尔玛印度 Best Price 现购自运业务后服务于夫妻店和小型零售商。
Amazon Business — Amazon Business 把亚马逊的履约体系带入印度 B2B 采购，提供符合 GST 要求的发票和多品类的批量采购价。
ElasticRun — ElasticRun 以轻资产模式运营快消品分销网络，把品牌商品铺到印度农村地区的零售小店。
Badho — Badho 是一款面向夫妻店的快消品 B2B 订货应用，它选择与现有分销商合作，而不是在传统流通渠道中绕过他们。
JioMart Digital — JioMart Digital 是信实集团旗下的 B2B 杂货与快消批发业务，依托集团的零售供应链为社区小店供货。

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

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

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

获取报价

udaan 零售商数据 API

应用截图

API 端点一览

手机号登录与条款确认

零售商组织资料

目录类目分组

搜索筛选

卖家购物车快照

准备结账订单表单

零售商订单列表

贸易信用额度

CreditBuy 台账

电子钱包摘要

店铺 KYC 状态

奖励月度台账

已保存银行账户

买家退货摘要

数据类别

数据使用场景与案例

夫妻店自动补货

CreditBuy 营运资金对账

GST 与店铺 KYC 入驻核查

钱包提现至店铺银行账户

常见问题

与 udaan: B2B for Retailers 相似的应用

更多电商类应用

IndiaMART - B2B Marketplace

相关主题

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

udaan 零售商数据 API

应用截图

API 端点一览

手机号登录与条款确认

零售商组织资料

目录类目分组

搜索筛选

卖家购物车快照

准备结账订单表单

零售商订单列表

贸易信用额度

CreditBuy 台账

电子钱包摘要

店铺 KYC 状态

奖励月度台账

已保存银行账户

买家退货摘要

数据类别

数据使用场景与案例

夫妻店自动补货

CreditBuy 营运资金对账

GST 与店铺 KYC 入驻核查

钱包提现至店铺银行账户

常见问题

相关应用

与 udaan: B2B for Retailers 相似的应用

更多电商类应用

IndiaMART - B2B Marketplace

相关主题

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