Bill Payment

POST

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

This API is used to pay BBPS bills for a selected operator after fetching bill details (if required). It processes the payment in real time, debits the partner wallet, and returns transaction and reference details.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.formaxpay.com/api/bbps/bill_payment' \
--header 'Authorization: Basic UVRNRlRKckJjRWt5RnBETGtCSGpkV0dMYnFBclFwbkE6Rm9ybWF4QDEyMw==' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operator_id": "263",
    "circle_code": "",
    "number": "7011816100",
    "amount": "5",
    "ad1": "",
    "ad2": "",
    "ad3": "",
    "ad4": "",
    "ad5": "",
    "ad6": "",
    "p_order_id": "P91745416266061001"
}'

Response Example

{
    "status": "SUCCESS",
    "message": "Transaction Successful",
    "data": {
        "number": "7011816100",
        "amount": "5",
        "operator_id": "263",
        "operator_name": "Vodafone Idea Postpaid",
        "category": "Postpaid",
        "debit_amount": "5.00",
        "opening_bal": "263.62",
        "closing_bal": "258.62",
        "order_id": "BP31909179687500CMNJO",
        "partner_order_id": "P91745416266061001",
        "operator_ref_id": "MK015357BAALPM4P3000",
        "commercial_amount": "0.00",
        "tds_amount": "0.00",
        "timestamp": "2025-12-23 17:6:54"
    }
}

Modified at 2025-12-24 12:53:03

Bill Fetch

Transaction Status