Saltar al contenido principal
GET
Obtener estado de la cuenta virtual
Este endpoint recupera el estado y los detalles de una cuenta virtual específica que hayas creado previamente mediante el endpoint Crear una cuenta virtual. Puedes usar este endpoint para comprobar si la cuenta está activa y lista para recibir pagos.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Authorization
string
requerido

Token de acceso Bearer para la autenticación. Este token se obtiene de los endpoints Get Access Token o Refresh Access Token.

Parámetros de ruta

externalId
string
requerido

El identificador único de la cuenta virtual que deseas administrar. Debe coincidir exactamente con el valor de externalId que proporcionaste al crear la cuenta. Utiliza este identificador para especificar la cuenta de destino para operaciones como consultar su estado o eliminarla.

Pattern: [a-zA-Z0-9\- ]+
Ejemplo:

"9c590364-b6b4-116b-cf09-d63e8681c8fc"

Respuesta

OK

currency
enum<string>
Opciones disponibles:
ARS,
BRL,
CLP,
USD,
MXN,
PEN
externalId
string

El identificador único de la cuenta virtual. Este es el mismo externalId que proporcionaste en tu solicitud, lo que confirma que los datos devueltos corresponden a la cuenta correcta.

internalId
string

Identificador de transacción de Localpayment.

accountNumber
string

Número de cuenta de Localpayment.

beneficiary
beneficiary · object

La persona o entidad que recibirá los fondos depositados en esta cuenta virtual. El beneficiario es quien recibe el dinero en última instancia y no necesariamente es el propietario o titular legal de la cuenta virtual.

Ejemplo:
status
status · object

Estado de la operación.

errors
object[]

Conjunto de errores que se produjeron durante la transacción. Si la transacción fue exitosa, este conjunto estará vacío.

disabled
boolean

Especifica si la cuenta virtual está habilitada o deshabilitada.

Última modificación el 10 de noviembre de 2026