Saltar al contenido principal
Esta guía describe los diferentes enfoques para realizar un seguimiento del estado de las cuentas virtuales y gestionar su ciclo de vida. Localpayment ofrece múltiples métodos para supervisar y obtener el estado actual de las cuentas virtuales, incluyendo comprobaciones de cuentas individuales, estado del procesamiento por lotes y visualización en el Business Portal.

Disponibilidad

El seguimiento del estado de las cuentas virtuales está disponible en todos los países donde se admiten cuentas virtuales:

Antes de comenzar

Asegúrate de tener:
  • Credenciales API válidas (token de acceso).
  • Identificadores de cuenta virtual o números de referencia de lote que deseas verificar.

Referencia del estado de la cuenta virtual

Las cuentas virtuales pueden tener los siguientes estados a lo largo de su ciclo de vida:
Los códigos de estado no son exclusivos de los estados de las cuentas virtuales. Por ejemplo, el código 300 también aparece con la descripción REJECTED en el endpoint Crear una cuenta virtual cuando una solicitud no supera la validación. Lee siempre status.code junto con status.description en lugar de basarse únicamente en el código.

Recuperar información de la cuenta virtual

Tras solicitar tu cuenta virtual, podrás consultar su estado utilizando cualquiera de los siguientes métodos:

Consultar el estado de la cuenta virtual individual

Recupera el estado actual y los detalles de una cuenta virtual específica utilizando el endpoint de la API con el ID externo.

Consultar el estado de la cuenta virtual del lote

Supervisa el estado de las cuentas virtuales creadas en operaciones por lotes, incluido el progreso de la creación y cualquier error.

Consulta el estado de tu cuenta virtual a través del Business Portal.

Utiliza la interfaz visual del Business Portal para la supervisión manual, el filtrado y las operaciones masivas en cuentas virtuales.

Método 1: Comprobar el estado de la cuenta virtual individual

Recupera el estado actual y los detalles de una cuenta virtual específica utilizando el endpoint de estado individual.

Ejemplo de solicitud

Envía una solicitud GET al endpoint Obtener estado de la cuenta virtual. A continuación se muestra un ejemplo con curl:
curl

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

Respuesta exitosa

Campos de respuesta clave


Método 2: Comprobar el estado de la cuenta virtual por lotes

Supervisa el estado de las cuentas virtuales creadas en operaciones por lotes, incluido el progreso de la creación y cualquier error.

Ejemplo de solicitud

Envía una solicitud GET al endpoint Obtener estado de la cuenta virtual (por lotes). A continuación se muestra un ejemplo con curl:
curl

Parámetros clave de la solicitud

La solicitud requiere varios objetos clave:

Respuesta exitosa

Campos de respuesta clave


Método 3: Consultar el estado de la cuenta virtual a través del Business Portal.

Para la supervisión manual y el análisis visual, utiliza el Business Portal de Localpayment para consultar el estado de la cuenta virtual.

Acceso al Business Portal

  1. Inicia sesión en tu portal comercial de Localpayment.
  2. Navegar a PayIn > Cuentas virtuales > Sección de actividad
  3. Utiliza filtros para buscar por:
    • País: Elige un país específico o selecciona Todos para incluir todos los países disponibles.
    • Estado: Filtra las cuentas por su estado actual o selecciona Todas para ver las cuentas con cualquier estado.
    • Rango de fechas: Especifica el rango de fechas en el que se crearon las cuentas virtuales. Esto filtra la lista según la fecha de creación, no según la fecha de actividad.
    • Número de cuenta virtual: Puedes buscar directamente por el número de cuenta virtual (VAN) para localizar rápidamente una entrada específica.

Próximos pasos

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

Instrucciones de pago

Proporciona a los pagadores los datos correctos del beneficiario que aparecen en la respuesta de la API de estado de la cuenta virtual para procesar los pagos sin problemas. Consulta las instrucciones específicas de cada país para garantizar una ejecución de pagos precisa y conforme a la normativa.

Habilitar/Deshabilitar cuenta virtual

Suspender o reactivar temporalmente las cuentas virtuales según las necesidades del negocio o las solicitudes de los clientes.

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