put
https://example.com/api/accounts/bank-accounts/
Actualiza el alias de una cuenta bancaria existente mediante su bank_account_id.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Actualizá el alias de una cuenta bancaria existente usando su bank_account_id.
Antes de empezar
- Tené a mano el
bank_account_idde la cuenta bancaria que querés actualizar. - Prepará el nuevo valor de
aliasrespetando las restricciones del formato admitido. - Usá este endpoint cuando necesites corregir o reemplazar el alias de una cuenta ya asociada.
Cómo actualizar una cuenta bancaria
La ruta requiere el path parameter bank_account_id.
PUT /api/accounts/bank-accounts/{bank_account_id}Path parameters
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
bank_account_id | integer | Sí | Identificador de la cuenta bancaria que querés actualizar. |
Body parameters
El body acepta un objeto BankAccountUpdateInput.
| Campo | Tipo | Requerido | Restricciones | Descripción |
|---|---|---|---|---|
alias | string | Sí | mínimo 6, máximo 20, patrón ^[a-zA-Z0-9._]+$ | Nuevo alias de la cuenta bancaria. |
Ejemplo de request
{
"alias": "example.example"
}Qué devuelve este endpoint
La respuesta devuelve un arreglo items. Cada elemento representa la cuenta bancaria actualizada e incluye:
investment_account_id: cuenta comitente asociadacbu: CBU registradoalias: alias actualizadobank_account_id: identificador interno de la cuenta bancariacurrency_id: moneda de la cuenta bancariabank_entity_id: entidad bancariabank_account_type_id: tipo de cuenta bancaria
Respuesta esperada
{
"items": [
{
"investment_account_id": 15,
"cbu": "1234567891234567891234",
"alias": "example.example",
"bank_account_id": 34,
"currency_id": "ARS",
"bank_entity_id": 35,
"bank_account_type_id": "CA"
}
]
}Qué significa la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
investment_account_id | integer | Identificador de la cuenta comitente asociada. |
cbu | string | CBU de la cuenta bancaria. |
alias | string | Alias actualizado de la cuenta bancaria. |
bank_account_id | integer | Identificador interno de la cuenta bancaria. |
currency_id | string | Código de moneda de la cuenta bancaria. |
bank_entity_id | integer | Identificador de la entidad bancaria. |
bank_account_type_id | string | Tipo de cuenta bancaria. |
Errores frecuentes
404 Not Found: no existe una cuenta bancaria para elbank_account_idenviado.409 Conflict: existe un conflicto con el alias solicitado o con el estado actual de la cuenta.422 Validation Error: elbank_account_ido elaliastienen un formato inválido.
Siguiente paso
Después de actualizar el alias, consultá la cuenta con GET /api/accounts/bank-accounts/{bank_account_id} para validar el cambio o listá todas las cuentas bancarias de la cuenta comitente si necesitás refrescar una vista completa.
