---
title: "Crear cuentas virtuales en batch"
method: POST
path: "/virtual-accounts/batch"
tags: ["Cuenta Virtual"]
---

# Crear cuentas virtuales en batch

`POST /virtual-accounts/batch`

## Request

- Base URL: `https://sandbox-virtual-accounts.prontopaga.com/api`
- URL: `https://sandbox-virtual-accounts.prontopaga.com/api/virtual-accounts/batch`
- Auth: API key in header `Authorization`

## Request body

- BatchVirtualAccountCreateRequestBody
  - `referenceId` string: Identificador único del lote enviado por el cliente
  - `virtualAccounts` object[], required: Arreglo de virtual accounts a crear. Debe contener entre 10 y 5000 registros
    - `accountNumber` string, required: Número de cuenta interna del sistema ProntoPaga asignado al Merchant
    - `beneficiary` union, required: La persona o entidad que recibirá los fondos depositados en esta cuenta virtual
      - object
        - `address` BeneficiaryAddress, required: Dirección del beneficiario
          - `city` string, required: Ciudad
          - `comment` string: Información adicional o referencia sobre la dirección
          - `country` string, required: País
          - `number` string, required: Número de la calle
          - `state` string, required: Estado o Región
          - `street` string, required: Nombre de la calle
          - `zipCode` string: Código Postal
        - `document` BeneficiaryDocument, required: Documento del beneficiario/representante legal
          - `id` string, required: Número de documento de identidad
          - `type` 'ruc' | 'rut' | 'run' | 'dni' | 'ce' | 'passport' | 'other', required: El tipo de documento de identidad, como un número de identificación nacional, número de seguro social o licencia de conducir, dependiendo del país de emisión
        - `industry` string: Giro de industria o negocio del beneficiario
        - `lastname` string: Apellido del beneficiario. Requerido si el type es individual
        - `legalRepresentative` LegalRepresentative, required: El representante legal de la entidad recibirá los fondos depositados en esta cuenta virtual. Si el tipo es individual, el tipo de documento debe coincidir con el del beneficiario
          - `document` BeneficiaryDocument, required: Documento del beneficiario/representante legal
            - `id` string, required: Número de documento de identidad
            - `type` 'ruc' | 'rut' | 'run' | 'dni' | 'ce' | 'passport' | 'other', required: El tipo de documento de identidad, como un número de identificación nacional, número de seguro social o licencia de conducir, dependiendo del país de emisión
          - `name` string, required: Nombre del beneficiario/representante legal
        - `name` string, required: Nombre del beneficiario/representante legal
        - `type` 'individual', required: Tipo de beneficiario
        - `website` string, uri: Website del beneficiario
      - object
        - `address` BeneficiaryAddress, required: Dirección del beneficiario
          - `city` string, required: Ciudad
          - `comment` string: Información adicional o referencia sobre la dirección
          - `country` string, required: País
          - `number` string, required: Número de la calle
          - `state` string, required: Estado o Región
          - `street` string, required: Nombre de la calle
          - `zipCode` string: Código Postal
        - `document` BeneficiaryDocument, required: Documento del beneficiario/representante legal
          - `id` string, required: Número de documento de identidad
          - `type` 'ruc' | 'rut' | 'run' | 'dni' | 'ce' | 'passport' | 'other', required: El tipo de documento de identidad, como un número de identificación nacional, número de seguro social o licencia de conducir, dependiendo del país de emisión
        - `industry` string: Giro de industria o negocio del beneficiario
        - `lastname` string: Apellido del beneficiario. Requerido si el type es individual
        - `legalRepresentative` LegalRepresentative, required: El representante legal de la entidad recibirá los fondos depositados en esta cuenta virtual. Si el tipo es individual, el tipo de documento debe coincidir con el del beneficiario
          - `document` BeneficiaryDocument, required: Documento del beneficiario/representante legal
            - `id` string, required: Número de documento de identidad
            - `type` 'ruc' | 'rut' | 'run' | 'dni' | 'ce' | 'passport' | 'other', required: El tipo de documento de identidad, como un número de identificación nacional, número de seguro social o licencia de conducir, dependiendo del país de emisión
          - `name` string, required: Nombre del beneficiario/representante legal
        - `name` string, required: Nombre del beneficiario/representante legal
        - `type` 'company', required: Tipo de beneficiario
        - `website` string, uri: Website del beneficiario
    - `referenceId` string: Identificador único que debe proporcionar el cliente para etiquetar y rastrear refund dentro de su sistema
    - `type` 'recurrent' | 'unique', required: Tipo de Cuenta Virtual solicitada. Valores permitidos: `recurrent`, `unique`

## Response `201`

201 response

- BatchVirtualAccountCreateResponse
  - `createdAt` string, date-time, required: Fecha y hora de recepción del batch
  - `status` 'received' | 'processing' | 'completed' | 'completed_with_errors' | 'failed', required: Estado del lote
  - `totalRecords` number, required: Cantidad total de registros recibidos en el batch
  - `virtualAccountBatchId` string, required: Id único que identifica el proceso de creación en batch

## Other responses

- `400`: 400 response
- `401`: 401 response
- `409`: 409 response
- `500`: 500 response

---

[API](https://skmtc.dev/prontopaga/apis/merchant-api.md) - [All operations](https://skmtc.dev/prontopaga/apis/merchant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prontopaga/apis/merchant-api/revisions/2df4b92312d1?raw)