---
title: "PUT /billpay/update-status"
method: PUT
path: "/billpay/update-status"
deprecated: true
---

# PUT /billpay/update-status

`PUT /billpay/update-status`

> **Deprecated.**

**Deprecated.** Use PATCH /billpay/{billPayNumber} with body { billStatus } instead. Updates the status of a BillPay reference. Inactive references will be rejected during verification and confirmation.

## Request body

- object
  - `billPayNumber` string, required — The BillPay reference number to update
  - `status` 'ACTIVE' | 'INACTIVE', required — The status to set for the BillPay reference. ACTIVE allows payments to be processed, INACTIVE prevents payments from being processed.

## Response `200`

Successfully updated BillPay reference status

- StatusUpdateResponse
  - `billPayNumber` string — The BillPay reference number that was updated
  - `status` 'ACTIVE' | 'INACTIVE' — The updated status of the BillPay reference

## 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)