Bill Pay

POST

/api/v1/bill-payment/fetch-bill

Bill Pay API

Initiate bill payment through BBPS after successful bill validation.
The API processes the payment securely and generates a transaction reference for tracking.

Request

Header Params

Body Params application/json

Example

{
    "request_id": "bbpstxn0001",
    "operator_id": 11,
    "canumber": "7366968629",
    "amount": 22,
    "mode": "online",
    "ad1": null,
    "ad2": null
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/bill-payment/fetch-bill' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "bbpstxn0001",
    "operator_id": 11,
    "canumber": "7366968629",
    "amount": 22,
    "mode": "online",
    "ad1": null,
    "ad2": null
}'

Responses

🔴503Service Unavailable

application/json

Body

Example

{
    "response_code": 503,
    "status": "failed",
    "message": "Biller is not accepting payments right now. Please try again later.",
    "data": [],
    "meta": {
        "request_id": "a36f1286-3193-4768-9593-45a7d2b4bf99",
        "time": "2026-03-04T09:16:37+05:30"
    }
}

🟠401Unauthorized

Fetch Bill

Initiate

Bill Pay

Bill Pay API#

Request

Request Code Samples

Responses

Bill Pay API