---
title: "Detalles de una cuenta virtual por referenceId"
method: GET
path: "/virtual-accounts/by-reference-id/{referenceId}"
tags: ["Cuenta Virtual"]
---

# Detalles de una cuenta virtual por referenceId

`GET /virtual-accounts/by-reference-id/{referenceId}`

## Request

- Base URL: `https://sandbox-virtual-accounts.prontopaga.com/api`
- URL: `https://sandbox-virtual-accounts.prontopaga.com/api/virtual-accounts/by-reference-id/{referenceId}`
- Auth: API key in header `Authorization`

## Path parameters

- `referenceId` 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' | '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
  - `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 refund 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.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)