Bill Payment

Bill Payment

Postman Collection

BBPS

URL

POST : /v1/service/bbps/bill/payment

Headers

Content-Type  (String)   required
application/json

Authorization  (String)   required
Basic Auth

Accept  (String)   required
application/json

Body Params

clientRefId  (String)   Required
Merchant Unique Reference Number (Max Length: 30)

amount  (String)   Required
Bill Payment Amount (Max Length: 10)

billId  (String)   Required
Merchant Bill Id (Max Length: 50)

customerMobileNo  (String)   Required
Merchant Mobile No (Max Length: 10)

billerId  (String)   Required
Merchant biller Id (Max Length: 50)

refId  (String)   Required
Merchant biller Id (Max Length: 50)

customerParams  (object)   Required
Customer Request Parameter (Max Length: 50)

Request

Example Request

    curl --location '/v1/service/bbps/bill/payment' \
        --header 'Content-Type: application/json' \
        --header 'Authorization: Basic Og==' \
        --data '{
            "clientRefId" : "CRF378XXXXX7854",
            "amount" : "1",
            "billId" : "a9fd8d05-XXXX-478a-XXXX-0b05ad0cc397",
            "customerMobileNo" : "639XXXXX38",
            "refId": "xhhfgkklklllllljjhhhh",
            "billerId": "UPPCL0XXXXXP01",
            "customerParams": 
                [
                    {
                        "name": "Consumer Number",
                        "value": "73XXXXX1045"
                    }
                    
                ]
        }'

Response Samples

SUCCESS

   {
        "code": "0x0200",
        "message": "Bill Payment Successfully",
        "status": "SUCCESS",
        "data": ""
    }

FAILED

    {
        "code": "0x0202",
        "status": "FAILURE",
        "message": "json: cannot unmarshal string into Go struct field WalletPaymentReq.txnAmount of type int64",
        "data": {
            "genericResponse": {
                "message": "Invalid Request",
                "remarks": "json: cannot unmarshal string into Go struct field WalletPaymentReq.txnAmount of type int64",
                "status": "Failed",
                "statusCode": "400"
            }
        }
    }

PENDING

    {
        "code": "0x0206",
        "status": "PENDING",
        "message": "Bill payment pending.",
        "data": {
                "status": "BILL_PAYMENT_INITIATED",
                "txnId": "a66506da-1813-45c8-b611-8ba67d0388e6"
        }
}

Response Code

Status Code	Status	Message
0x0200	SUCCESS	TRANSACTION SUCCESSFULL
0x0201	UNAUTHORIZED	UNAUTHORIZED USER
0x0202	FAILURE	FAILURE USER
0x0203	MISSING_PARAMETER	MISSING PARAMETER
0x0204	CONNECTION_TIMEOUT	CONNECTION TIMEOUT
0x0205	SOMETHING_WENT_WRONG	SOMETHING WENT WRONG
0x0206	PENDING	TRANSACTION PENDING
0x0207	REVERSED	TRANSACTION REVERSED
0x0209	REDIRECT	REDIRECT URL