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

# Obtener estado de la cuenta virtual

Esta guía describe los diferentes enfoques para realizar un seguimiento del estado de las cuentas virtuales y gestionar su ciclo de vida.

Localpayment ofrece múltiples métodos para supervisar y obtener el estado actual de las cuentas virtuales, incluyendo comprobaciones de cuentas individuales, estado del procesamiento por lotes y visualización en el Business Portal.

## Disponibilidad

El seguimiento del estado de las cuentas virtuales está disponible en todos los países donde se admiten cuentas virtuales:

| País | Métodos compatibles |
| - | - |
| **[Argentina](https://docs.localpayment.com/es/docs/argentina.md)** | API individual, API por lotes, Business Portal |
| **[Brasil](https://docs.localpayment.com/es/docs/brazil.md)** | API individual, API por lotes, Business Portal |
| **[Chile](https://docs.localpayment.com/es/docs/chile.md)** | API individual, API por lotes, Business Portal |
| **[Colombia](https://docs.localpayment.com/es/docs/colombia.md)** | API individual, API por lotes, Business Portal |
| **[Costa Rica (CRC & USD)](https://docs.localpayment.com/es/docs/costa-rica.md)** | API individual, API por lotes, Business Portal |
| **[México](https://docs.localpayment.com/es/docs/mexico.md)** | API individual, API por lotes, Business Portal |
| **[Perú](https://docs.localpayment.com/es/docs/peru.md)** | API individual, Business Portal |

***

## 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).
* Identificadores de cuenta virtual o números de referencia de lote que deseas verificar.

***

## Referencia del estado de la cuenta virtual

Las cuentas virtuales pueden tener los siguientes estados a lo largo de su ciclo de vida:

| Estado | Código de estado | Descripción |
| - | - | - |
| **INPROGRESS** | `100` | Creación de cuenta virtual en curso |
| **COMPLETED** | `200` | Cuenta virtual activa y lista para recibir pagos. |
| **DISABLED** | `300` | La cuenta virtual ha sido desactivada temporalmente y no se puede utilizar para realizar transacciones. |
| **DELETED** | `908` | La cuenta virtual ha sido eliminada permanentemente. |

> [!NOTE]
>
> Los códigos de estado no son exclusivos de los estados de las cuentas virtuales. Por ejemplo, el código `300` también aparece con la descripción `REJECTED` en el endpoint [Crear una cuenta virtual](https://docs.localpayment.com/es/docs/create-a-virtual-account.md) cuando una solicitud no supera la validación. Lee siempre `status.code` junto con `status.description` en lugar de basarse únicamente en el código.

***

## Recuperar información de la cuenta virtual

Tras solicitar tu cuenta virtual, podrás consultar su estado utilizando cualquiera de los siguientes métodos:

> [card] [Consultar el estado de la cuenta virtual individual](#method-1-check-individual-virtual-account-status)
>
> Recupera el estado actual y los detalles de una cuenta virtual específica utilizando el endpoint de la API con el ID externo.

> [card] [Consultar el estado de la cuenta virtual del lote](#method-2-check-batch-virtual-account-status)
>
> Supervisa el estado de las cuentas virtuales creadas en operaciones por lotes, incluido el progreso de la creación y cualquier error.

> [card] [Consulta el estado de tu cuenta virtual a través del Business Portal.](#method-3-check-virtual-account-status-via-business-portal)
>
> Utiliza la interfaz visual del Business Portal para la supervisión manual, el filtrado y las operaciones masivas en cuentas virtuales.

***

## Método 1: Comprobar el estado de la cuenta virtual individual

Recupera el estado actual y los detalles de una cuenta virtual específica utilizando el endpoint de estado individual.

### Ejemplo de solicitud

Envía una solicitud `GET` al endpoint [Obtener estado de la cuenta virtual](https://docs.localpayment.com/es/reference/get-virtual-account-status.md). A continuación se muestra un ejemplo con `curl`:

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request GET \
     --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 objetos clave:

| Objeto | Descripción | Requerido |
| - | - | - |
| `externalId` | El ID externo utilizado al crear la cuenta virtual. | ✅ |

### Respuesta exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "currency": "MXN",
  "externalId": "f059a032-9253-4607-9b8e-2948ed18d595",
  "internalId": "9a8db65f-be31-42fb-8ebd-5fffd83bd6c6",
  "accountNumber": "{{accountNumber}}",
  "beneficiary": {
    "type": "INDIVIDUAL",
    "name": "Alejandra",
    "lastName": "Guzman",
    "fullName": "Alejandra Guzman",
    "document": {
      "type": "RFC",
      "id": "KCWV771228TS4"
    },
    "address": {
      "street": "Avenida Reforma",
      "number": "500",
      "city": "Ciudad de Mexico",
      "state": "CDMX",
      "country": "Mexico"
    }
  },
  "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. | 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. |

***

## Método 2: Comprobar el estado de la cuenta virtual por lotes

Supervisa el estado de las cuentas virtuales creadas en operaciones por lotes, incluido el progreso de la creación y cualquier error.

### Ejemplo de solicitud

Envía una solicitud `GET` al endpoint [Obtener estado de la cuenta virtual (por lotes)](https://docs.localpayment.com/es/reference/get-virtual-account-status-batch.md). A continuación se muestra un ejemplo con `curl`:

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

#### Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

| Objeto | Descripción | Requerido |
| - | - | - |
| `externalId` | Número de referencia del lote. | ✅ |

### Respuesta exitosa

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "ba671d03-b3bc-4312-8841-5c65a67713ca",
  "internalId": "91c0de90-9d70-44a6-b9c6-600f835802b6",
  "accountNumber": "{{accountNumber}}",
  "status": {
    "code": "200",
    "description": "COMPLETED",
    "detail": "Batch Process Virtual Account completed"
  },
  "comment": "The batch process is done - The process started at = 2025-01-03 22:59:14.355 - Total accounts requested = 12 - Total accounts created = 12 - The process finished at = 2025-01-03 22:59:17.716 - ",
  "csvFormatResponse": "internal_id,external_id,bank_account\ne68208a1-3197-4b1e-82f6-76525a734e56,1111111111-1,646011319800023500\n80dcc234-1010-427b-b256-3fff18325baf,1111111111-2,646011319800023501\nd779c2ab-2505-43b8-874c-fcb97a2e5fb7,1111111111-3,646011319800023502\nafd67163-fd79-4b2c-b288-c4d253bcec57,1111111111-4,646011319800023503\n01e1d1bb-c89c-4d41-849d-bd1d8e5c3785,1111111111-5,646011319800023504\n0ba88114-ae62-407b-9f03-8f863000c163,1111111111-6,646011319800023505\n0184a17a-5c38-4c43-b10a-15079662e518,1111111111-7,646011319800023506\nb80991f5-396d-485a-b480-fdfb8635bef3,1111111111-8,646011319800023507\ncd0f6180-c3ad-4a69-815f-25d6f053aee2,1111111111-9,646011319800023608\n95ea6157-2d17-459c-969a-708ca31cfc13,1111111111-10,646011319800023609\ncf50e4d2-ac34-48f4-a60f-b2ee8b152f6a,1111111111-11,646011319800023610\n70d1f0be-3db0-48fd-8493-b712038ea48e,1111111111-12,646011319800023611\n"
}
```

### 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 operación por lotes. | Conciliación interna y seguimiento |
| `status.code` | Código de estado actual del proceso por lotes. | Determinar la usabilidad de la cuenta y las próximas acciones. |

***

## Método 3: Consultar el estado de la cuenta virtual a través del Business Portal.

Para la supervisión manual y el análisis visual, utiliza el Business Portal de Localpayment para consultar el estado de la cuenta virtual.

### Acceso al Business Portal

1. Inicia sesión en tu [portal comercial de Localpayment](https://docs.localpayment.com/es/docs/dashboard-overview.md).
2. Navegar a **PayIn > Cuentas virtuales > Sección de actividad**
3. Utiliza filtros para buscar por:
   * **País**: Elige un país específico o selecciona **Todos** para incluir todos los países disponibles.
   * **Estado**: Filtra las cuentas por su estado actual o selecciona **Todas** para ver las cuentas con cualquier estado.
   * **Rango de fechas**: Especifica el rango de fechas en el que se crearon las cuentas virtuales. Esto filtra la lista según la fecha de creación, no según la fecha de actividad.
   * **Número de cuenta virtual**: Puedes buscar directamente por el número de cuenta virtual (VAN) para localizar rápidamente una entrada específica.

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/a0ed234f6b684112d81534a8f7e0bb5d20357447839c6adaa5d32dc9f143e186-Virtual-accounts-dashboard.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=27037dee9583061edbc70bee04f7bf40)

***

## Próximos pasos

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

> [card] [Instrucciones de pago](https://docs.localpayment.com/es/docs/payment-instructions.md)
>
> Proporciona a los pagadores los datos correctos del beneficiario que aparecen en la respuesta de la API de estado de la cuenta virtual para procesar los pagos sin problemas. Consulta las instrucciones específicas de cada país para garantizar una ejecución de pagos precisa y conforme a la normativa.

> [card] [Habilitar/Deshabilitar cuenta virtual](https://docs.localpayment.com/es/docs/activate-deactivate-virtual-account.md)
>
> Suspender o reactivar temporalmente las cuentas virtuales según las necesidades del negocio
> o las solicitudes de los clientes.

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