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 solicitudGET 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 solicitudGET 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
- Inicia sesión en tu portal comercial de Localpayment.
- Navegar a PayIn > Cuentas virtuales > Sección de actividad
- 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.

