Bill Request Validation

POST

/v1/bill-payments

This is a POST request that is responsible for initiating a Bill Request Validation.

Note: The transactionType for this endpoint is 3

Note: A valid token is required for authentication as it expires after every hour. Refer to Token Request to generate a new token.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/bill-payments' \
--header 'Content-Type: application/json' \
--data-raw '{
    "routeId": "068d89af-be67-f011-bb46-0e7d952d79b7",
    "ServiceId": "bc97d2b1-4828-f111-bc5a-0e7d952d79b7",
    "accountNumber": "1111111",
    "transactionType": 3,
    "transactionDesc": "Bill Payment NEW",
    "originatorConversationId": "{{$guid}}",
    "msisdn": "254710000000",
    "narration": "Testing",
    "amount": 15,
    "customerNames": "IRINA MUTHONI",
    "countryCode": "KE",
    "currencyCode": "KES",
    "saveBillerNumber": true,
    "callBackUrl": "https://bright-sparrow-356.webhook.cool"
}'

Response Example

{
    "message": {
        "appDomainName": "TEST",
        "remarks": "Bill Payment submission accepted",
        "originatorConversationId": "f3b3c682-bf08-4c4c-a65a-4ad998019d9e",
        "systemConversationId": "01000000-0129-0a00-1ac0-08de9ac69d58",
        "timestamp": "2026-04-15T08:11:37.3471201Z",
        "dueDate": null,
        "dueAmount": 0.0,
        "currency": "KES",
        "accountCustomerName": "",
        "active": "Unknown",
        "responseCode": null,
        "responseDesc": null
    }
}

Modified at 2026-04-30 05:53:25

Overview

Bill Request Payment