Saltar al contenido principal
POST
Crear un alias para una cuenta virtual
Disponibilidad: Argentina Esta operación permite a los comerciantes asociar un alias personalizado y legible para humanos (alias CVU) con una cuenta virtual activa existente en Argentina. Un alias sustituye el código CVU de 22 dígitos por una cadena de texto corta y fácil de recordar, lo que reduce los errores al compartir los datos de pago.
Información
  • El alias debe ser único a nivel de país. Esta 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.
  • Para actualizar un alias, llama a este mismo endpoint con el nuevo valor una vez transcurrido el período de espera obligatorio de 24 horas.
  • Una vez creado o actualizado, el alias no se puede volver a modificar durante 24 horas. No hay límite en el número total de cambios.
  • El alias se activa de forma asincrónica. Una respuesta INPROGRESS no significa que el alias ya esté activo. Verifica la activación mediante el endpoint Obtener estado de la cuenta virtual.
  • Para consultar qué alias están activos actualmente en una cuenta virtual, utiliza el endpoint Obtener estado de la cuenta virtual.

Reglas de formato de alias

  • Solo se permiten letras (a–z, A–Z), números (0–9) y puntos (.).
  • No se permiten espacios, guiones, guiones bajos, arrobas (@) ni otros caracteres especiales.
  • La longitud debe estar entre 5 y 20 caracteres.
  • Ejemplos válidos: alias.example, alias.example2026, alias.example.test

Mejores prácticas

  • Utiliza alias significativos y coherentes para facilitar la conciliación interna y los flujos de trabajo.
  • Registra las respuestas de creación de alias y asócialas con tus registros de transacciones internas para facilitar la auditoría.
  • Utiliza el endpoint de verificación de estado periódicamente o antes del cobro del pago para verificar que el alias esté activo y asignado correctamente.

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token.

Parámetros de ruta

externalId
string
requerido

El identificador único de la cuenta virtual a la que deseas agregar un alias. Debe coincidir exactamente con el valor de externalId que proporcionaste al crear la cuenta virtual.

Cuerpo

application/json
type
enum<string>
requerido

Tipo de alias. Para Argentina, el único valor válido es C (personalizable: texto definido por el usuario).

Opciones disponibles:
C
value
string
requerido

El valor de alias deseado. Solo se permiten letras (a–z, A–Z), números (0–9) y puntos (.). Debe tener entre 5 y 20 caracteres. Debe ser único en toda la plataforma. Ejemplo: alias.example, alias.example2026.

Required string length: 5 - 20

Respuesta

Creado

externalId
string

El identificador único de la cuenta virtual. Este es el mismo externalId que proporcionó en la solicitud, lo que confirma que el alias se creó para la cuenta correcta.

alias
object

Información de alias.

status
object

Información de estado.

Última modificación el 10 de noviembre de 2026