---
title: "Actualizar"
method: PUT
path: "/financial_accounts/{id}"
tags: ["Financial Accounts"]
---

# Actualizar

`PUT /financial_accounts/{id}`

## Request

- Base URL: `https://api.ventipay.com/v1`
- URL: `https://api.ventipay.com/v1/financial_accounts/{id}`
- Auth: HTTP bearer

Actualiza una cuenta: ajusta su límite (`credit_limit`) o cambia su estado (`status`). Congelar (`frozen`) impide nuevas compras; cerrar (`closed`) requiere saldo cero y es definitivo.

## Path parameters

- `id` string, required

## Request body

- object
  - `credit_limit` integer: Nuevo límite de crédito en unidades menores. No puede ser menor a la deuda más retenciones vigentes, ni mayor al máximo del programa.
  - `status` 'active' | 'frozen' | 'closed': Nuevo estado de la cuenta.
  - `metadata` string, json: Pares clave-valor con información adicional de la cuenta. No es visible para el cliente.

---

[API](https://skmtc.dev/ventipay/apis/cuentas-venti.md) - [All operations](https://skmtc.dev/ventipay/apis/cuentas-venti/llms.txt) - [OpenAPI document](https://skmtc.dev/ventipay/apis/cuentas-venti/revisions/28cc24151d4a?raw)