> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Habilitar/Deshabilitar cuenta virtual

Localpayment te permite suspender o reactivar temporalmente cuentas virtuales, lo que te brinda flexibilidad para gestionar el estado de la cuenta sin eliminarla permanentemente. Esto resulta útil para retenciones temporales, resolución de disputas o para gestionar patrones de negocio estacionales.

## Antes de comenzar

Asegúrate de tener:

* [Credenciales API ](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)válidas (token de acceso).
* Identificador externo de cuenta virtual que deseas habilitar o deshabilitar.
* Comprensión del estado actual de la cuenta virtual.

***

## Gestión del estado de la cuenta virtual

Gestiona el estado de tu cuenta virtual utilizando cualquiera de los siguientes métodos:

> [card] [Habilitar cuenta virtual](#enable-virtual-account)
>
> Habilita una cuenta virtual previamente desactivada para que vuelva a aceptar pagos.

> [card] [Deshabilitar cuenta virtual](#disable-virtual-account)
>
> Suspende temporalmente una cuenta virtual para evitar pagos adicionales, conservando al mismo tiempo los datos de la cuenta.

> [card] [Consultar el estado de la cuenta](https://docs.localpayment.com/es/docs/get-virtual-account-status.md)
>
> Verifica el estado actual de una cuenta virtual antes de activarla o desactivarla.

***

## Referencia del estado de la cuenta virtual

Comprender el estado de las cuentas virtuales es fundamental para una correcta gestión de activación/desactivación:

| Descripción | Puede habilitar | Se puede deshabilitar |
| - | - | - |
| INPROGRESS | ❌ | ❌ |
| COMPLETED | ❌ | ✅ |
| DELETED | ❌ | ❌ |
| DISABLED | ✅ | ❌ |

***

## Habilitar cuenta virtual

Reactiva una cuenta virtual previamente desactivada para reanudar la aceptación de pagos.

Envía una solicitud `PUT` al endpoint [Actualizar el estado de la cuenta virtual](https://docs.localpayment.com/es/reference/update-virtual-account-status.md) utilizando el ID externo:

### Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza `curl`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request PUT \
     --url https://api.stage.localpayment.com/api/virtual-account/{externalId}/activation/enable/ \
  --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json'
```

### Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

| Parámetro | Descripción | Requerido |
| - | - | - |
| `externalId` | El ID externo de la cuenta virtual que se va a habilitar (parámetro de ruta) | ✅ |

### Respuesta exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "currency": "MXN",
  "externalId": "e36ef929-c2d4-fcf0-b30c-99dc51798f4b",
  "internalId": "c09095fb-6a0e-47af-9f43-3d9452b0f290",
  "accountNumber": "{{accountNumber}}",
  "beneficiary": {
    "type": "INDIVIDUAL",
    "name": "John",
    "document": {
      "type": "RFC",
      "id": "EXTF900101NI1"
    },
    "bank": {
      "branch": {},
      "account": {
        "number": "646011319800023123",
        "aliases": [],
        "owner": {
          "document": {}
        }
      }
    },
    "fullName": "John Doe",
    "lastName": "Doe"
  },
  "status": {
    "code": "200",
    "description": "COMPLETED",
    "detail": "Virtual account has been created"
  },
  "errors": []
}
```

### Campos de respuesta clave

| Campo | Descripción | Caso de uso |
| :- | :- | :- |
| `internalId` | Identificador único de Localpayment para la cuenta virtual. | Soporte y referencia del sistema |
| `externalId` | Tu número de referencia original para la cuenta virtual. | Conciliación interna y seguimiento |
| `status.code` | Código de estado actual de la cuenta virtual. | Determinar la usabilidad de la cuenta y las próximas acciones. |

***

## Deshabilitar cuenta virtual

Suspende temporalmente una cuenta virtual para evitar pagos adicionales, conservando al mismo tiempo los datos y el historial de la cuenta.

Envía una solicitud `PUT` al endpoint [Actualizar el estado de la cuenta virtual](https://docs.localpayment.com/es/reference/update-virtual-account-status.md) utilizando el ID externo:

> [!WARNING]
>
> **Importante**
>
> En Perú, cuando se desactiva una cuenta virtual, aparecerá como inexistente en la aplicación bancaria.

### Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza `curl`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request PUT \
     --url https://api.stage.localpayment.com/api/virtual-account/{externalId}/activation/disable/ \
  --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json'
```

### Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

| Parámetro | Descripción | Requerido |
| - | - | - |
| `externalId` | El ID externo de la cuenta virtual que se va a deshabilitar (parámetro de ruta) | ✅ |

### Respuesta exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "currency": "MXN",
  "externalId": "f059a032-9253-4607-9b8e-2948ed18d595",
  "internalId": "c09095fb-6a4e-17cf-9343-9d9452b0f290",
  "accountNumber": "{{accountNumber}}",
  "beneficiary": {
    "type": "INDIVIDUAL",
    "name": "John",
    "document": {
      "type": "RFC",
      "id": "EXTF900101NI1"
    },
    "bank": {
      "branch": {},
      "account": {
        "number": "646011319800023123",
        "aliases": [],
        "owner": {
          "document": {}
        }
      }
    },
    "fullName": "John Doe",
    "lastName": "Doe"
  },
  "status": {
    "code": "300",
    "description": "DISABLED",
    "detail": "Virtual account disabled"
  },
  "errors": []
}
```

### Campos de respuesta clave

| Campo | Descripción | Caso de uso |
| :- | :- | :- |
| `internalId` | Identificador único de Localpayment para la cuenta virtual. | Soporte y referencia del sistema |
| `externalId` | Tu número de referencia original para la cuenta virtual. | Conciliación interna y seguimiento |
| `status.code` | Código de estado actual de la cuenta virtual. | Determinar la usabilidad de la cuenta y las próximas acciones. |

***

## Próximos pasos

Tras gestionar el estado de activación de la cuenta virtual, es posible que debas realizar acciones adicionales:

> [card] [Consultar el estado de la cuenta virtual](https://docs.localpayment.com/es/docs/get-virtual-account-status.md)
>
> Verifica el estado actual de las cuentas virtuales habilitadas o deshabilitadas.

> [card] [Eliminar cuenta virtual](https://docs.localpayment.com/es/docs/delete-virtual-account.md)
>
> Desactiva permanentemente una cuenta virtual. Esto impide cualquier pago futuro, pero conserva todo su historial. Esta acción es irreversible. Úsala para cuentas que ya no necesites; crea una nueva para reanudar las operaciones.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.