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

# Excluir Virtual Account

Desative permanentemente as contas virtuais que não são mais necessárias usando o endpoint da API.

A operação `DELETE` **desativa permanentemente** uma conta virtual, impedindo que ela receba pagamentos futuros. O histórico e os dados de transações associados à conta são preservados em nosso sistema para fins de conformidade, relatórios e conciliação.

**Importante**: Esta ação é irreversível. Uma conta desativada não pode ser reativada. Se precisar reativar a cobrança de pagamentos para o mesmo beneficiário, você deverá [criar uma nova conta virtual](https://docs.localpayment.com/pt-br/docs/create-a-virtual-account.md) .

Utilize este endpoint para limpar contas que não estão mais ativas em seu fluxo de trabalho operacional.

## Disponibilidade

A exclusão de contas virtuais via API está disponível nos seguintes países:

| País | Excluir |
| - | - |
| **[Argentina](https://docs.localpayment.com/pt-br/docs/argentina.md)** | ✔ |
| **[Brasil](https://docs.localpayment.com/pt-br/docs/brazil.md)** | ✔ |
| **[Chile](https://docs.localpayment.com/pt-br/docs/chile.md)** | ✔ |
| **[Colômbia](https://docs.localpayment.com/pt-br/docs/colombia.md)** | ✔ |
| **[México (SPEI e TEF)](https://docs.localpayment.com/pt-br/docs/mexico.md)** | ✔ |
| **[Peru](https://docs.localpayment.com/pt-br/docs/peru.md)** | — |

***

## Antes de começar

Certifique-se de ter:

* [Credenciais de API](https://docs.localpayment.com/pt-br/docs/api-keys-and-environments.md) válidas (token de acesso).
* ID externo da conta virtual que você deseja excluir.

***

## Exclusão de conta virtual

Atualmente, a exclusão de contas virtuais está disponível apenas por meio da API. Utilize este método para processos automatizados de limpeza e gerenciamento de contas.

Antes de excluir uma conta virtual, certifique-se de que ela atenda aos seguintes critérios:

| Status | Pode excluir | Notas |
| - | - | - |
| `COMPLETED` | ✅ | Contas ativas podem ser excluídas. |
| `DISABLED` | ✅ | Contas já desativadas podem ser excluídas. |
| `INPROGRESS` | ❌ | Aguarde a conclusão da criação da conta. |
| Possui transações pendentes | ❌ | Resolva primeiro todas as transações pendentes. |
| Possui fundos não compensados | ❌ | Aguarde a compensação e liquidação dos fundos. |

### Exemplo de solicitação

Envie uma requisição `DELETE` ao endpoint [Delete Virtual Account](https://docs.localpayment.com/pt-br/reference/delete-virtual-account.md) usando o 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-chave da solicitação

A solicitação requer vários parâmetros-chave:

| Objeto | Descrição | Obrigatório |
| - | - | - |
| `externalId` | O ID externo da conta virtual a ser excluída (parâmetro de caminho) | ✅ |

Veja todos os [parâmetros disponíveis](https://docs.localpayment.com/pt-br/reference/delete-virtual-account.md) na solicitação.

### Resposta bem-sucedida

```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 resposta principais

| Campo | Descrição | Caso de uso |
| - | - | - |
| `internalId` | Identificador único da Localpayment para a conta virtual excluída. | Rastreamento e suporte de transações |
| `externalId` | Seu número de referência original para a virtual account. | Reconciliação interna |
| `status.code` | Código de status da transação atual | Monitoramento de status |

***

## Próximos passos

Após excluir contas virtuais, você pode querer:

> [card] [Ver status da conta](https://docs.localpayment.com/pt-br/docs/get-virtual-account-status.md)
>
> Verifique o status da conta virtual antes de tentar excluí-la.

> [card] [Criar novas contas virtuais](https://docs.localpayment.com/pt-br/docs/create-a-virtual-account.md)
>
> Gere novas contas virtuais para atender às necessidades contínuas da empresa.


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