POST
/
billpay
/
create-customer-control-number
cURL
curl --request POST \
  --url https://api.clickpesa.com/third-parties/billpay/create-customer-control-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "billDescription": "Water Bill - July 2024",
  "billPaymentMode": "EXACT",
  "billAmount": 90900,
  "billReference": "CUSTOMJH121",
  "customerName": "John Doe",
  "customerEmail": "john@example.com",
  "customerPhone": "255712345678"
}'
{
  "billPayNumber": "55042914871931",
  "billDescription": "Generic Bamboo Chees",
  "billCustomerName": "Mr. Freddie Walker-Graham",
  "billAmount": 90900,
  "billPaymentMode": "EXACT"
}

Authorizations

​
Authorization
string
header
required

Authorization header containing the JWT access token returned from the generate token endpoint. The token already includes the Bearer prefix. Example: Authorization: Bearer eyJhbGciOi...

Body

application/json

Response

200
application/json

Successfully generated Customer BillPay Control Number

The response is of type object.