VA Code & Alias

Create VA Alias (Bulk)

Creates up to 30 Virtual accounts in a single call.

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

Condition	Status Description
Missing range	Both va_range_start and va_range_end are required
Non-numeric range	va_range_start and va_range_end must be numeric values
Invalid range order	va_range_end must be greater than va_range_start
aliasList not an array	Invalid JSON format. Expected an array of alias objects
aliasList empty	Empty array provided. At least one alias object is required
Max limit exceeded	Array limit exceeded, only 30 VA Alias are allowed
Range not enough	Range not enough. Range size = X, alias count = Y
Invalid or missing va_code	va_code is mandatory and must be 5 characters long
VA Code does not exist	VA Code does not exist
Invalid va_name	va_name is mandatory and cannot exceed 100 characters
Invalid email format	va_email must be a valid email address
Invalid mobile number	va_mobile must be a valid 10-digit mobile number
Invalid remitter format	va_allowed_remitter must be a JSON array
Invalid remitter account number	Each remitter must have a valid account_number (5–24 digits)
Invalid remitter IFSC	Each remitter must have a valid IFSC code
Invalid numeric limit	<limit_field> must be a valid numeric value
Min amount greater than max	va_min_amount_limit cannot be greater than va_max_amount_limit
Invalid activation datetime	va_activation_dt is mandatory and must be a valid datetime
Invalid deactivation datetime	va_deactivation_dt must be a valid datetime if provided
Activation ≥ deactivation	va_activation_dt must be before va_deactivation_dt
Missing or invalid va_type	va_type is required
Invalid VA Type	va_type must be "DYNAMIC" or "STATIC"
Alias already exists	VA Alias already exists
Internal server error	Internal Server Error

post/collection/vaAlias/createBulk

Request

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

Request body

va_range_startstring

Numeric alias range reserved for this batch. Required together with va_range_end.

va_range_endstring

End of the numeric alias range.

Example request

{
  "va_range_start": "121",
  "va_range_end": "131",
  "aliasList": [
    {
      "va_code": "00001",
      "va_name": "John Doe",
      "va_email": "john.doe@example.com",
      "va_mobile": "9876543210",
      "va_activation_dt": "2025-11-13T10:00:00Z",
      "va_min_amount_limit": "100.00",
      "va_max_amount_limit": "5000.00",
      "va_allowed_remitter": [
        {
          "account_number": "12345678902",
          "account_ifsc": "HDFC0001234"
        }
      ]
    }
  ]
}

Response

Success or failure — see statusCode in the body.

Example response

{
  "statusCode": 200,
  "statusDesc": "Bulk VA Alias Processing Completed",
  "results": [
    {
      "statusCode": 200,
      "statusDesc": "VA Alias Created Successfully",
      "alias": "121",
      "data": {
        "id": 127,
        "va_alias": "121",
        "is_active": 1
      }
    }
  ]
}

Changes

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