- Explore Our Product Suite
- Payment Gateway
- Payouts
- Prepaid Cards
- About Prepaid Card
- Key Capabilities
- Getting Started
- APIs
- API Access & Authorization
- Encryption & Decryption Guide
- Auth Token
- Create Card Account
- Create Gift Card
- Create Prepaid Card
- Set Card PIN
- Load Card Balance
- Get Card Account Details
- Generate Card OTP
- View Card Details
- Card Usage Controls
- Get Card Usage Limits
- Request Card Replacement
- Block Card
- Order Physical Card
- Get Card Details
- Get Transaction Details
- Get All Transaction details
- Bharat Connect (BBPS)
- About Bharat Connect
- Invoice Payments
- Invoice
- Payment
- Financing
- Onboarding
- cdNote
- Purchase Order
- webhook-invoice
- webhook-payments
- webhook-business-onboarding
- webhook-financing
- webhook-cdNote
- Webhook Purchase Order
- Webhook Send Purchase Order Request
- Webhook Send Purchase Order Response
- Webhook Confirm Purchase Order Request
- Webhook Confirm Purchase Order Response
- Webhook Edit Purchase Order Request
- Webhook Edit Purchase Order Response
- Webhook Status Change Purchase Order Request
- Webhook Status Change Purchase Order Response
- Bill Payments
- Bill Payments Overview
- Utility API Response Handling
- Get Authentication TokenPOST
- Get BillerTypesGET
- Get BillersGET
- Fetch BillPOST
- Create Bill APIPOST
- Create Bill Without Bill FetchPOST
- Bill PaymentPOST
- Utility Bill Approval APIPUT
- Get Utility Bill StatusGET
- Get Utility Bill by Reference IdGET
- Get Utility Bills DetailPOST
- Bill Payment WebhookPOST
- Accounts Payable
- Account Receivable
- Expense Management
- Rewards & Incentives
- Verification Suite
Get Utility Bill Status
GET
/api/v0/utilityPayment/{utilityEnkashId}
BillPayStatus refers to the status of the bill.
BillPayStatus ->
SUCCESS means bill is successfully paid.
FAILED means billpayment has been failed, paymentStatus will changed to REFUNDED
Any other status means billpay is still in process status
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************
Path Params
utilityEnkashId
string
required
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://test.your-api-server.com/api/v0/utilityPayment/'
Responses
🟢200Success
application/json
Body
response_code
integer
required
response_message
string
required
payload
object (UtilityPaymentResponse)
required
utilityEnkashId
string
optional
referenceId
string
optional
amount
number
optional
consumerNumber
string
optional
consumerName
string
optional
billDate
string <date>
optional
billDueDate
string <date>
optional
createdDate
string <date-time>
optional
billNumber
string
optional
billerBillNumber
string
optional
paymentStatus
enum<string>
optional
Allowed values:
INITPROCESSSUCCESSFAILEDPENDINGCANCELLEDEXPIREDPARTIAL_REFUNDEDREFUNDEDIN_PROCESSAUTHENTICATION_IN_PROCESSOTP_RENDEREDCHECKOUT_RENDEREDMPI_PROCESSEDMPI_RENDEREDREFUND_IN_PROGRESSREFUND_REQUESTEDPENDING_WITH_BANKSWAPPEDPAID_OFFLINEPARTIAL_PAID
paymentDate
string <date-time>
optional
billpayStatus
enum<string>
optional
Allowed values:
SUCCESSFAILEDPENDINGIN_PROGRESSON_HOLDREINITIATEAGENCY_FAILED
billReferenceId
string
optional
billpayDate
string <date-time>
optional
failureReason
string
optional
refundDate
string <date-time>
optional
paymentMode
enum<string>
optional
Allowed values:
CREDIT_CARDDEBIT_CARDNET_BANKINGUPIPREPAID_CARDINVALID_PAYMENT_MODESEAMLESS_BANKINGVIRTUAL_ACCOUNTTALLY_PAYMENTENKASH_COINCASHCHEQUEACCOUNT_TRANSFER
approvedDate
string <date-time>
optional
billStartDate
string <date>
optional
billEndDate
string <date>
optional
remarks
string
optional
validationId
string
optional
billAmount
number
optional
earlyPaymentDate
string <date>
optional
earlyPaymentAmount
number
optional
latePaymentAmount
number
optional
actualDueDate
string <date>
optional
billCopyStatus
enum<string>
optional
Allowed values:
FAILEDPENDINGSUCCESS
billCopyPdfUrl
string
optional
companyBiller
object (CompanyBillerResponse)
required
utilityBillMetaData
object (UtilityBillMetaDataResponse)
optional
Example
{
"response_code": 0,
"response_message": "string",
"payload": {
"utilityEnkashId": "string",
"referenceId": "string",
"amount": 0,
"consumerNumber": "string",
"consumerName": "string",
"billDate": "2019-08-24",
"billDueDate": "2019-08-24",
"createdDate": "2019-08-24T14:15:22Z",
"billNumber": "string",
"billerBillNumber": "string",
"paymentStatus": "INIT",
"paymentDate": "2019-08-24T14:15:22Z",
"billpayStatus": "SUCCESS",
"billReferenceId": "string",
"billpayDate": "2019-08-24T14:15:22Z",
"failureReason": "string",
"refundDate": "2019-08-24T14:15:22Z",
"paymentMode": "CREDIT_CARD",
"approvedDate": "2019-08-24T14:15:22Z",
"billStartDate": "2019-08-24",
"billEndDate": "2019-08-24",
"remarks": "string",
"validationId": "string",
"billAmount": 0,
"earlyPaymentDate": "2019-08-24",
"earlyPaymentAmount": 0,
"latePaymentAmount": 0,
"actualDueDate": "2019-08-24",
"billCopyStatus": "FAILED",
"billCopyPdfUrl": "string",
"companyBiller": {
"companyBillerId": "string",
"companyName": "string",
"biller": {
"billerId": 0,
"name": "string",
"billerType": "string",
"partialPayAllowed": true,
"inputParams": [
{
"paramKey": "string",
"paramName": "string",
"paramType": "NUMBER",
"paramRegex": "string",
"invalidParamError": "string",
"mandatory": true,
"paramValues": [
{
"key": "string",
"value": "string"
}
]
}
],
"circleParams": [
{
"key": "string",
"value": "AP"
}
],
"paymentAmountExactness": "string"
},
"circleEnum": "AP",
"billInputParams": "string",
"billerParams": [
{
"key": "string",
"name": "string",
"value": "string"
}
],
"consumerNumber": "string",
"consumerName": "string",
"branchCode": "string",
"branchName": "string",
"costCentre": "string",
"branchCity": "string",
"branchState": "string",
"createdDate": "2019-08-24T14:15:22Z",
"lastDueDate": "2019-08-24",
"active": true,
"companyBillerValidationStatus": "PENDING",
"billFetchFailureMessage": "string",
"attachment": true,
"autoDebit": true,
"lastBillCreatedOn": "2019-08-24T14:15:22Z",
"recoverableAmount": 0,
"commencementDate": "2019-08-24",
"remarks": "string",
"lastBillCheckedAt": "2019-08-24T14:15:22Z",
"lastBillFetchedAmount": 0,
"lastBillFetchedMessage": "string",
"lastBillFetchedReferenceId": "string",
"keyContactEmail": "string",
"billerCopyInputParamsData": {
"property1": "string",
"property2": "string"
},
"billCopyEnabled": true
},
"utilityBillMetaData": {
"uuid": "string",
"clientId": "string",
"boardId": "string",
"branchCode": "string",
"billAmount": 0,
"billDate": "string",
"dueDate": "string",
"billGenerationStatus": true,
"downloadAndExtractionStatus": "string",
"documentUrl": "string",
"createdOn": "string",
"modifiedOn": "string",
"boardName": "string",
"address": "string",
"customerId": "string",
"meterNumber": "string",
"customerName": "string",
"connectedLoad": 0,
"sanctionedLoad": 0,
"openingMeterReading": 0,
"closingMeterReading": 0,
"unitConsumption": 0,
"amountBeforeDueDate": 0,
"amountAfterDueDate": 0,
"category": "string",
"contractDemand": 0,
"earlyPaymentAmount": 0,
"earlyPaymentDate": "string",
"excessDemandCharges": 0,
"latePaymentPenalty": 0,
"maximumDemand": 0,
"powerFactor": 0,
"powerFactorPenalty": 0,
"powerFactorIncentive": 0,
"tariff": "string",
"digitalPaymentBenefit": 0,
"openMeterReadingDate": "string",
"closingMeterReadingDate": "string",
"billMonth": "string",
"previousAmountPaidDate": "string",
"previousAmountPaid": 0,
"kva40PercentDemand": 0,
"kvamaximumDemand": 0
}
}
}