- 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
Bill Payment Webhook
POST
merchant_url
API supports the static headers for security and custom payload.
Request
Body Params application/json
utilityEnkashId
string
required
amount
number
required
consumerNumber
string
required
consumerName
string
required
billDate
string
required
billDueDate
string
required
createdDate
string
required
billNumber
string
required
billerBillNumber
string
required
numberOfUnits
integer
required
approvalStatus
string
required
approvalRemarks
string
required
paymentStatus
string
required
billpayStatus
string
required
failureReason
null
required
failureCode
null
required
paymentDate
string
required
billpayDate
string
required
approvedDate
string
required
billReferenceId
string
required
billStartDate
string
required
billEndDate
string
required
remarks
string
required
refundDate
null
required
companyBiller
object
required
companyBillerId
string
required
companyName
string
required
biller
object
required
circleEnum
string
required
billInputParams
string
required
billerParams
array [object {3}]
required
consumerNumber
string
required
consumerName
string
required
billAmount
number
required
earlyPaymentDate
string
required
earlyPaymentAmount
integer
required
latePaymentAmount
number
required
actualDueDate
string
required
companyId
string
required
bankTransactionId
string
required
referenceId
string
required
Example
{
"utilityEnkashId": "UTIL-87654321",
"amount": 2450.75,
"consumerNumber": "CN123456789",
"consumerName": "Tech Solutions Ltd",
"billDate": "2025-05-10",
"billDueDate": "2025-06-05",
"createdDate": "2025-05-12T14:30:25",
"billNumber": "BILL-123456",
"billerBillNumber": "BILLER-654321",
"numberOfUnits": 215,
"approvalStatus": "APPROVED",
"approvalRemarks": "Verified and approved by finance department",
"paymentStatus": "COMPLETED",
"billpayStatus": "COMPLETED",
"failureReason": null,
"failureCode": null,
"paymentDate": "2025-05-20T10:15:30",
"billpayDate": "2025-05-20T10:20:45",
"approvedDate": "2025-05-15T09:45:20",
"billReferenceId": "REF-987654321",
"billStartDate": "2025-04-10",
"billEndDate": "2025-05-09",
"remarks": "Corporate office electricity bill payment",
"refundDate": null,
"companyBiller": {
"companyBillerId": "CB-54321",
"companyName": "Tech Solutions Ltd",
"biller": {
"billerId": 2001,
"name": "Metropolitan Power Corporation",
"billerType": "ELECTRICITY"
},
"circleEnum": "MUMBAI",
"billInputParams": "consumer_number=CN123456789",
"billerParams": [
{
"key": "cn",
"name": "Consumer Number",
"value": "CN123456789"
},
{
"key": "ad1",
"name": "Billing Unit",
"value": "MUMBAI-WEST"
}
],
"consumerNumber": "CN123456789",
"consumerName": "Tech Solutions Ltd"
},
"billAmount": 2450.75,
"earlyPaymentDate": "2025-05-25",
"earlyPaymentAmount": 2400.00,
"latePaymentAmount": 2525.50,
"actualDueDate": "2025-06-05",
"companyId": "COMP-123456",
"bankTransactionId": "TXN-987654321",
"referenceId": "REF-XYZABC123456"
}
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 POST 'https://test.your-api-server.commerchant_url' \
--header 'Content-Type: application/json' \
--data-raw '{
"utilityEnkashId": "UTIL-87654321",
"amount": 2450.75,
"consumerNumber": "CN123456789",
"consumerName": "Tech Solutions Ltd",
"billDate": "2025-05-10",
"billDueDate": "2025-06-05",
"createdDate": "2025-05-12T14:30:25",
"billNumber": "BILL-123456",
"billerBillNumber": "BILLER-654321",
"numberOfUnits": 215,
"approvalStatus": "APPROVED",
"approvalRemarks": "Verified and approved by finance department",
"paymentStatus": "COMPLETED",
"billpayStatus": "COMPLETED",
"failureReason": null,
"failureCode": null,
"paymentDate": "2025-05-20T10:15:30",
"billpayDate": "2025-05-20T10:20:45",
"approvedDate": "2025-05-15T09:45:20",
"billReferenceId": "REF-987654321",
"billStartDate": "2025-04-10",
"billEndDate": "2025-05-09",
"remarks": "Corporate office electricity bill payment",
"refundDate": null,
"companyBiller": {
"companyBillerId": "CB-54321",
"companyName": "Tech Solutions Ltd",
"biller": {
"billerId": 2001,
"name": "Metropolitan Power Corporation",
"billerType": "ELECTRICITY"
},
"circleEnum": "MUMBAI",
"billInputParams": "consumer_number=CN123456789",
"billerParams": [
{
"key": "cn",
"name": "Consumer Number",
"value": "CN123456789"
},
{
"key": "ad1",
"name": "Billing Unit",
"value": "MUMBAI-WEST"
}
],
"consumerNumber": "CN123456789",
"consumerName": "Tech Solutions Ltd"
},
"billAmount": 2450.75,
"earlyPaymentDate": "2025-05-25",
"earlyPaymentAmount": 2400.00,
"latePaymentAmount": 2525.50,
"actualDueDate": "2025-06-05",
"companyId": "COMP-123456",
"bankTransactionId": "TXN-987654321",
"referenceId": "REF-XYZABC123456"
}'
Responses
🟢200Success
application/json
Body
object {0}
Example
{}
Modified at 2025-06-02 15:27:21