BBPS
Search
K

Disposition API

API for listing Complaint Disposition reasons for raising complaints for transactions.
Endpoint
Request: GET /masters/disposition
Response Parameters
The various parameters are explained below:
Parent Property/Element
Property/Element Name
Mandatory
Data Type
Description
[ROOT] (No parent property / element)
dispositionsList
M
List
List of dispositions
dispositionsList
dispositionId
M
UUID
Unique ID associated with a specific Amount Breakup Set
dispositionDescr
M
List
Lists all combinations of Amount Breakup Options configured by the Biller
generalResp
statusCode
M
Numeric
200- SUCCESS Other than 200-Failure
status
M
String
It is either “Success” or failure
message
M
String
Contains the reason message for failure / success
remarks
C
String
Json Formatted Response Example
{
"dispositionsList": [
{
"dispositionId": "90fd3ed3-620d-42c5-bb54-35ff4644d61b",
"dispositionDescr": "Transaction Successful, account not updated"
},
{
"dispositionId": "5f93f8d0-ce90-490f-a743-a8e813256fed",
"dispositionDescr": "Amount deducted, biller account credited but transaction ID not received"
},
{
"dispositionId": "74c0ef51-09e4-4f83-a440-aa0329d49287",
"dispositionDescr": "Amount deducted, biller account not credited & transaction ID not received"
},
{
"dispositionId": "3637a1a4-5fb8-48c9-915d-ba2fcb41d0a6",
"dispositionDescr": "Amount deducted multiple times"
},
{
"dispositionId": "e08b5a71-4df1-4688-ad59-347768911d22",
"dispositionDescr": "Double payment updated"
},
{
"dispositionId": "4c5b2748-6d8b-464d-8fec-8225aca3cf82",
"dispositionDescr": "Erroneously paid in wrong account"
}
],
"generalResp":
{
"statusCode": "200",
"status": "success",
"message": "dispositions retrieved successfully",
"remarks": ""
}
}