Skip to main content
Available in🇮🇳 India
Razorpay is a Customer Operating Unit (COU) on the Bharat Bill Payment System (BBPS), India’s interoperable bill payment platform managed by NPCI. Using these APIs, you can integrate bill payment collection into your platform and allow customers to pay utility bills, recharges, insurance premiums and more. Integration Flow
  1. Fetch Biller Categories - retrieve all available bill categories.
  2. Fetch Billers - list billers within a category.
  3. Fetch Biller Plans - retrieve available plans for a biller (where applicable).
  4. Create a Bill Request - retrieve the bill amount for a customer from the biller.
  5. Fetch Bill Request - poll for the bill retrieval result.
  6. Create a Bill Payment - initiate payment for the fetched bill.
  7. Fetch Bill Payment - poll for the payment result.
Asynchronous APIsBill Request and Bill Payment APIs are asynchronous. After creating a resource, poll the corresponding Fetch API until the status reaches a terminal state (success or failed).
Fork the Razorpay Postman Public Workspace and try the Bill Payments APIs using your Test API Keys. Run in Postman

Fetch Biller Categories

GET /v1/bill_payments/billers/categoriesRetrieves all available biller categories on the BBPS platform.

Fetch Billers

GET /v1/bill_payments/billersRetrieves a list of billers for a given category.

Fetch Biller Plans

GET /v1/bill_payments/biller_plansRetrieves available plans offered by a specific biller.

Create a Bill Request

POST /v1/bill_payments/bill_requestsInitiates an asynchronous request to retrieve the bill amount for a customer from the biller.

Fetch Bill Request

GET /v1/bill_payments/bill_requests/:idRetrieves the status and details of a bill request.

Create a Bill Payment

POST /v1/bill_payments/paymentsInitiates an asynchronous bill payment for a fetched bill.

Fetch Bill Payment

GET /v1/bill_payments/payments/:idRetrieves the status and details of a bill payment.