---
title: "PATCH /billpay/{billPayNumber}"
method: PATCH
path: "/billpay/{billPayNumber}"
---

# PATCH /billpay/{billPayNumber}

`PATCH /billpay/{billPayNumber}`

Partially updates a BillPay reference. Use to update amount, description, payment mode, or status without recreating the reference.

## Path parameters

- `billPayNumber` string, required

## Request body

- object
  - `billStatus` 'ACTIVE' | 'INACTIVE' — Status of the BillPay reference
  - `billAmount` number — Amount of the bill (positive, max 2 decimal places)
  - `billDescription` string — Description of the bill
  - `billPaymentMode` 'ALLOW_PARTIAL_AND_OVER_PAYMENT' | 'EXACT' — Payment mode

## Response `200`

Successfully updated BillPay reference

- UpdateBillPayReferenceResponse
  - `billPayNumber` string — The BillPay reference number that was updated
  - `billStatus` 'ACTIVE' | 'INACTIVE' — The updated status of the BillPay reference
  - `billAmount` number — Amount of the bill
  - `billDescription` string — Description of the bill
  - `billPaymentMode` 'ALLOW_PARTIAL_AND_OVER_PAYMENT' | 'EXACT' — Payment mode

## Other responses

- `400` — Validation Error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/clickpesa/apis/core-api-openapi-specification.md) · [All operations](https://skmtc.net/clickpesa/apis/core-api-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickpesa/core-api-openapi-specification/versions/9f70f35c5590/schema)