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

# Crear cuentas virtuales en batch

`POST /virtual-accounts/batch`

## 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' | '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' | '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' | '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' | '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 cuentas virtuales 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.net/prontopaga/apis/prontopaga-api.md) · [All operations](https://skmtc.net/prontopaga/apis/prontopaga-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prontopaga/prontopaga-api/revisions/edcc7c3087f0/schema)