Disponibilidad
La gestión de alias de cuentas virtuales está disponible en los siguientes países:Antes de comenzar
Asegúrate de tener:- Credenciales API válidas (token de acceso).
- El
externalIdde una cuenta virtual activa en estadoCOMPLETED.
Cómo funcionan los alias en Argentina
Argentina admite alias de CVU para cuentas virtuales. Características principales:- Formato: Solo letras (a–z, A–Z), números (0–9) y puntos (
.). No se permiten espacios, guiones, guiones bajos ni caracteres especiales. - Longitud: Entre 5 y 20 caracteres.
- Unicidad: El alias debe ser único a nivel de país. Esto no es una restricción de la plataforma, sino un requisito del sistema bancario argentino. Si otro CVU ya utiliza el mismo alias, la solicitud será rechazada.
- Actualización de un alias: Para actualizar un alias, llama al mismo endpoint con el nuevo valor una vez transcurrido el período de espera requerido.
- Límite de cambios: Una vez establecido o actualizado, un alias no puede volver a cambiarse durante 24 horas. El alias puede actualizarse un máximo de 10 veces en total.
- Activación asincrónica: El alias se activa en segundo plano. Una respuesta
INPROGRESSno significa que el alias ya esté activo. Verifica la activación mediante Obtener estado de la cuenta virtual.
alias.example · alias.example2026 · alias.example.test
Ejemplos de alias no válidos: alias example (espacio) · alias-example (guion) · alias_example (guion bajo) · alias@example (arroba)
Establecer alias de cuenta virtual
Establece un alias personalizado para una cuenta virtual activa existente. Esta operación asigna un alias nuevo y también actualiza uno existente. El mismo endpoint gestiona ambos casos.Parámetros clave de la solicitud
Ejemplo de solicitud
Respuesta exitosa
El estado
INPROGRESS significa que la solicitud fue recibida y se está procesando de forma asincrónica. El alias aún no está activo. Utiliza el endpoint Obtener estado de la cuenta virtual para confirmar la activación antes de notificar a tus usuarios finales.Verificar la activación del alias
Después de recibir una respuestaINPROGRESS, consulta la cuenta virtual para confirmar que el alias está activo. Envía una solicitud GET al endpoint de estado individual:
beneficiary.bank.account.alias:
INPROGRESS, el error aparecerá en el arreglo errors de esta misma respuesta. Consulta periódicamente el endpoint de estado hasta que errors esté vacío y el alias sea visible en beneficiary.bank.account.alias.
Campos de respuesta clave
Respuestas de error
Los siguientes códigos de error se aplican a la respuesta sincrónica. Si la respuesta inicial esINPROGRESS, la operación fue aceptada, pero aún pueden producirse errores durante el procesamiento asincrónico. Para detectarlos, consulta Obtener estado de la cuenta virtual y revisa el arreglo errors.
Escenarios de errores comunes
Demo

Próximos pasos
Crear cuentas virtuales
Genera nuevas cuentas virtuales que se pueden personalizar con alias.
Gestionar el estado de la cuenta virtual
Verifica el estado de las cuentas virtuales y sus alias asociados.
Referencia de la API
Referencia completa de parámetros del endpoint Establecer alias.

