Update Bank Account

Actualiza el alias de una cuenta bancaria existente mediante su bank_account_id.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Actualizá el alias de una cuenta bancaria existente usando su bank_account_id.

Antes de empezar

  1. Tené a mano el bank_account_id de la cuenta bancaria que querés actualizar.
  2. Prepará el nuevo valor de alias respetando las restricciones del formato admitido.
  3. 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ámetroTipoRequeridoDescripción
bank_account_idintegerSíIdentificador de la cuenta bancaria que querés actualizar.

Body parameters

El body acepta un objeto BankAccountUpdateInput.

CampoTipoRequeridoRestriccionesDescripción
aliasstringSí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 asociada
  • cbu: CBU registrado
  • alias: alias actualizado
  • bank_account_id: identificador interno de la cuenta bancaria
  • currency_id: moneda de la cuenta bancaria
  • bank_entity_id: entidad bancaria
  • bank_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

CampoTipoDescripción
investment_account_idintegerIdentificador de la cuenta comitente asociada.
cbustringCBU de la cuenta bancaria.
aliasstringAlias actualizado de la cuenta bancaria.
bank_account_idintegerIdentificador interno de la cuenta bancaria.
currency_idstringCódigo de moneda de la cuenta bancaria.
bank_entity_idintegerIdentificador de la entidad bancaria.
bank_account_type_idstringTipo de cuenta bancaria.

Errores frecuentes

  • 404 Not Found: no existe una cuenta bancaria para el bank_account_id enviado.
  • 409 Conflict: existe un conflicto con el alias solicitado o con el estado actual de la cuenta.
  • 422 Validation Error: el bank_account_id o el alias tienen 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.

Path Params
integer
required
Body Params
string
required
length between 6 and 20
^[a-zA-Z0-9._]+$

Alias string

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json