> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bill Payments (BBPS)

> Use Razorpay's BBPS APIs to fetch billers, fetch bill amounts and initiate bill payments via Bharat Bill Payment System.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

Razorpay is a Customer Operating Unit (COU) on the [Bharat Bill Payment System (BBPS)](https://www.npci.org.in/what-we-do/bharat-billpay/about), 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](/docs/api/bills/bill-payments/fetch-biller-categories) - retrieve all available bill categories.
2. [Fetch Billers](/docs/api/bills/bill-payments/fetch-billers) - list billers within a category.
3. [Fetch Biller Plans](/docs/api/bills/bill-payments/fetch-biller-plans) - retrieve available plans for a biller (where applicable).
4. [Create a Bill Request](/docs/api/bills/bill-payments/create-bill-request) - retrieve the bill amount for a customer from the biller.
5. [Fetch Bill Request](/docs/api/bills/bill-payments/fetch-bill-request) - poll for the bill retrieval result.
6. [Create a Bill Payment](/docs/api/bills/bill-payments/create-bill-payment) - initiate payment for the fetched bill.
7. [Fetch Bill Payment](/docs/api/bills/bill-payments/fetch-bill-payment) - poll for the payment result.

<Info>
  **Asynchronous APIs**

  Bill 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`).
</Info>

Fork the Razorpay Postman Public Workspace and try the Bill Payments APIs using your [Test API Keys](/docs/api/authentication#generate-api-keys).

<a href="https://www.postman.com/razorpaydev/workspace/razorpay-public-workspace" target="_blank">![Run in Postman](https://run.pstmn.io/button.svg)</a>

<CardGroup cols={2}>
  <Card title="Fetch Biller Categories" href="/docs/api/bills/bill-payments/fetch-biller-categories">
    `GET` `/v1/bill_payments/billers/categories`

    Retrieves all available biller categories on the BBPS platform.
  </Card>

  <Card title="Fetch Billers" href="/docs/api/bills/bill-payments/fetch-billers">
    `GET` `/v1/bill_payments/billers`

    Retrieves a list of billers for a given category.
  </Card>

  <Card title="Fetch Biller Plans" href="/docs/api/bills/bill-payments/fetch-biller-plans">
    `GET` `/v1/bill_payments/biller_plans`

    Retrieves available plans offered by a specific biller.
  </Card>

  <Card title="Create a Bill Request" href="/docs/api/bills/bill-payments/create-bill-request">
    `POST` `/v1/bill_payments/bill_requests`

    Initiates an asynchronous request to retrieve the bill amount for a customer from the biller.
  </Card>

  <Card title="Fetch Bill Request" href="/docs/api/bills/bill-payments/fetch-bill-request">
    `GET` `/v1/bill_payments/bill_requests/:id`

    Retrieves the status and details of a bill request.
  </Card>

  <Card title="Create a Bill Payment" href="/docs/api/bills/bill-payments/create-bill-payment">
    `POST` `/v1/bill_payments/payments`

    Initiates an asynchronous bill payment for a fetched bill.
  </Card>

  <Card title="Fetch Bill Payment" href="/docs/api/bills/bill-payments/fetch-bill-payment">
    `GET` `/v1/bill_payments/payments/:id`

    Retrieves the status and details of a bill payment.
  </Card>
</CardGroup>

## Related Guides

* [About BBPS Integration](/docs/pos/billme/bbps)
* [Authentication](/docs/api/authentication)
* [Bill Payments Webhook Events](/docs/webhooks/bbps)