Bill Payment

POST

https://api.formaxpay.com/api/bbps/v4/bill_payment

Request

Query Params

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/v4/bill_payment?Authorization=Basic%20aXlrdmN4TTNVRjJoNmFwREJncWhGWFRDaUxMZ0hPVVk6cE9rZCE7ZGNVUjU3MDFjOw%3D%3D' \
--header 'Authorization: Basic aXlrdmN4TTNVRjJoNmFwREJncWhGWFRDaUxMZ0hPVVk6cE9rZCE7ZGNVUjU3MDFjOw==' \
--header 'Content-Type: application/json' \
--data '{
    "agent_id": "CC01RS16AGTBBH278223",
    "biller_adhoc": "true",
    "device": {
        "ip": "164.52.211.0",
        "channel": "AGT",
        "mac": ""
    },
    "customer": {
        "mobile": "9836114520",
        "email": "",
        "aadhaar": "",
        "pan": ""
    },
    "biller_id": "WEST00000WBLUN",
    "input_params": {
        "input": [
            {
                "paramName": "Consumer ID",
                "paramValue": "105819812"
            },
            {
                "paramName": "Mobile Number",
                "paramValue": "9836114520"
            }
        ]
    },
    "additional_info": "",
    "biller_response": {
        "bill_amount": 10,
        "bill_date": "2026-08-04",
        "bill_number": "NA",
        "bill_period": "NA",
        "customer_name": "EZAZUL HAQUE",
        "due_date": "2026-08-04",
        "amount_options": null
    },
    "amount_info": {
        "amount": "100",
        "currency": "365",
        "cust_conv_fee": "0",
        "amount_tags": ""
    },
    "p_order_id": "P13421324483156985ssh",
    "payment_method": {
        "mode": "Cash",
        "quick_pay": "N",
        "split_pay": "N"
    },
    "payment_info": {
        "info": [
            {
                "infoName": "Remarks",
                "infoValue": "Received"
            }
        ]
    },
}'

Response Example

{
    "status": "SUCCESS",
    "message": "Transaction Successful",
    "data": {
        "account": "153079219",
        "customer_name": "SK ASHRAF ALI",
        "amount": "100",
        "biller_id": "WEST00000WBLUN",
        "biller_name": "West Bengal Electricity Prepaid",
        "category": "Electricity",
        "commercial_amount": "1.50",
        "debit_amount": "5.00",
        "opening_bal": "247.70",
        "closing_bal": "242.70",
        "order_id": "BP10083007812500BUVFX",
        "partner_order_id": "P13421324483156984",
        "bconnect_txn_id": "CC016210CBAE80749178",
        "cust_conv_fee": "0",
        "error_message": null,
        "payment_mode": "UPI",
        "timestamp": "2026-07-29 23:24:51",
        "approval_ref_number": "AB123456"
    }
}

Modified at 2026-08-04 15:31:27

Bill Validation

Bill Payment Callback