---
title: "Detalles de una cuenta virtual"
method: GET
path: "/virtual-accounts/{virtualAccountId}"
tags: ["Cuentas virtuales"]
---

# Detalles de una cuenta virtual

`GET /virtual-accounts/{virtualAccountId}`

## Path parameters

- `virtualAccountId` string, required

## Response `200`

200 response

- GetAccountResponse
  - `accountNumber` string, required — Número de cuenta interna del sistema ProntoPaga asignado al Merchant
  - `bankCode` string, required — Código del banco de la cuenta virtual. (estándar en al menos Perú y Chile de 3 dígitos)
  - `bankName` string, required — Nombre del banco de la cuenta virtual.
  - `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
  - `country` string, required — País en formato ISO 3166-1 alpha-3
  - `currency` string, required — Moneda de la cuenta virtual
  - `referenceId` string — Identificador único que debe proporcionar el cliente para etiquetar y rastrear cuentas virtuales dentro de su sistema
  - `status` 'enabled' | 'disabled', required — Estatus de la operación
  - `type` 'recurrent' | 'unique', required — Tipo de Cuenta Virtual solicitada. Valores permitidos: `recurrent`, `unique`
  - `vaNumber` string, required — Número de la cuenta virtual creada
  - `virtualAccountId` string, required — Identificador único utilizado por el sistema a la entidad de Virtual Account

## Other responses

- `400` — 400 response
- `404` — 404 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)