BBPS Webhooks

BBPS Webhooks

Postman Collection

Webhooks

Headers

Content-Type  (String)   required
application/json

Signature  (String)  
Basic Signature

Response Samples

SUCCESS

{
        "event": "bbps.request.success",
        "code": "0x0200",
        "message": "Transaction success",
        "data": {
                "clientRefId": "APBILL50411473202509xxxxx",
                "agentNpciId": "FE41FE15INTU0000xxxxx",
                "fundRespRemarks": "SUCCESS",
                "fundStatus": "FUND_TRANSFER_SUCCESS",
                "billStatus": "BILL_PAYMENT_SUCCESS",
                "fundTxnAmt": 1060.82,
                "fundTxnDate": "2025-09-05 00:00:00",
                "fundTxnReferenceId": "V34TB3Y8xxxx",
                "fundTxnRemarks": "BBPS-AGENT/V34TB3Y8Wxxxx",
                "fundUTR": "S101xxxx",
                "billerId": "ATBROAD00NAT02",
                "billerName": "Airtel Broadband (Fetch and Pay)",
                "txnRefId": "e4dec951-5ea6-4cd8-9b8d-d037194xxxx",
                "customerMobNo": "98106xxxxx",
                "txnNpciId": "FE41524836Y3auxxxxx"
        }
}
  

FAILED

   {
        "event": "bbps.request.failed",
        "code": "0x0202",
        "message": "Transaction failed",
        "data": {
                "clientRefId": "SSMSBILL958082XXXX",
                "agentNpciId": "FE41FE15INTU000XXXX",
                "fundRespRemarks": "SUCCESS",
                "fundStatus": "FUND_TRANSFER_SUCCESS",
                "billStatus": "BILL_PAYMENT_FAILED",
                "fundTxnAmt": 79393,
                "fundTxnDate": "2025-09-03 00:00:00",
                "fundTxnReferenceId": "CS8EGYCFKDXXXX",
                "fundTxnRemarks": "SUCCESS",
                "fundUTR": "S7386XXXX",
                "billerId": "HDFC00000NATW1",
                "billerName": "HDFC Credit Card",
                "txnRefId": "bb725580-7dbf-4ff9-bbe2-19aebxxxxx",
                "customerMobNo": "96371xxxx",
                "txnNpciId": "FE415246ckEMFcxxxx"
        }
}

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