Saltar al contenido principal
Localpayment te permite crear y administrar alias para cuentas virtuales en Argentina, ofreciendo referencias fáciles de recordar que pueden utilizarse en lugar de los números de CVU para realizar pagos. Los alias simplifican el proceso de pago al reemplazar un CVU de 22 dígitos por una cadena de texto corta y legible, más fácil de compartir y de recordar.

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 externalId de una cuenta virtual activa en estado COMPLETED.
Una cuenta virtual debe estar en estado COMPLETED antes de que puedas asignarle un alias. Esta transición de estado es automática.

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 INPROGRESS no significa que el alias ya esté activo. Verifica la activación mediante Obtener estado de la cuenta virtual.
Ejemplos de alias válidos: 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

Consulta todos los parámetros disponibles en la referencia de la API.

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 respuesta INPROGRESS, consulta la cuenta virtual para confirmar que el alias está activo. Envía una solicitud GET al endpoint de estado individual:
Una vez que el alias está activo, aparece en beneficiary.bank.account.alias:
Si la configuración del alias falla de forma asincrónica después de una respuesta 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 es INPROGRESS, 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.
Última modificación el 10 de noviembre de 2026