Dhan Barse data API: points, wallet, payout

Goldmedal Electricals Pvt Ltd · Payments 4.4 ★

Dhan Barse is Goldmedal Electricals' official loyalty app for Indian retailers, electricians and counter-boys who sell Goldmedal switches, wires and fittings. After a mobile OTP sign-in, a shop scans product QR codes to credit a cashback wallet, tracks dealer/retailer/counter-boy points (DRP, RRP, CRP), transfers points down the trade, redeems a reward mall, and pays out to a verified Paytm, UPI or bank account with TDS. Goldmedal Electricals Pvt Ltd sits at Mind Space, Chincholi Bunder, Malad West, Mumbai 401208; the Play listing is rated 4.4 from about 128,000 reviews with 1 million-plus downloads and is built in partnership with Paytm. It is a manufacturer loyalty wallet rather than a public UPI app, sitting next to Mitra for Airtel retailers and udaan for B2B stock.

A retailer wallet holds MembershipID, WalletAmount and three point buckets — DRP, RRP, CRP. Each cashback row keys on WalletTransId with TDSAmount; payouts add PayoutStatus, PayoutType and PaymentReferenceNo. Scanned credits and the reward-mall SKU (Sku, Points, HSN) sit on the same session.

Distributor ERPs and shop accountants pull the same wallet, passbook and Paytm-payout rows Goldmedal already shows the retailer — openData Studio turns that trade-loyalty loop into callable open data.

Screenshots

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

Send login OTP
POST /v1/dhanbarse/otp/send osint
Sends the SMS OTP used on the Dhan Barse login screen.
Auth: Unauthenticated. Body is the shop MobileNo. The SMS OTP is later posted to POST /v1/dhanbarse/otp/verify.
- MobileNo
- Status
- Message
```
POST /v1/dhanbarse/otp/send HTTP/1.1
Content-Type: application/json

{
  "MobileNo": "9876543210"
}
```
```
{
  "Status": true,
  "Message": "OTP sent"
}
```
Verify OTP for access token
POST /v1/dhanbarse/otp/verify osint
Exchanges the SMS OTP for the accessToken that gates later wallet, points and payout calls.
Auth: Unauthenticated. Body is MobileNo plus the SMS OTP from POST /v1/dhanbarse/otp/send. The returned accessToken is sent as Authorization: Bearer on later calls.
- MobileNo
- OTP
- accessToken
- ProfileId
- MembershipID
- Username
```
POST /v1/dhanbarse/otp/verify HTTP/1.1
Content-Type: application/json

{
  "MobileNo": "9876543210",
  "OTP": "482193"
}
```
```
{
  "accessToken": "eyJhbGciOi...",
  "ProfileId": "p-44102",
  "MembershipID": "GM-77821",
  "Username": "Ravi Electricals"
}
```

Loyalty dashboard

GET /v1/dhanbarse/dashboard opendata

Returns the home cartouche: WalletAmount plus dealer/retailer/counter-boy point buckets DRP, RRP and CRP.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

MembershipID
Username
WalletAmount
DRP
RRP
CRP
ReferralCode
Pending
Approved
Rejected
PointsConversionValue

GET /v1/dhanbarse/dashboard HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "MembershipID": "GM-77821",
  "Username": "Ravi Electricals",
  "WalletAmount": "12450.00",
  "DRP": 3200.0,
  "RRP": 1800.0,
  "CRP": 450.0,
  "ReferralCode": "RAVI32",
  "Pending": 2,
  "Approved": 14,
  "Rejected": 1,
  "PointsConversionValue": 1
}

Retailer profile

GET /v1/dhanbarse/profile osint

Returns the signed-in shop profile used on KYC and the personal-info screen.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

UserName
UserSurname
MobileNo
Email
Categorynm
Designationnm
ApprovalStatus
RefCode
DateOfBirth

