# View Virtual Account by Customer Reference Id

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/merchant-virtual-account/customer-reference-id/{customerRefernceId}:
    get:
      summary: View Virtual Account by Customer Reference Id
      deprecated: false
      description: >-
        Use this API to retrieve a virtual account using customerReferenceId,
        the identifier supplied by the merchant when the virtual account was
        created. Lets merchants fetch VA details using their own reference
        instead of Enkash virtualAccountId or virtualAccountNumber.
      tags:
        - Payment Gateway/APIs - Payment Gateway /E-Collect
      parameters:
        - name: customerRefernceId
          in: path
          description: Merchant’s reference for this VA (unique per merchant)
          required: true
          example: CRF32S3454SDS
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: true
          example: Bearer <YOUR_USER_JWT>
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_code:
                    type: integer
                  response_message:
                    type: string
                  payload:
                    type: object
                    properties:
                      virtualAccountId:
                        type: string
                      customerId:
                        type: string
                      customerReferenceId:
                        type: string
                      customerName:
                        type: string
                      customerEmail:
                        type: string
                      customerPhone:
                        type: string
                      virtualAccountNumber:
                        type: string
                      virtualAccountIfscCode:
                        type: string
                      bankName:
                        type: string
                      customerAccountNumber:
                        type: string
                      customerUpiHandle:
                        type: string
                      customerIfscCode:
                        type: string
                      status:
                        type: string
                      closedOn:
                        type: string
                      description:
                        type: string
                      amountPaid:
                        type: integer
                      notes:
                        type: object
                        properties:
                          key1:
                            type: string
                        required:
                          - key1
                        x-apidog-orders:
                          - key1
                      expectedAmount:
                        type: integer
                    required:
                      - virtualAccountId
                      - customerId
                      - customerReferenceId
                      - customerName
                      - customerEmail
                      - customerPhone
                      - virtualAccountNumber
                      - virtualAccountIfscCode
                      - bankName
                      - customerAccountNumber
                      - customerUpiHandle
                      - customerIfscCode
                      - status
                      - closedOn
                      - description
                      - amountPaid
                      - notes
                      - expectedAmount
                    x-apidog-orders:
                      - virtualAccountId
                      - customerId
                      - customerReferenceId
                      - customerName
                      - customerEmail
                      - customerPhone
                      - virtualAccountNumber
                      - virtualAccountIfscCode
                      - bankName
                      - customerAccountNumber
                      - customerUpiHandle
                      - customerIfscCode
                      - status
                      - closedOn
                      - description
                      - amountPaid
                      - notes
                      - expectedAmount
                required:
                  - response_code
                  - response_message
                  - payload
                x-apidog-orders:
                  - response_code
                  - response_message
                  - payload
              example:
                response_code: 0
                response_message: SUCCESS
                payload:
                  virtualAccountId: va_abc123
                  customerId: cust_001
                  customerReferenceId: INV-2026-001
                  customerName: John Doe
                  customerEmail: john@example.com
                  customerPhone: '9876543210'
                  virtualAccountNumber: VA00001234
                  virtualAccountIfscCode: RATN0VAAPIS
                  bankName: RBL Bank
                  customerAccountNumber: '9876543210123'
                  customerUpiHandle: john@upi
                  customerIfscCode: SBIN0001234
                  status: ACTIVE
                  closedOn: '2026-06-01 23:59:59'
                  description: Monthly rent
                  amountPaid: 3000
                  notes:
                    key1: value1
                  expectedAmount: 5000
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Payment Gateway/APIs - Payment Gateway /E-Collect
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-36879224-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```