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

# Crear una cuenta virtual

Genera cuentas virtuales para clientes a través de la API de Localpayment. Compatible con procesamiento individual y por lotes.

Genera programáticamente cuentas virtuales para tus clientes a través de la API de Localpayment. Admite tanto la creación de cuentas individuales como el procesamiento por lotes de múltiples cuentas.

## Antes de comenzar

Asegúrate de tener:

> [card] [Credenciales de API](https://docs.localpayment.com/es/docs/api-keys-and-environments.md)
>
> Credenciales API válidas y token de acceso para la autenticación.

> [card] [Configuración de la cuenta](https://docs.localpayment.com/es/docs/make-your-first-test-payment.md)
>
> Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

> [card] [Lista blanca de IP](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md)
>
> Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

> [card] [Endpoint del webhook](https://docs.localpayment.com/es/docs/webhooks.md)
>
> Configura una URL de webhook para recibir notificaciones de pago.

***

## Métodos de creación de cuentas virtuales

Ofrecemos opciones flexibles para la creación de cuentas virtuales que se adaptan a diferentes necesidades operativas. Puedes crear cuentas virtuales mediante métodos [**en línea (API)**](https://docs.localpayment.com/es/reference/create-virtual-account.md)  y [**fuera de línea**](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md), e independientemente del método elegido, dispones de dos modos de creación:

* [**Creación individual**](#option-1-individual-virtual-account-creation) : Genera cuentas virtuales únicas con configuraciones específicas, ideales para flujos de trabajo impulsados ​​por el cliente y escenarios que requieren personalización por cuenta.
* [**Creación por lotes**](#option-2-create-virtual-accounts-in-batch) : Procesa varias cuentas virtuales en una sola operación, optimizada para la generación masiva de cuentas, la incorporación masiva de usuarios y escenarios donde se prioriza la eficiencia del procesamiento.

| País | En línea | Desconectado |
| :- | :- | :- |
| **[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)** | ✔ | — |
| **[Costa Rica (CRC y USD)](https://docs.localpayment.com/es/docs/costa-rica.md)** | ✔ | ✔ |
| **[México (SPEI, SPID y TEF)](https://docs.localpayment.com/es/docs/mexico.md)** | ✔ | ✔ |
| [**Perú (PEN y USD)**](https://docs.localpayment.com/es/docs/peru.md) | ✔ | — |

> [!WARNING]
>
> **Importante**
>
> No se aceptan depósitos en efectivo. Las cuentas virtuales solo pueden recibir pagos electrónicos. Cualquier depósito en efectivo realizado a una cuenta virtual, ya sea en una sucursal bancaria, cajero automático o cualquier otro medio, no se acreditará al comercio. Los pagadores deben enviar los fondos exclusivamente mediante transferencia bancaria, utilizando las plataformas de pago electrónico disponibles en su país.

***

## Requisitos del beneficiario

Comprender las restricciones para los beneficiarios es fundamental para crear una cuenta virtual con éxito. Cada país tiene regulaciones específicas sobre quiénes pueden figurar como beneficiarios, lo que influye directamente en la estructura de las operaciones de pago.

### Requisitos de residencia por país

La siguiente tabla detalla qué tipos de beneficiarios se aceptan en cada país:

<table>
  <thead>
    <tr>
      <th>
        País
      </th>

      <th>
        Residentes locales
      </th>

      <th>
        residentes extranjeros
      </th>

      <th>
        Propietario de la cuenta
      </th>

      <th>
        Alias
      </th>

      <th>
        Nombre para mostrar de la transferencia bancaria
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Argentina
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        * **FBO** = Residentes Extranjeros
        * **DDA** = Residentes locales
      </td>

      <td>
        Creación de hasta 1 alias
      </td>

      <td>
        * **Nombre del beneficiario** (proporcionado durante la creación de la cuenta virtual, si es argentino)
        * **Nombre de la entidad legal de Localpayment** (en todos los demás casos)
      </td>
    </tr>

    <tr>
      <td>
        Brasil
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        * **FBO** = Residentes Extranjeros
        * **DDA** = Residentes locales
      </td>

      <td>
        N / A
      </td>

      <td>
        **Nombre de la entidad legal de Localpayment**
      </td>
    </tr>

    <tr>
      <td>
        Chile
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        **FBO**
      </td>

      <td>
        N / A
      </td>

      <td>
        **Nombre de la entidad legal de Localpayment**
      </td>
    </tr>

    <tr>
      <td>
        Colombia
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        **FBO**
      </td>

      <td>
        Clave predeterminada
      </td>

      <td>
        **Nombre de la entidad legal de Localpayment**
      </td>
    </tr>

    <tr>
      <td>
        México
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        **DDA** = Residentes locales
      </td>

      <td>
        N / A
      </td>

      <td>
        **Nombre de la entidad legal de Localpayment**
      </td>
    </tr>

    <tr>
      <td>
        Perú
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        **FBO**
      </td>

      <td>
        N / A
      </td>

      <td>
        **Nombre de la entidad legal de Localpayment**
      </td>
    </tr>

    <tr>
      <td>
        Costa Rica
      </td>

      <td>
        ✅
      </td>

      <td>
        ✅
      </td>

      <td>
        **FBO**
      </td>

      <td>
        N / A
      </td>

      <td>
        **Nombre de la entidad legal de Localpayment**
      </td>
    </tr>
  </tbody>
</table>

> [!NOTE]
>
> ###
>
> **Notas**:
>
> * **El titular de la cuenta** se refiere al nombre legal del titular registrado en el sistema bancario (el nombre visible a nivel bancario). **FBO** (Para beneficio de) significa que la cuenta se abre a nombre de Localpayment y contiene fondos para beneficio del cliente final. **DDA** (Cuenta de depósito a la vista) significa que la cuenta se abre directamente a nombre del beneficiario.
> * **Alias**: se refiere al número de alias (o tipo de alias) que se pueden registrar para una cuenta virtual, cuando esta lo permite.
> * **Nombre para mostrar en la transferencia bancaria**: se refiere al nombre que se muestra al pagador durante una transferencia electrónica de fondos a la cuenta virtual.

### Información del beneficiario necesaria para crear una cuenta virtual.

**Información requerida:**

* **Tipo de beneficiario**: Define si la cuenta virtual pertenece a un particular o a una empresa:
  * INDIVIDUAL: Para una cuenta personal.
  * COMPANY: Para una entidad comercial/jurídica.
* **Nombre del beneficiario**: Nombre completo de la persona o razón social.
* **Documento del beneficiario**: Información de identificación oficial para verificar la identidad.
* **Dirección**: Dirección completa del beneficiario.
* **Sitio web**: La URL del sitio web del beneficiario.

***

## Requisitos específicos de cada país

Los detalles de implementación para las cuentas virtuales varían según el país. Los países que no se mencionan explícitamente se rigen por el procedimiento estándar sin requisitos especiales. Revisa estos requisitos antes de la integración:

> [tab] Argentina
>
> | Propiedad | Descripción |
> | - | - |
> | Confirmación de pago del SLA | Tiempo real 24/7 |
> | Procesamiento de divisas | `ARS` (Peso argentino) |
> | Importe mínimo de la transacción | ARS 1.00 |
> | Monto máximo de la transacción | Sin límite máximo. |
> | Formato de cuenta local | Cuenta Virtual Uniforme (CVU) |
> | centro de compensación | COELSA |
> | Número máximo de cuentas virtuales | Ilimitado |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account), [Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) |
>
> ### Formato de cuenta
>
> En Argentina, el CVU (Clave Virtual Uniforme) es un código numérico de 22 dígitos utilizado por las cuentas virtuales emitidas por los PSP (Proveedores de Servicios de Pago).
>
> **Estructura:**
>
> * Posiciones 1-3: 3 dígitos - Código de la entidad emisora ​​(PSP).
> * Posiciones 4-7: 4 dígitos - Identificador del tipo de cuenta dentro del PSP.
> * Posición 8: 1 dígito - Dígito de verificación (suma de comprobación).
> * Posiciones 9-21: 13 dígitos - Número de cuenta único dentro del PSP.
> * Posición 22: 1 dígito – Dígito de control (validador de suma de comprobación).
>
> **Ejemplo**: `0000003112345678901234`

> [tab] Brasil
>
> | Propiedad | Descripción |
> | - | - |
> | Confirmación de pago del SLA | Tiempo real 24/7 |
> | Procesamiento de divisas | `BRL` (Real brasileño) |
> | Importe mínimo de la transacción | BRL 0,01 |
> | Monto máximo de la transacción | BRL 1.000.000,00 |
> | Formato de cuenta local | Código bancario, sucursal y número de cuenta (utilizados tanto por TED como por Pix). En el caso de Pix, el pagador también puede usar la clave Pix (alias). |
> | Métodos de depósito admitidos | **Pix** y **TED** |
> | centro de compensación | Pix, TED |
> | Número máximo de cuentas virtuales | Ilimitado |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account) |
>
> ### Formato de cuenta
>
> En Brasil, cada cuenta virtual se identifica mediante una **clave Pix** (alias) y acepta fondos entrantes a través de **Pix** y **TED** . Ambas plataformas se resuelven en la misma cuenta subyacente, y tu integración recibe la misma notificación webhook independientemente de la plataforma que haya utilizado el pagador.
>
> **Para las transferencias de TED y Pix**, el pagador puede utilizar los siguientes tres campos de la respuesta de la API:
>
> * `beneficiary.bank.code` — el código bancario.
> * `beneficiary.bank.branch.code` — el código de la sucursal (agencia).
> * `beneficiary.bank.account.number` — el número de cuenta.
>
> **Solo para Pix**, el pagador puede usar alternativamente la **clave Pix** (alias) devuelta en `beneficiary.bank.account.aliases`. No se requieren otros campos.
>
> **Estructura de clave Pix:**
>
> Una clave Pix puede tener uno de los siguientes formatos:
>
> * **Número de teléfono móvil**: 10 dígitos — el número de teléfono móvil registrado del beneficiario.
> * **Dirección de correo electrónico**: la dirección de correo electrónico registrada del beneficiario.
> * **Clave aleatoria**: Cadena alfanumérica generada por el sistema.
>
> **Notas**:
>
> * Las cuentas individuales (PF) pueden registrar hasta 5 Pix Keys, mientras que las cuentas corporativas (PJ) pueden registrar hasta 20.

> [tab] Chile
>
> > [!WARNING]
> >
> > Ten en cuenta los límites de transferencia bancaria y las normas de seguridad locales para evitar el rechazo de las transacciones. Consulta la [guía de Chile](https://docs.localpayment.com/es/docs/chile.md#banking-transaction-limits-and-rules) para obtener información detallada.
>
> | Propiedad | Descripción |
> | - | - |
> | Confirmación de pago del SLA | Tiempo real 24/7 |
> | Procesamiento de divisas | `CLP` (Peso chileno) |
> | Importe mínimo de la transacción | CLP 1.00 |
> | Monto máximo de la transacción | CLP 7.000.000,00 |
> | Formato de cuenta local | Número de cuenta (entre 6 y 16 dígitos) |
> | centro de compensación | CCA |
> | Número máximo de cuentas virtuales | Ponte en contacto con tu gestor de cuenta. |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account), [Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) |

> [tab] Colombia
>
> | Propiedad | Descripción |
> | - | - |
> | Confirmación de pago del SLA | Tiempo real 24/7 |
> | Procesamiento de divisas | `COP` (Peso colombiano) |
> | Importe mínimo de la transacción | COP 1.00 |
> | Monto máximo de la transacción | COP 12.110.000,00 |
> | Formato de cuenta local | Sistema de Cuentas de Deposito (CUD) |
> | centro de compensación | ACH Colombia |
> | Número máximo de cuentas virtuales | Ilimitado |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account) |

> [tab] Costa Rica
>
> | Propiedad | SINPE - IN | SINPE USD - IN |
> | - | - | - |
> | Confirmación de pago del SLA | Tiempo real 24/7 | Tiempo real 24/7 |
> | Procesamiento de divisas | `CRC` (Colón costarricense) | `USD` (Dólar estadounidense) |
> | Importe mínimo de la transacción | CRC 1.00 | USD 1.00 |
> | Monto máximo de la transacción | CRC 100.000.000.000,00 | USD 1.000.000.000.000,00 |
> | Formato de cuenta local | IBAN (22 caracteres) | IBAN (22 caracteres) |
> | centro de compensación | SINPE (Banco Central de Costa Rica) | SINPE (Banco Central de Costa Rica) |
> | Número máximo de cuentas virtuales | Ilimitado | Ilimitado |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account), [Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) | [En línea](#step-1-create-a-virtual-account), [Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) |
>
> > [!NOTE]
> >
> > **Cuentas virtuales de Costa Rica**
> >
> > * En Costa Rica, las cuentas virtuales **no se pueden desactivar** una vez creadas. Para dejar de recibir pagos, elimina la cuenta.
> > * El IBAN sigue el formato `CR` + 20 dígitos (por ejemplo, `CR75090100056938278310`).
> > * Según la normativa de SINPE, las cuentas virtuales sin movimiento durante más de 90 días deben ser desactivadas. En la práctica, la desactivación se realiza automáticamente el primer martes de cada mes a las 00:00 hora de Costa Rica.

> [tab] México
>
> | Propiedad | SPEI | TEF | SPID |
> | :- | :- | :- | :- |
> | Confirmación de pago del SLA | Tiempo real 24/7 | Fecha límite T+1: 17:00 (UTC-6) | Tiempo real 24/7 |
> | Procesamiento de divisas | `MXN` (Peso mexicano) | `MXN` (Peso mexicano) | `USD` (Dólar estadounidense) |
> | Importe mínimo de la transacción | MXN 1.00 | MXN 1.00 | USD 1.00 |
> | Monto máximo de la transacción | MXN 1.000.000.000,00 | MXN 1.000.000.000,00 | USD 10.000.000,00 |
> | Formato de cuenta local | CLABE (Clave Bancaria Estandarizada) de 18 dígitos | CLABE (Clave Bancaria Estandarizada) de 18 dígitos | CLABE (Clave Bancaria Estandarizada) de 18 dígitos |
> | centro de compensación | Banco de México | CECOBAN | Banco de México |
> | Número máximo de cuentas virtuales | Ilimitado | Ilimitado | Ponte en contacto con tu gestor de cuenta. |
> | Tipo de pagador | Particulares y empresas | Particulares y empresas | Compañía |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account), [Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) | [En línea](#step-1-create-a-virtual-account), [Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) | [En línea](#step-1-create-a-virtual-account),[Desconectado](https://docs.localpayment.com/es/docs/offline-virtual-account-creation.md) |
>
> > [!NOTE]
> >
> > **SPID de México**
> >
> > Para solicitar una cuenta virtual para transferencias en USD a través del sistema SPID de México, ten en cuenta lo siguiente:
> >
> > * **Bancos disponibles**: Consulta la lista de [bancos admitidos y los códigos](https://docs.localpayment.com/es/docs/mexico.md#bank-codes) para realizar transferencias.
> > * **Cuenta de Localpayment**:Debes tener una cuenta de Localpayment en USD para recibir fondos. Si no tienes una, ponte en contacto con nuestro equipo de soporte para que te la configuren antes de continuar.
>
> ### Formato de cuenta
>
> En México, las cuentas virtuales deben utilizar el número CLABE (Clave Bancaria Estandarizada).
>
> **Estructura:**
>
> * Posiciones 1-3: Código Bancario (asignado por el Banco de México)
> * Posiciones 4-6: Código de sucursal/oficina (ubicación geográfica)
> * Posiciones 7-17: Número de cuenta del cliente
> * Posición 18: Dígito de control (suma de verificación)
>
> En México, las transferencias bancarias locales en pesos mexicanos (MXN) se realizan a través de dos sistemas de compensación principales:
>
> * **SPEI (Sistema de Pagos Electrónicos Interbancarios)**: un sistema de pagos interbancarios en tiempo real operado por el Banco de México, que permite transferencias de fondos entre bancos en cuestión de segundos. Las transacciones generalmente se liquidan al instante y las cuentas deben identificarse mediante el número CLABE estandarizado.
>
> * **TEF (Transferencia Electrónica de Fondos):** método de pago en México operado por CECOBAN para transferencias interbancarias, donde las transacciones se procesan al siguiente día hábil. Requiere el número de cuenta CLABE estandarizado para su identificación, solo está disponible en días hábiles según el horario bancario mexicano y se usa comúnmente para pagos que no son urgentes, como desembolsos programados a proveedores o transferencias recurrentes donde no se requiere liquidación inmediata.
>
> Para transferencias en dólares estadounidenses (USD) entre cuentas bancarias mexicanas, proporcionamos acceso a SPID.
>
> * **SPID (Sistema de Pagos Interbancarios en Dólares):** es el sistema de pagos mexicano especializado para transferencias interbancarias nacionales en dólares estadounidenses. Permite a las empresas radicadas en México transferir fondos en USD de manera eficiente entre cuentas bancarias en diferentes bancos del país.
>
> Cómo funciona **SPID**:
>
> * **Horario de procesamiento:** Disponible en días hábiles bancarios mexicanos, entre las 8:00 y las 17:00 (UTC -6). Las transacciones se procesan por lotes a lo largo del día.
>
> * **Requisito de cuenta:** Las transacciones se procesan utilizando el número CLABE estandarizado de la cuenta en USD del destinatario.
>
> * **Aplicaciones típicas:** Ideal para pagos B2B, liquidaciones a proveedores internacionales y otras operaciones de tesorería corporativa donde los fondos deben permanecer en USD.

> [tab] Perú
>
> | Propiedad | CCI-En | CCI-En USD |
> | - | - | - |
> | Confirmación de pago del SLA | Tiempo real 24/7 | Tiempo real 24/7 |
> | Procesamiento de divisas | `PEN` (Sol peruano) | `USD` (Dólar estadounidense) |
> | Importe mínimo de la transacción | PEN 1.00 | USD 1.00 |
> | Monto máximo de la transacción | PEN 30.000,00 | USD 10.000,00 |
> | Formato de cuenta local | Codigo de Cuenta Interbancario (CCI) | Codigo de Cuenta Interbancario (CCI) |
> | centro de compensación | CCE | CCE |
> | Número máximo de cuentas virtuales | Ilimitado | Ilimitado |
> | Modelo de creación de cuentas virtuales | [En línea](#step-1-create-a-virtual-account) | [En línea](#step-1-create-a-virtual-account) |
>
> > [!WARNING]
> >
> > **Importante:**
> >
> > * La moneda (PEN o USD) de tu cuenta virtual viene determinada por la configuración de tu cuenta de Localpayment.
> >
> > * Si necesitas realizar depósitos en tu cuenta virtual que superen los 30.000 PEN, debes ponerte en contacto con nuestro [equipo de soporte](mailto:support@localpayment.com).
>
> ### Formato de cuenta
>
> En Perú, las cuentas virtuales utilizan el formato CCI (Código de Cuenta Interbancario), que es un código de cuenta interbancaria estandarizado de 20 dígitos.
>
> **Estructura:**
>
> * Posiciones 1-3: 3 dígitos - Código bancario (asignado por SBS - Superintendencia de Banca, Seguros y AFP)
> * Posiciones 4-6: 3 dígitos - Número de sucursal
> * Posiciones 7-18: 12 dígitos - Número de cuenta único dentro del banco
> * Posición 19-20: 2 dígitos - Dígitos de control (validador de suma de comprobación)
>
> **Ejemplo**: `92250610000000101419`

***

## Paso 1: Crea una cuenta virtual

### Opción 1: Creación de cuenta virtual individual

Crea cuentas virtuales individuales con configuración detallada para clientes o transacciones específicas.

Para crear una cuenta virtual, deberás enviar una solicitud `POST` al endpoint [Crear una cuenta virtual](https://docs.localpayment.com/es/reference/create-virtual-account.md).

#### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

| Parámetro | Descripción | Requerido |
| - | - | - |
| externalId | Identificador único asignado por el comerciante para hacer referencia a la cuenta virtual. | ✅ |
| accountNumber | Número de cuenta del comerciante al que se vinculará o asociará la cuenta virtual. | ✅ |
| country | País donde se habilitará la cuenta virtual. | ✅ |
| beneficiary | Objeto que contiene la información personal del beneficiario (tipo de beneficiario, nombre, documento, dirección, sitio web). | ✅ |

#### 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 POST \
     --url https://api.stage.localpayment.com/api/virtual-account \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "country": "ARG",
  "beneficiary": {
    "type": "COMPANY",
    "document": {
      "id": "30-71234567-9",
      "type": "CUIT"
    },
    "name": "ACME INTERNATIONAL LTD",
    "lastName": "",
    "fullName": "ACME INTERNATIONAL LTD",
    "address": {
      "street": "Av. Corrientes",
      "number": "1234",
      "city": "Buenos Aires",
      "state": "CABA",
      "country": "Argentina"
    },
    "website": "https://yongxin.technology.com"
  },
  "externalId": "de14bcf2-15ee-22e3-ab59-99c3fcba31e8",
  "accountNumber": "{{accountNumber}}"
}
'
```

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

#### Respuesta exitosa

Una solicitud exitosa dará como resultado que la API devuelva un código de estado de `100`, con el estado de la cuenta establecido inicialmente en `INPROGRESS`. La cuenta virtual permanecerá en este estado durante la activación y pasará a uno de los [estados disponibles](https://docs.localpayment.com/es/docs/get-virtual-account-status.md)  una vez que finalice el proceso de activación.

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "de14bcf2-15ee-22e3-ab59-99c3fcba31e8",
  "internalId": "5ba31ea0-669b-43f6-88a1-1601f3cade0a",
  "accountNumber": "{{accountNumber}}",
  "country": "ARG",
  "currency": "ARS",
  "beneficiary": {
    "type": "COMPANY",
    "name": "ACME INTERNATIONAL LTD",
    "fullName": "ACME INTERNATIONAL LTD",
    "lastName": "",
    "document": {
      "type": "CUIT",
      "id": "30-71234567-9"
    },
    "address": {
      "street": "Av. Corrientes",
      "number": "1234",
      "city": "Buenos Aires",
      "state": "CABA",
      "country": "Argentina"
    }
  },
  "status": {
    "code": "100",
    "description": "INPROGRESS",
    "detail": "Virtual account in progress"
  },
  "errors": []
}
```

#### Campos de respuesta clave

| Campo | Descripción |
| - | - |
| `externalId` | Un identificador único para la transacción en tu sistema. **Se utilizará para realizar otras operaciones, como obtener el estado de la cuenta virtual**. |
| `internalId` | Un identificador único para la transacción en el sistema de Localpayment. |
| `status` | Objeto con información sobre el estado de la cuenta virtual. |
| `status.code` | El código de estado (por ejemplo, `100` para `INPROGRESS`). |
| `date.processedDate` | Cuando comenzó el procesamiento de la transacción. |

#### Respuesta de error

Cuando una solicitud falla, recibirás información detallada sobre el error:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "f5c4529e-67c1-43e0-bc2a-97250e736c98",
  "internalId": "f2d9d9b0-093d-469b-c8d6-728b0cc67e80",
  "status": {
    "code": "300",
    "description": "REJECTED",
    "detail": "Invalid param + [document.id] + verification failed"
  },
  "errors": [
    {
      "code": "300",
      "detail": "Invalid param + [document.id] + verification failed"
    }
  ]
}
```

#### Hora de activación de la cuenta

El tiempo de activación de las cuentas virtuales varía según el país. A continuación se muestran los tiempos estimados para que las cuentas se activen y estén listas para recibir pagos:

* **Argentina**: Hasta 6 segundos
* **Brasil**: Hasta 15 minutos
* **Chile**: Hasta 6 segundos
* **Colombia**: Hasta 6 segundos
* **México**: Hasta 6 segundos
* **Perú**: Hasta 6 segundos

### Opción 2: Crear cuentas virtuales en lote

Genera múltiples cuentas virtuales en una sola solicitud de API para operaciones masivas eficientes. Para crear cuentas virtuales en masa, deberás enviar una solicitud `POST` al endpoint [Crear cuentas virtuales en lote](https://docs.localpayment.com/es/reference/request-batch.md).

> [!NOTE]
>
> ###
>
> Solo se pueden crear cuentas dentro del mismo país en una única solicitud por lotes.

#### Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

| Parámetro | Descripción | Requerido |
| - | - | - |
| externalId | Identificador único asignado por el comerciante para hacer referencia a la cuenta virtual. | ✅ |
| accountNumber | Número de cuenta del comerciante al que se vinculará o asociará la cuenta virtual. | ✅ |
| country | País donde se habilitará la cuenta virtual. | ✅ |
| beneficiary | Objeto que contiene la información personal del beneficiario. | ✅ |
| accounts | Matriz que contiene las subcuentas individuales y sus respectivos beneficiarios asociados con la cuenta virtual. | |

#### 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 POST \
     --url https://api.stage.localpayment.com/api/virtual-account-batch \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'Authorization: Bearer <your_access_token>' \
     --data '
{
  "externalId": "f059a032-9253-4607-9b8e-2948ed18d595",
  "accountNumber": "{{accountNumber}}",
  "country": "MEX",
  "name": "Virtual Account",
  "accounts": [
    {
      "externalId": "9210b519-5c29-4419-8d28-04f7543a914f",
      "beneficiary": {
        "type": "INDIVIDUAL",
        "name": "John",
        "lastname": "Doe",
        "document": {
          "id": "EXTF900101NI1",
          "type": "RFC"
        }
      }
    },
    {
      "externalId": "e4914217-41bc-49a5-b2f8-df950bf9bae7",
      "beneficiary": {
        "type": "INDIVIDUAL",
        "name": "Alicia",
        "lastname": "Doe",
        "document": {
          "id": "EXTF900101NI2",
          "type": "RFC"
        }
      }
    }
  ]
}
'
'
```

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

#### Respuesta exitosa

Una solicitud exitosa dará como resultado que la API devuelva un código de estado de `100`, con el estado de la cuenta establecido en `INPROGRESS`.

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "externalId": "f059a032-9253-4607-9b8e-2948ed18d595",
  "internalId": "1748f8f8-dcac-4547-b3fb-7d6529245d84",
  "accountNumber": "{{accountNumber}}",
  "status": {
    "code": "100",
    "description": "INPROGRESS",
    "detail": "Batch Process Virtual Account in progress"
  },
  "comment": "For obtaining the asynchronous response, kindly submit a request to the service after a brief interval. GET {api_environment_url}/api/virtual-account-batch/7facbbbf-d279-4ab5-9aeb-7583fa3f35ec"
}
```

#### Campos de respuesta clave

| Campo | Descripción |
| - | - |
| `externalId` | Un identificador único para la transacción en tu sistema. **Se utilizará para realizar otras operaciones, como obtener el estado de la cuenta virtual**. |
| `internalId` | Un identificador único para la transacción en el sistema de Localpayment. |
| `status` | Objeto con información sobre el estado de la cuenta virtual. |
| `status.code` | El código de estado (por ejemplo, `100` para `INPROGRESS`). |
| `date.processedDate` | Cuando comenzó el procesamiento de la transacción. |

#### Respuesta de error

Cuando una solicitud falla, recibirás información detallada sobre el error:

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "timestamp": "2025-01-03T22:03:39.657+00:00",
  "status": 400,
  "error": "Bad Request.",
  "message": "External ID already used - Duplication",
  "path": "/virtual-account/batch"
}
```

Para obtener una lista completa de los códigos de estado y sus significados, consulta la documentación sobre el [estado de las transacciones](https://docs.localpayment.com/es/reference/get-transaction-status.md).

***

## Paso 2. Seguimiento del estado de la cuenta virtual

Supervisar el estado de tus cuentas virtuales es fundamental para mantener operaciones de pago óptimas. Localpayment ofrece capacidades de seguimiento integrales tanto para cuentas individuales como para cuentas creadas por lotes, mediante endpoints de API consistentes y actualizaciones de estado en tiempo real.

> [card] [Para cuentas virtuales individuales](https://docs.localpayment.com/es/docs/get-virtual-account-status.md#method-1-check-individual-virtual-account-status)
>
> Para consultar el estado de una cuenta virtual individual, deberás enviar una solicitud `GET` al endpoint [Obtener estado de la cuenta virtual](https://docs.localpayment.com/es/reference/get-virtual-account-status.md).

> [card] [Para cuentas creadas por lotes](https://docs.localpayment.com/es/docs/get-virtual-account-status.md#method-2-check-batch-virtual-account-status)
>
> Para supervisar el estado de procesamiento de las cuentas virtuales creadas por lotes, deberás enviar 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).

## Próximos pasos

> [card] [Seguimiento del estado de la cuenta virtual](https://docs.localpayment.com/es/docs/get-virtual-account-status.md)
>
> Supervisa el ciclo de vida de tus cuentas virtuales para mantener operaciones de pago óptimas. Conoce los diferentes estados y comprende qué significa cada uno para tus capacidades de procesamiento de pagos.

> [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 Get Virtual Account Status para procesar los pagos correctamente. 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 una cuenta virtual](https://docs.localpayment.com/es/docs/activate-deactivate-virtual-account.md)
>
> Gestiona la disponibilidad de tu cuenta activando o desactivando temporalmente las cuentas virtuales. Esto resulta útil para negocios de temporada, mantenimiento de cuentas o suspensiones temporales.

> [card] [Eliminar una 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.