---
title: "Activate / Deactivate VA Alias"
method: POST
path: "/collection/manage/activateDeactivateVA"
tags: ["VA Code & Alias"]
---

# Activate / Deactivate VA Alias

`POST /collection/manage/activateDeactivateVA`

## Request

- Base URL: `https://jiof.trxns.in`
- URL: `https://jiof.trxns.in/collection/manage/activateDeactivateVA`
- Auth: HTTP bearer

Toggles the is_active status of an existing VA Alias.

**Failure conditions** (all return `statusCode: 900` with the description below):

| Condition | Status Description |
|---|---|
| Alias already active | VA Alias is already active |
| Alias already inactive | VA Alias is already inactive |
| Invalid va_code | va_code is mandatory and must be 5 alphanumeric characters |
| Invalid va_alias | va_alias is mandatory and must be alphanumeric (max 7 chars) |
| Missing or invalid is_active flag | is_active flag is mandatory and must be boolean (true/false) |
| VA Code does not exist | VA Code does not exist for this merchant |
| VA Alias does not exist | VA Alias does not exist for this VA Code |
| Activation/Deactivation failed | VA Alias activation/deactivation failed |
| Internal server error | Internal Server Error |

## Request body

- ActivateDeactivateRequest
  - `va_code` string, required: 5-character alphanumeric VA Code.
  - `va_alias` string, required: Alphanumeric alias (max 7 chars).
  - `is_active` boolean, required: true to activate, false to deactivate.

## Response `200`

Success or failure — see statusCode in the body.

- union
  - ActivateDeactivateResponse
    - `statusCode` integer
    - `statusDesc` string: VA Alias Activated Successfully or VA Alias Deactivated Successfully depending on is_active.
    - `data` object
      - `id` integer
      - `va_alias` string
      - `is_active` integer: 0 = inactive, 1 = active.
      - `updated_at` string
  - VAFailureResponse
    - `statusCode` integer: Application-level status code. 900 indicates failure; the specific reason is in statusDesc.
    - `statusDesc` string: Human-readable description of the failure.

---

[API](https://skmtc.dev/jiopay/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/jiopay/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/jiopay/apis/virtual-accounts/revisions/069638c81b20?raw)