# Create Bill Without Bill Fetch

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/bbps/bill-payment:
    post:
      summary: Create Bill Without Bill Fetch
      deprecated: false
      description: >-

        :::highlight purple 📌

        Use this API when you already have the bill details and want to create a
        bill directly in your EnKash account using this available information.

        This is useful in cases where bill data has been pre-fetched or provided
        by another source, allowing you to seamlessly generate a bill without
        needing to query the biller again.

        :::
      tags:
        - Wallet/APIs - Wallet/Fund Transfers
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddBillRequest'
            example:
              companyId: string
              referenceId: string
              billerId: 0
              circle: AP
              billParams:
                additionalProp1: string
                additionalProp2: string
                additionalProp3: string
              branchCode: string
              failureReason: string
              billAmount: 0
              recoverableAmount: 0
              commencementDate: '2025-10-01'
              remarks: string
              bankCardId: BKCJC126GDK5
              keyContactEmail: string
              billDueDate: '2025-10-01'
              billDate: '2025-10-01'
              email: string
              name: string
              fileName: string
              base64File: string
              mimeType: string
              virtualAccountNo: string
              ifsc: string
              walletId: string
              otpMedium: MOBILE
              otp: '401936'
              otpReferenceId: string
              planId: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponseBillAddResponse'
              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
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Wallet/APIs - Wallet/Fund Transfers
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-32547637-run
components:
  schemas:
    AddBillRequest:
      required:
        - billerId
        - billParams
      type: object
      properties:
        referenceId:
          type: string
          description: Customers referenceId for bill
        billerId:
          type: integer
          format: int32
          description: BillerId provided by us/available in Get Billers API
        circle:
          type: string
          enum:
            - AP
            - ASM
            - BIH
            - CHE
            - DEL
            - GUJ
            - HAR
            - HP
            - JK
            - KK
            - KER
            - KOL
            - MAH
            - MP
            - MUM
            - NE
            - ORI
            - PUN
            - RAJ
            - TN
            - UPE
            - UPW
            - WB
            - ALL
            - AGRA
            - AHM
            - BHIWANDI
            - SURAT
            - SHILMUMBRAKALWA
          description: circle of the biller
        billParams:
          type: object
          additionalProperties:
            type: string
          x-apidog-orders:
            - cn
            - ad1
            - ad2
            - ad3
          properties:
            cn:
              type: string
              description: Consumer Number/ Account Number
            ad1:
              type: string
              description: Additional Parameter 1
            ad2:
              type: string
              description: ' Additional Parameter 2'
            ad3:
              type: string
              description: Additional Parameter 3
          required:
            - cn
          x-apidog-ignore-properties: []
        billAmount:
          type: number
          description: Bill amount
        remarks:
          type: string
          description: Optional remarks for the bill
        keyContactEmail:
          type: string
          description: EmailIds to send success payment receipt
        billDueDate:
          type: string
          format: date
          description: Bill due date
        billDate:
          type: string
          format: date
          description: Bill date
        name:
          type: string
          description: Customer name, mandatory for Credit Card
        email:
          type: string
          description: Customer email, mandatory for Credit Card
      x-apidog-orders:
        - referenceId
        - billerId
        - circle
        - billParams
        - billAmount
        - remarks
        - keyContactEmail
        - billDueDate
        - billDate
        - name
        - email
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    ApplicationResponseBillAddResponse:
      type: object
      properties:
        response_code:
          type: integer
        response_message:
          type: string
        payload:
          $ref: '#/components/schemas/AddBillV2Response'
      required:
        - response_code
        - response_message
        - payload
      x-apidog-orders:
        - response_code
        - response_message
        - payload
      x-apidog-refs: {}
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    AddBillV2Response:
      type: object
      properties:
        utilityEnkashId:
          type: string
        amount:
          type: integer
        consumerNumber:
          type: string
        billdate:
          type: string
        billDueDate:
          type: string
        createdDate:
          type: string
        referenceId:
          type: string
        paymentStatus:
          type: string
          enum:
            - INIT
            - PROCESS
            - SUCCESS
            - FAILED
            - PENDING
            - CANCELLED
            - EXPIRED
            - PARTIAL_REFUNDED
            - REFUNDED
            - IN_PROCESS
            - AUTHENTICATION_IN_PROCESS
            - OTP_RENDERED
            - CHECKOUT_RENDERED
            - MPI_PROCESSED
            - MPI_RENDERED
            - REFUND_IN_PROGRESS
            - REFUND_REQUESTED
            - PENDING_WITH_BANK
            - SWAPPED
            - PAID_OFFLINE
            - PARTIAL_PAID
          x-apidog-enum:
            - value: INIT
              name: ''
              description: ''
            - value: PROCESS
              name: ''
              description: ''
            - value: SUCCESS
              name: ''
              description: ''
            - value: FAILED
              name: ''
              description: ''
            - value: PENDING
              name: ''
              description: ''
            - value: CANCELLED
              name: ''
              description: ''
            - value: EXPIRED
              name: ''
              description: ''
            - value: PARTIAL_REFUNDED
              name: ''
              description: ''
            - value: REFUNDED
              name: ''
              description: ''
            - value: IN_PROCESS
              name: ''
              description: ''
            - value: AUTHENTICATION_IN_PROCESS
              name: ''
              description: ''
            - value: OTP_RENDERED
              name: ''
              description: ''
            - value: CHECKOUT_RENDERED
              name: ''
              description: ''
            - value: MPI_PROCESSED
              name: ''
              description: ''
            - value: MPI_RENDERED
              name: ''
              description: ''
            - value: REFUND_IN_PROGRESS
              name: ''
              description: ''
            - value: REFUND_REQUESTED
              name: ''
              description: ''
            - value: PENDING_WITH_BANK
              name: ''
              description: ''
            - value: SWAPPED
              name: ''
              description: ''
            - value: PAID_OFFLINE
              name: ''
              description: ''
            - value: PARTIAL_PAID
              name: ''
              description: ''
        billpayStatus:
          type: string
          enum:
            - SUCCESS
            - FAILED
            - PENDING
            - IN_PROGRESS
            - ON_HOLD
            - REINITIATE
            - AGENCY_FAILED
          x-apidog-enum:
            - value: SUCCESS
              name: ''
              description: ''
            - value: FAILED
              name: ''
              description: ''
            - value: PENDING
              name: ''
              description: ''
            - value: IN_PROGRESS
              name: ''
              description: ''
            - value: ON_HOLD
              name: ''
              description: ''
            - value: REINITIATE
              name: ''
              description: ''
            - value: AGENCY_FAILED
              name: ''
              description: ''
        billReferenceId:
          type: string
        billpayRequestId:
          type: string
        failureReason:
          type: string
      required:
        - utilityEnkashId
        - amount
        - consumerNumber
        - createdDate
        - referenceId
        - paymentStatus
        - billpayStatus
      x-apidog-orders:
        - utilityEnkashId
        - amount
        - consumerNumber
        - billdate
        - billDueDate
        - createdDate
        - referenceId
        - paymentStatus
        - billpayStatus
        - billReferenceId
        - billpayRequestId
        - failureReason
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```