udaan 零售商数据 API
udaan: B2B for Retailers 是 udaan 面向采购方的应用。udaan 是 Hiveloop Technology 运营的 B2B 批发市场,2016 年由前 Flipkart 高管 Amod Malviya、Sujeet Kumar 与 Vaibhav Gupta 在班加罗尔创立。零售商用手机号 OTP 登录后,可以在首页的品类栏目里浏览,或用搜索框配合品牌、品类筛选标签查找商品,再把多家卖家的货放进按卖家拆分、可叠加促销的购物车。结账时选择配送时段与预计送达日期,用 UdaanPay 电子钱包、CreditBuy 贸易赊购或 UPI 付款;“Your Orders”按发票与 AWB 运单跟踪发货,退货流程会预约上门取件并办理退款。Credit 标签页展示贸易信用额度,CreditBuy 账本列出待付发票与还款日,Udaan Coins 按月度目标计划累积,Shop KYC 引导流程核验店铺的 GST、FSSAI 与 PAN 登记,Manage Bank Accounts 则管理钱包提现与 CreditBuy 还款所用的银行账户。它服务印度的夫妻店(kirana)、药店以及酒店餐饮(HoReCa)采购方,让他们绕开层层本地中间商,直接从品牌、分销商与批发商补进品牌快消品、主食杂货与药品;作为印度最大的 B2B 市场之一,它在小型零售商供货领域与 Reliance 的 JioMart Partner、Flipkart Wholesale 和 Jumbotail 竞争。
批发目录里以 paise 计价的 MRP 商品是这套零售商记录的起点:每张目录卡片与搜索结果都带有 listingId、listingTitle、brandName 与 mrpPaise,以及背后批发卖家的 sellerOrgId 和 sellerName。同一批 id 流入按卖家拆分的购物车(cartLineId、qty、promotionId、payableAmount),再进入结账订单表单,附带 deliverySlotId、expectedDeliveryDate 与可选的 paymentMethods。下单后的订单补上 invoiceId、shipmentStatus 与 awbNumber,买家退货则记录 returnQty、returnReason、refundAmountPaise 与逆向取件的 pickupSlot——所有金额均以 paise 存储。
贸易信用按额度逐条记录——creditLineId、creditLimitPaise、availableCreditPaise、creditLimitUsed、outstandingAmount——CreditBuy 账本则列出与发票关联的 drawdownIds 及其 repaymentDueDate。UdaanPay 钱包给出 walletBalanceInPaise、udaanCoins 余额与 vpa;月度金币账本把金币与 targets_definition_id 目标计划挂钩;已保存的提现账户带有 ifscCode、bankName 与脱敏的 accountNumber。采购组织本身由 shopName、gstin、fssai 与 pincode 描述,其 kycStatus 以 panNumber、脱敏的 aadhaar 和 marketTypes 为依据。
夫妻店的门店运营机器人靠这套记录补货:从目录取 MRP 与 listing id,下单前在购物车里确认数量与应付金额。记账人员每晚按发票核对 CreditBuy 提款与可用额度、未结余额,让店铺台账与资金方账目一致。入驻审核团队在开通零售商首条信用额度前核查 GSTIN、FSSAI、PAN 与 KYC 状态;财务在钱包转银行前读取钱包余额,并核对 IFSC 与账号以确认收款账户。openData Studio 把 udaan 的目录、购物车、信用、钱包与 KYC 记录变成可调用的开放数据,供这些场景直接接入。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
手机号登录与条款确认
POST
/v1/auth/otp-sessionopendataOTP 验证后开启已登录的零售商会话。返回的刷新令牌与会话 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" }零售商组织资料
GET
/v1/organisation/profileosint返回已登录的采购组织——店铺名称、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-groupsopendata为市场首页的类目频道供数:分组与类目 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/refineopendata为应用内搜索框返回分面搜索结果——品牌、类目、商品 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/snapshotopendata读取零售商即将结账的按卖家拆分购物车:行项目数量、以派萨计的 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-orderopendata基于当前购物车构建结账表单:配送时段、预计送达日期、应付派萨金额,以及零售商可选的支付方式(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/historyopendata分页返回“你的订单”列表,携带发票、配送、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-linesopenfinance列出 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 }] }CreditBuy 台账
GET
/v1/financing/bnpl-ledgeropenfinance分页返回 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/snapshotopenbanking返回 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-stateosint读取入驻向导所门槛的店铺 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"] }奖励月度台账
GET
/v1/rewards/monthly-ledgeropendata分页返回与目标任务挂钩的 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-accountsopenbanking列出“管理银行账户”界面的打款账户——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-summaryopendata汇总进行中的买家退货——数量、原因、以派萨计的退款与 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 杂货与快消批发业务,依托集团的零售供应链为社区小店供货。
相关主题
- udaan api
- udaan b2b
- 夫妻店批发
- 贸易信用
- creditbuy 台账
- udaanpay 电子钱包
- 店铺 kyc gstin
- hiveloop 信用
- 类目分组目录
- 零售商订单
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业