GET /v1/dhanbarse/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "UserName": "Ravi",
  "UserSurname": "Sharma",
  "MobileNo": "9876543210",
  "Email": "[email protected]",
  "Categorynm": "Retailer",
  "Designationnm": "Owner",
  "ApprovalStatus": "Approved",
  "RefCode": "RAVI32",
  "DateOfBirth": "1988-03-12"
}

Retailer points summary
GET /v1/dhanbarse/points/summary opendata
Returns the retailer points summary used by the passbook header.
Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.
- MembershipID
- DRP
- RRP
- CRP
- PointsConversionValue
```
GET /v1/dhanbarse/points/summary HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json
```
```
{
  "MembershipID": "GM-77821",
  "DRP": 3200.0,
  "RRP": 1800.0,
  "CRP": 450.0,
  "PointsConversionValue": 1
}
```

Points passbook

GET /v1/dhanbarse/points/passbook opendata

Pages the points passbook rows shown under My Points.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

rows
TransNo
Points
PointsType
Transtype
Amount
Transactiondt
TransferFrom
TransferTo

GET /v1/dhanbarse/points/passbook HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "rows": [
    {
      "TransNo": "T-90211",
      "Points": "120",
      "PointsType": "DRP",
      "Transtype": "CREDIT",
      "Amount": "120.00",
      "Transactiondt": "2026-09-28",
      "TransferFrom": "Goldmedal",
      "TransferTo": "GM-77821"
    }
  ]
}

Wallet history

GET /v1/dhanbarse/wallet/history opendata

Pages cashback wallet credits and debits, including the TDSAmount withheld on each row.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

rows
WalletTransId
ProfileId
MembershipID
Amount
TDSAmount
TransactionType
CashBackDate
OrderId
CoupenCode

GET /v1/dhanbarse/wallet/history?ProfileId=p-44102 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "rows": [
    {
      "WalletTransId": "w-33190",
      "ProfileId": "p-44102",
      "MembershipID": "GM-77821",
      "Amount": "250.00",
      "TDSAmount": "25.00",
      "TransactionType": "CREDIT",
      "CashBackDate": "2026-09-30",
      "OrderId": "ord-8821",
      "CoupenCode": "CB250"
    }
  ]
}

Scan product QR for cashback

POST /v1/dhanbarse/qr/scan opendata

Credits the cashback wallet from a scanned Goldmedal product QR.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify. Body is the scanned QR payload.

ProfileId
qrPayload
Status
Amount
WalletTransId
MembershipID
Message

POST /v1/dhanbarse/qr/scan HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "ProfileId": "p-44102",
  "qrPayload": "GM|SKU|882199"
}

{
  "Status": true,
  "Amount": "50.00",
  "WalletTransId": "w-33191",
  "MembershipID": "GM-77821",
  "Message": "Cashback credited"
}

Payout history

GET /v1/dhanbarse/payout/history opendata

Lists Paytm / UPI / bank payouts from the cashback wallet.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

rows
TransactionOrderID
ProfileID
Amount
PayoutType
PayoutStatus
AccountName
PaymentReferenceNo
TransactionDate
IsSuccess

GET /v1/dhanbarse/payout/history HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "rows": [
    {
      "TransactionOrderID": "po-10044",
      "ProfileID": "p-44102",
      "Amount": "5000.00",
      "PayoutType": "PAYTM",
      "PayoutStatus": "SUCCESS",
      "AccountName": "Ravi Sharma",
      "PaymentReferenceNo": "PTM882199",
      "TransactionDate": "2026-10-01",
      "IsSuccess": true
    }
  ]
}

Verified payout accounts

GET /v1/dhanbarse/payout/accounts osint

Returns verified Paytm/UPI/bank payout destinations plus the FY TDS cap.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

accounts
UserAccountID
AccountName
WalletAmount
TDSPercent
TDSMessage
TotalFINYearPayout
TDSFINYearPayoutLimit
ManualMinAmount

