BBPS — Bill Payment
Bharat Connect bill payments across 30 categories and 22,000+ billers. Read the biller catalogue, fetch the live bill, then pay against the token the fetch returns.
Base: /ext/v1/bbps
Permission: bills
Wallet: MAIN
Per transaction: ₹1 – ₹2,00,000
Platform charge: Nil
PENDING is not a failure
Bharat Connect does not register a transaction the instant it is submitted. Never re-send a PENDING payment under a new client_reference — poll /transaction/{reference_id} instead. A FAILED payment is refunded automatically under REV-<reference_id>, so nothing is owed.
Integration flow
1
/categories
List the 30 live categories.
2
/billers
Search billers inside a category.
3
/biller/{id}
Read the exact input fields the biller demands.
4
/bill/fetch
Fetch the bill, receive a bill_token (15 min).
5
/bill/pay
Pay with TPIN and your idempotency key.
Endpoints
Biller Catalogue
GET
/ext/v1/bbps/categories
All live categories with biller counts
GET
/ext/v1/bbps/billers
Search billers inside a category
GET
/ext/v1/bbps/biller/{biller_id}
The exact input fields this biller requires
GET
/ext/v1/bbps/balance
MAIN wallet balance and payment limits
Fetch & Pay
POST
/ext/v1/bbps/bill/fetch
Fetch the live bill and open a payment context
POST
/ext/v1/bbps/bill/pay
Pay against the bill_token — TPIN and idempotency key required
Status, History & Complaints
GET
/ext/v1/bbps/transaction/{reference_id}
Single transaction — re-checks the biller while PENDING
GET
/ext/v1/bbps/transaction/by-client-reference/{client_reference}
Look up by your own idempotency key
GET
/ext/v1/bbps/transactions
Paginated bill payment history
POST
/ext/v1/bbps/complaint
Raise a Bharat Connect complaint on a SUCCESS transaction
GET
/ext/v1/bbps/complaint/{complaint_id}
Track a registered complaint