Saltar al contenido principal
PUT
Habilitar o deshabilitar una cuenta virtual
Este endpoint te permite habilitar o deshabilitar temporalmente una cuenta virtual. Utilízalo para suspender la recepción de nuevos fondos en una cuenta específica (deshabilitar) o para reactivarla de modo que pueda volver a aceptar pagos (habilitar). Esto es útil para gestionar las cuentas de los clientes durante revisiones de cumplimiento, pausar suscripciones u otros controles operativos.

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

status
enum<string>
requerido

enable o disable.

Opciones disponibles:
enable,
disable
Ejemplo:

"enable"

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 habilitarla o deshabilitarla.

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

"53025bf4-4c87-4b4f-8fea-b47004440f37"

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 la operación se realizó en 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.

Última modificación el 10 de noviembre de 2026