GET /v1/dhanbarse/payout/accounts HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "accounts": [
    {
      "UserAccountID": "ua-19",
      "AccountName": "Ravi Sharma",
      "WalletAmount": "12450.00",
      "TDSPercent": "10",
      "TDSMessage": "TDS applicable above limit",
      "TotalFINYearPayout": "42000.00",
      "TDSFINYearPayoutLimit": "15000.00",
      "ManualMinAmount": "100"
    }
  ]
}

Reward mall home

GET /v1/dhanbarse/mall/home opendata

Returns the reward-mall home grid of products redeemable with points.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

products
SlNo
Name
Sku
Points
Price
HSN
ProductCategory
Published

GET /v1/dhanbarse/mall/home HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "products": [
    {
      "SlNo": 441,
      "Name": "Mixer grinder",
      "Sku": "GM-MIX-01",
      "Points": 2500,
      "Price": 2499,
      "HSN": "8509",
      "ProductCategory": "Appliances",
      "Published": true
    }
  ]
}

Reward product details

GET /v1/dhanbarse/mall/products/{slNo} opendata

Hydrates a single reward-mall SKU opened from the home grid.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

SlNo
Name
Sku
Points
Price
HSN
StockQuantity
IsFreeShipping
ShortDescription

GET /v1/dhanbarse/mall/products/441 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "SlNo": 441,
  "Name": "Mixer grinder",
  "Sku": "GM-MIX-01",
  "Points": 2500,
  "Price": 2499,
  "HSN": "8509",
  "StockQuantity": 12,
  "IsFreeShipping": true,
  "ShortDescription": "750W mixer"
}

Running schemes

GET /v1/dhanbarse/schemes opendata

Lists live Goldmedal schemes shown on the offers carousel.

Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify.

schemes
schemename
schemetype
fromdate
todate
Link

GET /v1/dhanbarse/schemes HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "schemes": [
    {
      "schemename": "Festive QR bonus",
      "schemetype": "CASHBACK",
      "fromdate": "2026-09-01",
      "todate": "2026-10-31",
      "Link": "https://example.com/scheme"
    }
  ]
}

Direct Paytm transfer
POST /v1/dhanbarse/payout/paytm osint
Pushes a cashback-wallet amount to the shop's verified Paytm account.
Auth: Authorization: Bearer accessToken from POST /v1/dhanbarse/otp/verify. Body names the verified UserAccountID and Amount.
- ProfileId
- UserAccountID
- Amount
- IsSuccess
- TransactionOrderID
- PayoutStatus
- PayoutType
```
POST /v1/dhanbarse/payout/paytm HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "ProfileId": "p-44102",
  "UserAccountID": "ua-19",
  "Amount": "5000.00"
}
```
```
{
  "IsSuccess": true,
  "TransactionOrderID": "po-10045",
  "PayoutStatus": "PENDING",
  "PayoutType": "PAYTM",
  "Amount": "5000.00"
}
```

Where teams use this data

Trade-loyalty ledger into an ERP
Poll GET /v1/dhanbarse/dashboard and GET /v1/dhanbarse/points/passbook so a distributor ERP can mirror MembershipID, WalletAmount, DRP/RRP/CRP and each TransNo.
QR cashback plus TDS snapshot
Join POST /v1/dhanbarse/qr/scan (Amount, WalletTransId) with GET /v1/dhanbarse/wallet/history (TDSAmount) so a shop accountant can see which scans withheld 10% TDS.
Paytm payout reconciliation
Read GET /v1/dhanbarse/payout/accounts (TDSPercent, TDSFINYearPayoutLimit) and GET /v1/dhanbarse/payout/history (PayoutStatus, PaymentReferenceNo) before POST /v1/dhanbarse/payout/paytm.
Reward-mall catalogue sync
Pull GET /v1/dhanbarse/mall/home (Sku, Points, HSN) so a dealer portal can show which SKUs the shop can still redeem.

Frequently asked questions

How does Dhan Barse authenticate API calls?

POST /v1/dhanbarse/otp/send texts an OTP to MobileNo. POST /v1/dhanbarse/otp/verify exchanges MobileNo plus that OTP for accessToken, ProfileId and MembershipID. Later calls send Authorization: Bearer with that accessToken.

