Bill Fetch by bill id

API for fetching a Customer Bill, based on Bill id

Endpoint
Request: GET /couapp/bills/fetch/byId?billId=1ced7566-1add-4e01-9ed6-04cd67ac9684

Request Parameters

The various parameters are explained below:

Parent Property/Element	Property/Element Name	Mandatory	Data Type	Description
[ROOT] (No parent property / element)	billId	M	UUID	Bill id is unique id which is generated while initiating the bill fetch request, it can be get from the bill fetch response.

Response Parameters

The various parameters are explained below:

Parent Property/Element	Property/Element Name	Mandatory	Data Type	Description
[ROOT] (No parent property / element)	billId	M	UUID	Machine-generated Unique ID for a Bill, used internally
	refId	M	Alphanumeric	Code generated by the Biller Operating Unit that acquires the customer for every bill fetch transaction initiated and used across all messages
	billerId	M	String	Unique ID assigned to the Biller by NPCI Fixed length - 14
	status	M	String	Status of the Operation
	actionType	C	String	Type of Bill Payment. Possible Values: BILL_FETCH QUICKPAY BILL_VALIDATE
	userId	M	Alphanumeric	Agent id Fixed length - 20
	creationDate	M	String	ISO 8601 Timestamp for the Bill Creation date
	modifiedDate	M	String	ISO 8601 Timestamp for the Bill Modification date
	createdEpochDate	M	Numeric	UNIX Epoch Timestamp for the Bill Creation date
billerResponse	modifiedEpochDate	M	Numeric	UNIX Epoch Timestamp for the Bill Modification date
	billId	MM	String	Machine-generated Unique ID for a Bill, used internally
	amount	M	String	Actual bill amount inclusive of all charges
	billDate	M	String	This field denotes generation date of the bill
	billNumber	M	String	This field denotes the bill number of the bill fetch / payment message requested
	billPeriod	M	String	The bill period of the bill fetch / payment requested
	custConvFee	M	String	Customer convenience fee (CCF1) paid by the Customer Operating Unit
	couCustConvFee	M	String	Customer convenience fee (CCF2), paid by the Customer to Customer Operating Unit
	dueDate	M	String	This field denotes due date of the bill
	customerName	M	String	This field denotes due date of the bill
	amountOption	M	Boolean	A flag indicating if the Biller supports Amount Options
	tagList	M	String	Amount Breakup Options eg:{"name": "Additional Charges", "value": "500"}
additionalInfo	name	C	String	Name of the Additional Info Parameter
	value	C	String	Value of the Additional Info Parameter
customerParams	name	C	String	Name of the Customer Parameter attribute
	value	C	String	Value of the Customer Parameter attribute
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 (success response)

  
  {
  "genericResponse": {
   "message": "",
  "remarks": "",
  "status": "Success", 
  "statusCode": "200"
  },
  "billId": "1ced7566-1add-4e01-9ed6-04cd67ac9684", 
  "refId": "BlgcYxtJCrLU18BDm8rVDHQl0Hqf9x2XONi", 
  "billerId": "DKAFEE000PUN01",
  "status": "BILL_FETCH_SUCCESS",
  "actionType": "BILL_FETCH", 
  "userId": "FE41FE42BNK519012345",
  "billerResponse": {
  "billId": "1ced7566-1add-4e01-9ed6-04cd67ac9684", 
  "amount": "1142000",
  "billDate": "2021-12-09",    
  "billNumber": "59",
  "billPeriod": "NA",
  "custConvFee": "0",
  "couCustConvFee": "0",
  "dueDate": "2022-01-31",
  "customerName": "AGAMJOT TEST ", 
  "amountOption": false,
  "tagList": null
  },
  "additionalInfo": [
  {
  "additionalInfoId": null, 
  "name": "Student Name", 
  "value": "AGAMJOT TEST "
  },
  {
  "additionalInfoId": null, 
  "name": "Father Name", 
  "value": "VIRENDER SINGH"
  },
  {
  "additionalInfoId": null, 
  "name": "Class",
  "value": "STD I"
  },
  {
  "additionalInfoId": null, 
  "name": "Section",
  "value": "A"
  },
  {
  "additionalInfoId": null, 
  "name": "TUITION FEE",
  "value": "8670"
  },
  {
  "additionalInfoId": null, 
  "name": "E-CARE FEE",
  "value": "900"
  },
  {
  "additionalInfoId": null, 
  "name": "COMPUTER FEE",
  "value": "1350"
  },
  {
  "additionalInfoId": null, 
  "name": "EXAM FEE",
  "value": "500"
  }
  ],          
  "customerParams": [
  {
  "name": "Admission No/Application No/GR No", 
  "value": "LF3130",
  "type": null
  },
  {
  "name": "Date Of Birth (DD-MM-YYYY)", 
  "value": null,
  "type": null
  },
  {
  "name": "Mobile No", 
  "value": null,
  "type": null
  }
  ],
  "creationDate": "2021-12-09T08:37:40.082462", 
  "modifiedDate": "2021-12-09T08:37:42.303627",
  "createdEpochDate": 1639039060,
  "modifiedEpochDate": 1639039062
  }                                              

Json Formatted Response Example (failure response)

    {
    "genericResponse": { 
    "message": "",
    "remarks": "Fetch Request not supported, only QuickPay permitted", 
    "status": "Failure",
    "statusCode": "500"
    },
    "billId": "XXXXXXXX-7d79-4e3c-bd2d-382276669ba9",
    "refId": "xxXXXxxxxxS4VZlr9bUF2lCCzFc4823081150", 
    "billerId": "XXXXXXXXXXXXXX",
    "status": "BILL_FETCH_FAILED",
    "actionType": "BILL_FETCH", 
    "userId": "FE41XXXXXXXXXXXXXX",
    "billerResponse": null, 
    "customerParams": [
    {}
    ],
    "creationDate": "2022-11-04T11:50:50+05:30", 
    "modifiedDate": "2022-11-04T11:50:50.460818",
    "createdEpochDate": 1667542850,
    "modifiedEpochDate": 1667542850
    }