Saltar al contenido principal
Localpayment te permite suspender o reactivar temporalmente cuentas virtuales, lo que te brinda flexibilidad para gestionar el estado de la cuenta sin eliminarla permanentemente. Esto resulta útil para retenciones temporales, resolución de disputas o para gestionar patrones de negocio estacionales.

Antes de comenzar

Asegúrate de tener:
  • Credenciales API válidas (token de acceso).
  • Identificador externo de cuenta virtual que deseas habilitar o deshabilitar.
  • Comprensión del estado actual de la cuenta virtual.

Gestión del estado de la cuenta virtual

Gestiona el estado de tu cuenta virtual utilizando cualquiera de los siguientes métodos:

Habilitar cuenta virtual

Habilita una cuenta virtual previamente desactivada para que vuelva a aceptar pagos.

Deshabilitar cuenta virtual

Suspende temporalmente una cuenta virtual para evitar pagos adicionales, conservando al mismo tiempo los datos de la cuenta.

Consultar el estado de la cuenta

Verifica el estado actual de una cuenta virtual antes de activarla o desactivarla.

Referencia del estado de la cuenta virtual

Comprender el estado de las cuentas virtuales es fundamental para una correcta gestión de activación/desactivación:

Habilitar cuenta virtual

Reactiva una cuenta virtual previamente desactivada para reanudar la aceptación de pagos. Envía una solicitud PUT al endpoint Actualizar el estado de la cuenta virtual utilizando el ID externo:

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

Respuesta exitosa

Campos de respuesta clave


Deshabilitar cuenta virtual

Suspende temporalmente una cuenta virtual para evitar pagos adicionales, conservando al mismo tiempo los datos y el historial de la cuenta. Envía una solicitud PUT al endpoint Actualizar el estado de la cuenta virtual utilizando el ID externo:
ImportanteEn Perú, cuando se desactiva una cuenta virtual, aparecerá como inexistente en la aplicación bancaria.

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

Respuesta exitosa

Campos de respuesta clave


Próximos pasos

Tras gestionar el estado de activación de la cuenta virtual, es posible que debas realizar acciones adicionales:

Consultar el estado de la cuenta virtual

Verifica el estado actual de las cuentas virtuales habilitadas o deshabilitadas.

Eliminar cuenta virtual

Desactiva permanentemente una cuenta virtual. Esto impide cualquier pago futuro, pero conserva todo su historial. Esta acción es irreversible. Úsala para cuentas que ya no necesites; crea una nueva para reanudar las operaciones.
Última modificación el 10 de noviembre de 2026