Create Bill Without Bill Fetch - Enkash Developer Portal

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

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"
    }
}