> ## 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.

# Eliminar cuenta virtual

Desactiva permanentemente las cuentas virtuales que ya no sean necesarias mediante el endpoint de la API.

La operación `DELETE` **desactiva permanentemente** una cuenta virtual, lo que impide que reciba pagos futuros. El registro histórico y los datos de las transacciones asociados a la cuenta se conservan en nuestro sistema para fines de cumplimiento normativo, elaboración de informes y conciliación.

**Importante**: Esta acción es irreversible. Una cuenta desactivada no se puede reactivar. Si necesitas volver a habilitar el cobro de pagos para el mismo beneficiario, debes [crear una nueva cuenta virtual](https://docs.localpayment.com/es/docs/create-a-virtual-account.md) .

Utiliza este endpoint para eliminar las cuentas que ya no están activas en tu flujo de trabajo operativo.

## Disponibilidad

La eliminación de cuentas virtuales a través de API está disponible en los siguientes países:

| País | Eliminar |
| - | - |
| **[Argentina](https://docs.localpayment.com/es/docs/argentina.md)** | ✔ |
| **[Brasil](https://docs.localpayment.com/es/docs/brazil.md)** | ✔ |
| **[Chile](https://docs.localpayment.com/es/docs/chile.md)** | ✔ |
| **[Colombia](https://docs.localpayment.com/es/docs/colombia.md)** | ✔ |
| **[México (SPEI y TEF)](https://docs.localpayment.com/es/docs/mexico.md)** | ✔ |
| **[Perú](https://docs.localpayment.com/es/docs/peru.md)** | — |

***

## 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).
* ID externo de cuenta virtual que deseas eliminar.

***

## Eliminación de cuenta virtual

Actualmente, la eliminación de cuentas virtuales solo está disponible a través del endpoint de la API. Utiliza este método para procesos de limpieza automatizados y administración de cuentas.

Antes de eliminar una cuenta virtual, asegúrate de que cumple con los siguientes criterios:

| Estado | Se puede eliminar | Notas |
| - | - | - |
| `COMPLETED` | ✅ | Las cuentas activas pueden eliminarse |
| `DISABLED` | ✅ | Las cuentas ya desactivadas pueden eliminarse. |
| `INPROGRESS` | ❌ | Espera a que se complete la creación de la cuenta. |
| Tiene transacciones pendientes | ❌ | Resuelve primero todas las transacciones pendientes. |
| Tiene fondos no liquidados | ❌ | Espera a que los fondos se liquiden y se hagan efectivos. |

### Ejemplo de solicitud

Envía una solicitud `DELETE` al endpoint [Eliminar cuenta virtual](https://docs.localpayment.com/es/reference/delete-virtual-account.md) utilizando el ID externo:

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

### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

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

Consulta todos los [parámetros disponibles](https://docs.localpayment.com/es/reference/delete-virtual-account.md) en la solicitud.

### Respuesta exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "currency": "MXN",
  "externalId": "f059a032-9253-4607-9b8e-2948ed18d595",
  "internalId": "d710312c-8c3f-4b65-8e62-7f83eeba321a",
  "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": "100",
    "description": "INPROGRESS",
    "detail": "Virtual account in progress"
  },
  "errors": []
}
```

### Campos de respuesta clave

| Campo | Descripción | Caso de uso |
| - | - | - |
| `internalId` | Identificador único de Localpayment para la cuenta virtual eliminada. | Seguimiento y soporte de transacciones |
| `externalId` | Tu número de referencia original para la cuenta virtual. | Reconciliación interna |
| `status.code` | Código de estado de transacción actual | Monitoreo de estado |

***

## Próximos pasos

Después de eliminar las cuentas virtuales, es posible que desees:

> [card] [Ver estado de la cuenta](https://docs.localpayment.com/es/docs/get-virtual-account-status.md)
>
> Verifica el estado de la cuenta virtual antes de intentar eliminarla.

> [card] [Crear nuevas cuentas virtuales](https://docs.localpayment.com/es/docs/create-a-virtual-account.md)
>
> Genera nuevas cuentas virtuales para las necesidades comerciales habituales.


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