Asignar alias

Productos en los que aplica:

Descripción

Asigna un nuevo alias o modifica el alias a un CVU existente.

Por defecto, el id requerido para asignar el alias no es el id de la cuenta sino que es el id del CVU

Por defecto, el id requerido para asignar el alias no es el id de la cuenta sino que es el id del CVU

Por defecto, el id requerido para asignar el alias no es el id de la cuenta sino que es el id del CVU

Endpoint

PATCH

/walletentidad-cuenta/v1/api/v1.201/AsignarAlias/CVU/{id}

Request

id int
REQUIRED
Identificador del CVU al que se desea asignar un nuevo alias.

alias string
REQUIRED
Alias a asignar.
Valores permitidos:
- Longitud máxima de 20 caracteres.

idEsCuenta boolean
OPTIONAL
Indica si el campo id enviado en este request corresponde al idCuenta en lugar del idCVU.
Valores por defecto: false


Ejemplo de request

Copy code

curl --location --request PATCH 'https://gw-staging-qrbind.epays.services/walletentidad-cuenta/v1/api/v1.201/AsignarAlias/CVU/154552' \
--header 'Authorization: Bearer 12345XAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6Ikg5bmo1QU9Tc3dNcGhnMVNGeDdqYVYtbEI5dyJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MjUzODg5OTcsIm5iZiI6MTcyNTM4ODk5NywiZXhwIjoxNzI1MzkyODk3LCJhaW8iOiJFMmRnWUtqdHZacGFmMDlQWmxmbHBwWGZwZFBmdjloazFkdVFWOTYzaEtVOHlIWHgzbkFBIiwiYXpwIjoiMDQ5MjgyOTgtNGM3Zi00OTEyLWFiYTgtZThhOGY1NmZhZDVkIiwiYXpwYWNyIjoiMSIsIm9pZCI6ImFhNmIyMTFiLTVmZDMtNDUzYi1iMzBkLTA4MzNhMzE4MDU5YiIsInJoIjoiMC5BWDBBaVZ2dllmT05uVW1NRXpqLTFkQ2NjaXVSMWJZMFRySlBuekVuRS1FSzkwV2FBQUEuIiwicm9sZXMiOlsiR3JvdXAuQWRtaW4iLCJYLUVudGlkYWQuMSIsIlgtQ2xpZW50TmFtZS53YWxsZXRBZG1pbiJdLCJzdWIiOiJhYTZiMjExYi01ZmQzLTQ1M2ItYjMwZC0wODMzYTMxODA1OWIiLCJ0aWQiOiI2MWVmNWI4OS04ZGYzLTQ5OWQtOGMxMy0zOGZlZDVkMDljNzIiLCJ1dGkiOiJsd3h1MkJOX0dFR2RvSXlxRlN3VUFBIiwidmVyIjoiMi4wIn0.VZMfLnrsW3720NjtcESUHShkmEGjwCYIKB4I0h-bFODv_5QMtQ9ezBBYI6HfDVvekivdAcrWdmytmLiXuw180hT49mPLGZwumbqi5Xj6toI6HyT1y90YyeRjt5I40MevLgNDHRoaUjYGxU8NSyDehDavzJw9xDSFdpdxMzGWROJG9Sd8jxo7YSrPGGZyb9onUN1P1ltMLRJQ8UU4Oh_wegasE7fDNwfxGd9t9jlm_60WbAcp99RvziZ5fz0sUMdbmafSRc54Fh6KSgjjs8ZqbdyLXYRKNQgcoOkt8krYBZhOUEhlsbnuqcLiGGfhZbJaAaMLTRJI64VVEk3DMVSV6g' \
--header 'Content-Type: application/json' \
--data '{
    "alias": "Carlitos.perez7896"
}'

Response

id int
Identificador del CVU creado. Es diferente al CVU de la cuenta. Se utiliza luego para realizar acciones sobre el CVU, como por ejemplo: Eliminar CVU.

cvu string
CVU creado.

alias string
Alias creado por defecto para este CVU. Puede modificarse.

idCuenta int
Identificador de la cuenta.

nombreCvu string
Nombre con que se creó el CVU.

Ejemplo de response

HTTP 204

Asignación de alias exitosa

Copy code

HTTP 204

Asignación de alias exitosa

Copy code

HTTP 204

Asignación de alias exitosa

Copy code

HTTP 422

No existe el id de CVU

Copy code

HTTP 422

No existe el id de CVU

Copy code

HTTP 422

No existe el id de CVU

Copy code

HTTP 422

El alias ya se encuentra en uso

Copy code

HTTP 422

El alias ya se encuentra en uso

Copy code

HTTP 422

El alias ya se encuentra en uso

Copy code

HTTP 422

El formato del alias es incorrecto

Copy code

HTTP 422

El formato del alias es incorrecto

Copy code

HTTP 422

El formato del alias es incorrecto

Copy code

HTTP 422

El alias se intenta modificar más de una vez en 24 horas

Copy code

HTTP 422

El alias se intenta modificar más de una vez en 24 horas

Copy code

HTTP 422

El alias se intenta modificar más de una vez en 24 horas

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

Changelog

10/12/2024 - Se agrega la posiblidad de asignar el alias de una cuenta con el idCuenta en vez de con el idCVU, utilizando este mismo endpoint, indicandolo en el request.

DEVELOPERS

Listado de API disponibles para

QR INTEROPERABLE

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

ONBOARDING

LIQUIDADOR

Autenticación

Cobrar con QR dinámico

DEVELOPERS

DEVELOPERS

DEVELOPERS