Bill Fetch

POST

https://api.formaxpay.com/api/bbps/v3/bill_fetch

This API is used to fetch the bill details for a selected BBPS operator/biller before making a payment. It returns the payable amount, due date, customer details, and payment eligibility.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.formaxpay.com/api/bbps/v3/bill_fetch' \
--header 'Authorization: Basic aXlrdmN4TTNVRjJoNmFwREJncWhGWFRDaUxMZ0hPVVk6cE9rZCE7ZGNVUjU3MDFjOw==' \
--header 'Content-Type: application/json' \
--data '{
    "operator_id": "942",
    "params": [
        {
            "payment_id": "cn",
            "value": "153079219"
        },
        {
            "payment_id": "ad1",
            "value": "9836114520"
        }
    ],
    "p_order_id": "R17836721270097812",
    "provider": "NEW_MBK"
}'

Response Example

{
    "status": "SUCCESS",
    "message": "Bill Fetched Successfully",
    "data": {
        "bill": {
            "bill_amount": "0.0",
            "bill_net_amount": "0.0",
            "bill_date": "03 Dec 2025",
            "due_date": "2025-12-13",
            "accept_payment": true,
            "accept_part_pay": true,
            "customer_name": "NA",
            "customer_ref_id": "7011816100"
        },
        "order_id": "BE16284179687500SXCJW",
        "partner_order_id": "R9174541626606001",
        "timestamp": "2025-12-23 17:4:41"
    }
}

Modified at 2026-07-30 16:02:03

Biller List

Bill Payment