VA Code & Alias

Update VA Alias

Updates an existing STATIC VA Alias. Dynamic VA aliases cannot be updated — they are temporary and auto-expire. Updatable fields: alias holder details (name, email, mobile), remitter list, activation/deactivation dates, amount limits, IMPS/NEFT/RTGS/IFT limits, and UDF fields 1–15.

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

Condition	Status Description
No changes detected	No changes detected
Invalid or missing va_code	va_code is mandatory and must be 5 characters long
VA Code not found	VA Code does not exist
Invalid or missing va_alias	va_alias must be alphanumeric and up to 7 characters long
VA Alias does not exist	VA Alias does not exist
Dynamic alias update not allowed	Dynamic VA can't be updated.
Invalid email	Invalid email format
Invalid mobile number	va_mobile must be a valid 10-digit number
Invalid activation datetime	Invalid va_activation_dt format
Invalid deactivation datetime	Invalid va_deactivation_dt format
Activation must be before deactivation	va_activation_dt must be before va_deactivation_dt
Minimum > Maximum amount	va_min_amount_limit cannot be greater than va_max_amount_limit
Invalid minimum amount	va_min_amount_limit must be numeric
Invalid maximum amount	va_max_amount_limit must be numeric
Invalid remitter list	va_allowed_remitter must be a non-empty array
Invalid remitter account number	Invalid account_number in authorized_remitter
Invalid remitter IFSC	Invalid account_ifsc in authorized_remitter
Internal server error	Internal Server Error

post/collection/vaAlias/update

Request

Base URL
https://jiof.trxns.in
URL
https://jiof.trxns.in/collection/vaAlias/update
Auth
HTTP bearer

Request body

va_codestring required

Parent VA Code.

va_aliasstring required

Alias identifier to update.

va_namestring

Account holder name.

va_emailstring

Account holder email.

va_mobilestring

Account holder mobile.

va_range_startstring

Start of alias range, if updating a range.

va_range_endstring

End of alias range, if updating a range.

va_activation_dtstring

Activation datetime.

va_deactivation_dtstring

Deactivation datetime.

va_min_amount_limitnumber

Minimum credit amount.

va_max_amount_limitnumber

Maximum credit amount.

va_udf1string

Merchant-defined custom field 1.

va_udf2string

Merchant-defined custom field 2.

va_udf3string

Merchant-defined custom field 3.

va_udf4string

Merchant-defined custom field 4.

va_udf5string

Merchant-defined custom field 5.

va_udf6string

Merchant-defined custom field 6.

va_udf7string

Merchant-defined custom field 7.

va_udf8string

Merchant-defined custom field 8.

va_udf9string

Merchant-defined custom field 9.

va_udf10string

Merchant-defined custom field 10.

va_udf11string

Merchant-defined custom field 11.

va_udf12string

Merchant-defined custom field 12.

va_udf13string

Merchant-defined custom field 13.

va_udf14string

Merchant-defined custom field 14.

va_udf15string

Merchant-defined custom field 15.

Example request

{
  "va_code": "00001",
  "va_alias": "ALIAS01",
  "va_name": "John Payment Alias",
  "va_email": "john.alias@example.com",
  "va_mobile": "9876543210",
  "va_range_start": "1000001",
  "va_range_end": "1000100",
  "va_allowed_remitter": [
    {
      "account_number": "12345678902",
      "account_ifsc": "HDFC0001234"
    }
  ],
  "va_activation_dt": "2025-10-15T00:00:00Z",
  "va_deactivation_dt": "2025-12-31T23:59:59Z",
  "va_min_amount_limit": 50,
  "va_max_amount_limit": 5000,
  "va_udf1": "UDF Value 1"
}

Response

Success or failure — see statusCode in the body.

Example response

{
  "statusCode": 200,
  "statusDesc": "VA Alias updated successfully",
  "data": {
    "id": 1,
    "va_alias": "ALIAS01",
    "va_activation_dt": "2025-10-15T00:00:00.000Z",
    "va_deactivation_dt": "2025-12-31T23:59:59.000Z",
    "va_min_amount_limit": "50.00",
    "va_max_amount_limit": "5000.00",
    "is_active": 1,
    "updated_at": "2025-11-26T06:20:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.