Enkash Developer Portal
Home
Home
Login
  1. Webhook
  • Back to home
  • APIs - BBPS
  • Bill Payment
    • Webhook
      • Setup Webhook Endpoint
        POST
    • Create Bill
      • Create Bill Without Bill Fetch
      • Create Bill After Successful Bill Fetch
    • Fetch Bill
      • Fetch Current Bill
      • Fetch Biller List
      • Fetch Biller Categories
      • Prepaid Plan
      • Fetch Bulk Bill Details
      • Get Utility Bill By Reference ID
      • Get Utility Bill Status
    • Payment
      • Confirm Debit for Bill Payment
      • Initiate Bill Payment via EnKash PG
    • Generate Authentication Token
      POST
  • Vendor Payment
    • Business Onboarding
      • Initiate Entity Check
      • Register Entity
      • Bharat Connect B2B ID Registration
      • Search Entity
    • Invoice
      • Create Invoice
      • Confirm Invoice
      • Change Invoice Status
      • Edit Invoice
    • Payment
      • Pay Invoice
      • Payment Confirmation
    • Purchase Order
      • Send Purchase Order Request
      • Confirm Purchase Order
      • Edit Purchase Order
      • Change Purchase Order Status
    • Credit Note
      • Send C/N Request
      • Confirm C/N Request
      • Status Change C/N Request
    • Financing
      • Request Financing
      • Share Bid
      • Respond To Bid
    • Webhook
      • Business Onboarding
        • Check Entity Webhook
        • Entity Registration Response Webhook
        • Search Entity Response Webhook
        • Registration ID Response Webhook
      • Invoice
        • Create Invoice Request Webhook
        • Create Invoice Response Webhook
        • Confirm Invoice Request Webhook
        • Confirm Invoice Response Webhook
        • Status Change Invoice Request
        • Status Change Invoice Response Webhook
        • Edit Invoice Request Webhook
        • Edit Invoice Response Webhook
      • Payment
        • Payment Response Webhook
        • Payment Confirmation Response Webhook
        • Payment Request Webhook
        • Payment Confirmation Request Webhook
      • Credit Note
        • Send C/N RequestWebhook
        • Send C/N Response Webhook
        • Confirm C/N Request Webhook
        • Confirm C/N Response Webhook
        • Status Change C/N Request Webhook
        • Status Change C/N Response Webhook
      • Purchase Order
        • 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 Webhook
      • Financing
        • Financing Response Webhook
        • Respond Bid Response Webhook
        • Share Bid Request Webhook
    • Generate Authentication Token
Home
Home
Login
  1. Webhook

Setup Webhook Endpoint

POST
merchant_url
📌
Use these API details to setup a webhook endpoint on your side that can receive event notifications from EnKash.
The webhook supports:
Static headers for security validation, ensuring that incoming requests can be authenticated.
A custom payload, allowing flexibility in the event data delivered to your system.

Request

Body Params application/json

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 Code 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://pay-en-uat.enkash.inmerchant_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

Example
{}
Modified at 2025-07-08 20:15:17
Previous
Bill Payment
Next
Create Bill Without Bill Fetch
Built with