Which endpoints expose points, wallet and QR cashback?

GET /v1/dhanbarse/dashboard returns MembershipID, WalletAmount, DRP, RRP and CRP. GET /v1/dhanbarse/points/passbook pages TransNo rows. GET /v1/dhanbarse/wallet/history lists WalletTransId with TDSAmount. POST /v1/dhanbarse/qr/scan credits the wallet from a product QR.

What payout fields are returned?

GET /v1/dhanbarse/payout/accounts returns UserAccountID, TDSPercent and TDSFINYearPayoutLimit. GET /v1/dhanbarse/payout/history lists PayoutStatus, PayoutType and PaymentReferenceNo. POST /v1/dhanbarse/payout/paytm pushes Amount to a verified Paytm account.

Does the API cover the reward mall and schemes?

Yes. GET /v1/dhanbarse/mall/home returns Sku, Points, Price and HSN. GET /v1/dhanbarse/mall/products/{slNo} hydrates one SKU. GET /v1/dhanbarse/schemes lists schemename, schemetype, fromdate and todate.

Apps similar to Dhan Barse

Paytm — Paytm is the consumer wallet Dhan Barse pays out to; the listing is built in partnership with Paytm.
Mitra — Mitra is Airtel's retailer app: a trade-channel client for shopkeepers, parallel to Goldmedal's electrical-counter loyalty wallet.
udaan: B2B for Retailers — udaan is an Indian B2B marketplace for kirana and trade retailers, overlapping Dhan Barse's shop-keeper audience.
Vyapar Invoice GST Billing App — Vyapar is an Indian GST billing app used by the same electrical retailers who scan Goldmedal QR codes.
IndiaMART - B2B Marketplace — IndiaMART is the public B2B directory electrical wholesalers use alongside manufacturer loyalty apps.
IndianOil ONE — IndianOil ONE is a state-energy loyalty wallet: points and payouts, a consumer analogue of Dhan Barse's trade cashback.
Goldmedal Electricals — The manufacturer behind Dhan Barse; its switches, wires and MCBs carry the QR codes the app scans for cashback.

More Payments apps

Topics

dhan barse api
goldmedal loyalty api
MembershipID WalletAmount DRP
dhan barse qr cashback
paytm payout tds
goldmedal retailer wallet
dhan barse points passbook
india electrical loyalty api

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

NDA + SOW on every engagement
Delivery in 3–7 days
Payment only after acceptance
Work scoped to authorized use

Get a quote

Dhan Barse data API: points, wallet, payout

Screenshots

API surface

Send login OTP

Verify OTP for access token

Loyalty dashboard

Retailer profile

Retailer points summary

Points passbook

Wallet history

Scan product QR for cashback

Payout history

Verified payout accounts

Reward mall home

Reward product details

Running schemes

Direct Paytm transfer

Data categories

Where teams use this data

Trade-loyalty ledger into an ERP

QR cashback plus TDS snapshot

Paytm payout reconciliation

Reward-mall catalogue sync

Frequently asked questions

Apps similar to Dhan Barse

More Payments apps

CashBook - Balance & Expense

IndianOil ONE

inyad Konnash: Bookkeeping App

Paytm

Topics

Need this app's data API integrated?

Dhan Barse data API: points, wallet, payout

Screenshots

API surface

Send login OTP

Verify OTP for access token

Loyalty dashboard

Retailer profile

Retailer points summary

Points passbook

Wallet history

Scan product QR for cashback

Payout history

Verified payout accounts

Reward mall home

Reward product details

Running schemes

Direct Paytm transfer

Data categories

Where teams use this data

Trade-loyalty ledger into an ERP

QR cashback plus TDS snapshot

Paytm payout reconciliation

Reward-mall catalogue sync

Frequently asked questions

Related apps

Apps similar to Dhan Barse

More Payments apps

CashBook - Balance & Expense

IndianOil ONE

inyad Konnash: Bookkeeping App

Paytm

Topics

Need this app's data API integrated?