Enkash Developer Portal
HomePayment GatewayPayoutsCreate Account
HomePayment GatewayPayoutsCreate Account
Login
  1. APIs
  • Back to home
  • Bill Payment
  • APIs
    • Get Authentication Token
      POST
    • Fetch Bill
      POST
    • Get Billers
      GET
    • Get BillerTypes
      GET
    • Bill Payment Webhook
      POST
    • Get Utility Bills Detail
      POST
    • Get Utility Bill by Reference Id
      GET
    • Get Utility Bill Status
      GET
    • Utility Bill Approval API
      PUT
    • Bill Payment
      POST
    • Create Bill Without Bill Fetch
      POST
    • Create Bill API
      POST
  1. APIs

Create Bill Without Bill Fetch

POST
/api/v2/biller/addBill
This API to use when user already have the bill details with them and want to create bill with the available details

Request

Body Params application/json
referenceId
string 
optional
Customers referenceId for bill
billerId
integer <int32>
required
BillerId provided by us/available in Get Billers API
circle
enum<string> 
optional
circle of the biller
Allowed values:
APASMBIHCHEDELGUJHARHPJKKKKERKOLMAHMPMUMNEORIPUNRAJTNUPEUPWWBALLAGRAAHMBHIWANDISURATSHILMUMBRAKALWA
billParams
object 
required
cn
string 
required
Consumer Number/ Account Number
ad1
string 
optional
Additional Parameter 1
ad2
string 
optional
Additional Parameter 2
ad3
string 
optional
Additional Parameter 3
Additional properties
string 
optional
billAmount
number 
optional
Bill amount
remarks
string 
optional
Optional remarks for the bill
keyContactEmail
string 
optional
EmailIds to send success payment receipt
billDueDate
string <date>
optional
Bill due date
billDate
string <date>
optional
Bill date
Example
{
    "referenceId": "string",
    "billerId": 0,
    "circle": "AP",
    "billParams": {
        "cn": "string",
        "ad1": "string",
        "ad2": "string",
        "ad3": "string"
    },
    "billAmount": 0,
    "remarks": "string",
    "keyContactEmail": "string",
    "billDueDate": "2019-08-24",
    "billDate": "2019-08-24"
}

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.com/api/v2/biller/addBill' \
--header 'Content-Type: application/json' \
--data-raw '{
    "referenceId": "string",
    "billerId": 0,
    "circle": "AP",
    "billParams": {
        "cn": "string",
        "ad1": "string",
        "ad2": "string",
        "ad3": "string"
    },
    "billAmount": 0,
    "remarks": "string",
    "keyContactEmail": "string",
    "billDueDate": "2019-08-24",
    "billDate": "2019-08-24"
}'

Responses

🟢200Success
application/json
Body
response_code
integer 
required
response_message
string 
required
payload
object (AddBillV2Response) 
required
utilityEnkashId
string 
required
amount
integer 
required
consumerNumber
string 
required
billdate
string 
optional
billDueDate
string 
optional
createdDate
string 
required
referenceId
string 
required
paymentStatus
enum<string> 
required
Allowed values:
INITPROCESSSUCCESSFAILEDPENDINGCANCELLEDEXPIREDPARTIAL_REFUNDEDREFUNDEDIN_PROCESSAUTHENTICATION_IN_PROCESSOTP_RENDEREDCHECKOUT_RENDEREDMPI_PROCESSEDMPI_RENDEREDREFUND_IN_PROGRESSREFUND_REQUESTEDPENDING_WITH_BANKSWAPPEDPAID_OFFLINEPARTIAL_PAID
billpayStatus
enum<string> 
required
Allowed values:
SUCCESSFAILEDPENDINGIN_PROGRESSON_HOLDREINITIATEAGENCY_FAILED
billReferenceId
string 
optional
billpayRequestId
string 
optional
failureReason
string 
optional
Example
{
    "response_code": 0,
    "response_message": "string",
    "payload": {
        "utilityEnkashId": "string",
        "amount": 0,
        "consumerNumber": "string",
        "billdate": "2025-06-02",
        "billDueDate": "2025-06-02",
        "createdDate": "2025-06-02",
        "referenceId": "string",
        "paymentStatus": "INIT",
        "billpayStatus": "SUCCESS",
        "billReferenceId": "string",
        "billpayRequestId": "string",
        "failureReason": "string"
    }
}
Modified at 2025-07-06 19:58:47
Previous
Bill Payment
Next
Create Bill API
Built with