Update Virtual Account

PATCH

/api/v0/merchant-virtual-account/{virtualAccountId}

Use this API to update the details of an existing virtual account using the virtualAccountId. You can modify the description, expected amount, expiry time, notes, or close the virtual account by updating its status. Only the fields provided in the request will be updated; omitted fields remain unchanged.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

ExampleMark VA as active/closedUpdating closedBy date/time

{
  "description": "Updated rent",
  "expectedAmount": 937.09,
  "closedBy": "2026-07-01 23:59:59",
  "notes": {
    "key1": "value1"
  },
  "virtualAccountStatus": "CLOSED"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

ExampleMark VA as active/closedUpdating closedBy date/time

curl --location --request PATCH 'https://olympus-pg-uat.enkash.in/api/v0/merchant-virtual-account/' \
--header 'Authorization: Bearer jIR6lhjFvimVkjNUMEhPWpsnCiI' \
--header 'Content-Type: application/json' \
--data '{
  "description": "Updated rent",
  "expectedAmount": 937.09,
  "closedBy": "2026-07-01 23:59:59",
  "notes": {
    "key1": "value1"
  },
  "virtualAccountStatus": "CLOSED"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
  "response_code": 0,
  "response_message": "SUCCESS",
  "payload": {
    "virtualAccountId": "va_abc123",
    "merchantDetailId": "mdt_abc123",
    "customerReferenceId": "CUST7625367",
    "customerId": "cust_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.00,
    "notes": {
      "key1": "value1",
      "key2": "value2"
    },
    "expectedAmount": 5000.00
  }
}

Modified at 2026-06-03 05:26:01

View Virtual Account by Id

View Virtual Account by Account Number