Update Virtual Bank Account Alias (Argentina Only)

Updates the custom alias of an existing virtual bank account. This operation synchronizes the alias change with both the Payment Service Provider (PSP) and the local database.

🚫 RESTRICTED ENDPOINT: This endpoint is ONLY available for Argentina (AR) accounts. All other countries (Mexico/MX, etc.) will receive a 400 error immediately.

Alias Requirements:

Must contain only letters, numbers, and dots (.)
Cannot be empty or contain special characters
Must be unique within the merchant’s account scope
Only supported for Argentina (AR) accounts

Validation Process:

Early validation: Rejects non-Argentina accounts immediately
Verifies the virtual bank account belongs to the specified merchant
Updates the alias in the PSP system
Synchronizes changes with the local database

Error Responses:

400 PIVBA00013: Alias not supported for this country (non-AR accounts)
404 PIVBA00001: Virtual bank account not found

Roles with Access:

Platform Admin
Wallet & Bank Admin

Updates the custom alias of an existing virtual bank account. This operation synchronizes the alias change with both the Payment Service Provider (PSP) and the local database. **🚫 RESTRICTED ENDPOINT:** This endpoint is ONLY available for Argentina (AR) accounts. All other countries (Mexico/MX, etc.) will receive a 400 error immediately. **Alias Requirements:** - Must contain only letters, numbers, and dots (.) - Cannot be empty or contain special characters - Must be unique within the merchant's account scope - Only supported for Argentina (AR) accounts **Validation Process:** - **Early validation:** Rejects non-Argentina accounts immediately - Verifies the virtual bank account belongs to the specified merchant - Updates the alias in the PSP system - Synchronizes changes with the local database **Error Responses:** - `400 PIVBA00013`: Alias not supported for this country (non-AR accounts) - `404 PIVBA00001`: Virtual bank account not found **Roles with Access:** - Platform Admin - Wallet & Bank Admin

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

organizationIdstringRequired

Organization identifier

merchantIdstringRequired

Merchant identifier

idstringRequired

Virtual bank account identifier

Request

This endpoint expects an object.

aliasstringRequired

New alias for the virtual bank account (Argentina only). Must contain only letters (a-z, A-Z), numbers (0-9), and dots (.). The alias will be updated both in the PSP and local database. Note: Alias functionality is only available for Argentina (AR) accounts.

Response

Alias updated successfully

idstring

Virtual bank account ID

merchantIdstring

Merchant ID

countryenum

Country code

Allowed values:

currencyenum

Currency code

Allowed values:

isActiveboolean

Active status of the account

createdAtdatetime

Creation date

updatedAtdatetime

Last update date

virtualBankAccountNumberstring or null

Virtual bank account number

aliasstring or null

Custom alias for the virtual bank account. Contains only letters, numbers, and dots.

Errors