Saltar al contenido principal
Genera cuentas virtuales para clientes a través de la API de Localpayment. Compatible con procesamiento individual y por lotes. Genera programáticamente cuentas virtuales para tus clientes a través de la API de Localpayment. Admite tanto la creación de cuentas individuales como el procesamiento por lotes de múltiples cuentas.

Antes de comenzar

Asegúrate de tener:

Credenciales de API

Credenciales API válidas y token de acceso para la autenticación.

Configuración de la cuenta

Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.

Lista blanca de IP

Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.

Endpoint del webhook

Configura una URL de webhook para recibir notificaciones de pago.

Métodos de creación de cuentas virtuales

Ofrecemos opciones flexibles para la creación de cuentas virtuales que se adaptan a diferentes necesidades operativas. Puedes crear cuentas virtuales mediante métodos en línea (API) y fuera de línea, e independientemente del método elegido, dispones de dos modos de creación:
  • Creación individual : Genera cuentas virtuales únicas con configuraciones específicas, ideales para flujos de trabajo impulsados ​​por el cliente y escenarios que requieren personalización por cuenta.
  • Creación por lotes : Procesa varias cuentas virtuales en una sola operación, optimizada para la generación masiva de cuentas, la incorporación masiva de usuarios y escenarios donde se prioriza la eficiencia del procesamiento.
ImportanteNo se aceptan depósitos en efectivo. Las cuentas virtuales solo pueden recibir pagos electrónicos. Cualquier depósito en efectivo realizado a una cuenta virtual, ya sea en una sucursal bancaria, cajero automático o cualquier otro medio, no se acreditará al comercio. Los pagadores deben enviar los fondos exclusivamente mediante transferencia bancaria, utilizando las plataformas de pago electrónico disponibles en su país.

Requisitos del beneficiario

Comprender las restricciones para los beneficiarios es fundamental para crear una cuenta virtual con éxito. Cada país tiene regulaciones específicas sobre quiénes pueden figurar como beneficiarios, lo que influye directamente en la estructura de las operaciones de pago.

Requisitos de residencia por país

La siguiente tabla detalla qué tipos de beneficiarios se aceptan en cada país:
PaísResidentes localesresidentes extranjerosPropietario de la cuentaAliasNombre para mostrar de la transferencia bancaria
Argentina✅✅
  • FBO = Residentes Extranjeros
  • DDA = Residentes locales
Creación de hasta 1 alias
  • Nombre del beneficiario (proporcionado durante la creación de la cuenta virtual, si es argentino)
  • Nombre de la entidad legal de Localpayment (en todos los demás casos)
Brasil✅✅
  • FBO = Residentes Extranjeros
  • DDA = Residentes locales
N / ANombre de la entidad legal de Localpayment
Chile✅✅FBON / ANombre de la entidad legal de Localpayment
Colombia✅✅FBOClave predeterminadaNombre de la entidad legal de Localpayment
México✅✅DDA = Residentes localesN / ANombre de la entidad legal de Localpayment
Perú✅✅FBON / ANombre de la entidad legal de Localpayment
Costa Rica✅✅FBON / ANombre de la entidad legal de Localpayment

Notas:
  • El titular de la cuenta se refiere al nombre legal del titular registrado en el sistema bancario (el nombre visible a nivel bancario). FBO (Para beneficio de) significa que la cuenta se abre a nombre de Localpayment y contiene fondos para beneficio del cliente final. DDA (Cuenta de depósito a la vista) significa que la cuenta se abre directamente a nombre del beneficiario.
  • Alias: se refiere al número de alias (o tipo de alias) que se pueden registrar para una cuenta virtual, cuando esta lo permite.
  • Nombre para mostrar en la transferencia bancaria: se refiere al nombre que se muestra al pagador durante una transferencia electrónica de fondos a la cuenta virtual.

Información del beneficiario necesaria para crear una cuenta virtual.

Información requerida:
  • Tipo de beneficiario: Define si la cuenta virtual pertenece a un particular o a una empresa:
    • INDIVIDUAL: Para una cuenta personal.
    • COMPANY: Para una entidad comercial/jurídica.
  • Nombre del beneficiario: Nombre completo de la persona o razón social.
  • Documento del beneficiario: Información de identificación oficial para verificar la identidad.
  • Dirección: Dirección completa del beneficiario.
  • Sitio web: La URL del sitio web del beneficiario.

Requisitos específicos de cada país

Los detalles de implementación para las cuentas virtuales varían según el país. Los países que no se mencionan explícitamente se rigen por el procedimiento estándar sin requisitos especiales. Revisa estos requisitos antes de la integración:

Formato de cuenta

En Argentina, el CVU (Clave Virtual Uniforme) es un código numérico de 22 dígitos utilizado por las cuentas virtuales emitidas por los PSP (Proveedores de Servicios de Pago).Estructura:
  • Posiciones 1-3: 3 dígitos - Código de la entidad emisora ​​(PSP).
  • Posiciones 4-7: 4 dígitos - Identificador del tipo de cuenta dentro del PSP.
  • Posición 8: 1 dígito - Dígito de verificación (suma de comprobación).
  • Posiciones 9-21: 13 dígitos - Número de cuenta único dentro del PSP.
  • Posición 22: 1 dígito – Dígito de control (validador de suma de comprobación).
Ejemplo: 0000003112345678901234

Paso 1: Crea una cuenta virtual

Opción 1: Creación de cuenta virtual individual

Crea cuentas virtuales individuales con configuración detallada para clientes o transacciones específicas. Para crear una cuenta virtual, deberás enviar una solicitud POST al endpoint Crear una cuenta virtual.

Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl
Consulta todos los parámetros disponibles en la solicitud.

Respuesta exitosa

Una solicitud exitosa dará como resultado que la API devuelva un código de estado de 100, con el estado de la cuenta establecido inicialmente en INPROGRESS. La cuenta virtual permanecerá en este estado durante la activación y pasará a uno de los estados disponibles una vez que finalice el proceso de activación.

Campos de respuesta clave

Respuesta de error

Cuando una solicitud falla, recibirás información detallada sobre el error:

Hora de activación de la cuenta

El tiempo de activación de las cuentas virtuales varía según el país. A continuación se muestran los tiempos estimados para que las cuentas se activen y estén listas para recibir pagos:
  • Argentina: Hasta 6 segundos
  • Brasil: Hasta 15 minutos
  • Chile: Hasta 6 segundos
  • Colombia: Hasta 6 segundos
  • México: Hasta 6 segundos
  • Perú: Hasta 6 segundos

Opción 2: Crear cuentas virtuales en lote

Genera múltiples cuentas virtuales en una sola solicitud de API para operaciones masivas eficientes. Para crear cuentas virtuales en masa, deberás enviar una solicitud POST al endpoint Crear cuentas virtuales en lote.

Solo se pueden crear cuentas dentro del mismo país en una única solicitud por lotes.

Parámetros clave de la solicitud

La solicitud requiere varios parámetros clave:

Ejemplo de solicitud

A continuación se muestra un ejemplo que utiliza curl:
curl
Consulta todos los parámetros disponibles en la solicitud.

Respuesta exitosa

Una solicitud exitosa dará como resultado que la API devuelva un código de estado de 100, con el estado de la cuenta establecido en INPROGRESS.

Campos de respuesta clave

Respuesta de error

Cuando una solicitud falla, recibirás información detallada sobre el error:
Para obtener una lista completa de los códigos de estado y sus significados, consulta la documentación sobre el estado de las transacciones.

Paso 2. Seguimiento del estado de la cuenta virtual

Supervisar el estado de tus cuentas virtuales es fundamental para mantener operaciones de pago óptimas. Localpayment ofrece capacidades de seguimiento integrales tanto para cuentas individuales como para cuentas creadas por lotes, mediante endpoints de API consistentes y actualizaciones de estado en tiempo real.

Para cuentas virtuales individuales

Para consultar el estado de una cuenta virtual individual, deberás enviar una solicitud GET al endpoint Obtener estado de la cuenta virtual.

Para cuentas creadas por lotes

Para supervisar el estado de procesamiento de las cuentas virtuales creadas por lotes, deberás enviar una solicitud GET al endpoint Obtener estado de la cuenta virtual (por lotes).

Próximos pasos

Seguimiento del estado de la cuenta virtual

Supervisa el ciclo de vida de tus cuentas virtuales para mantener operaciones de pago óptimas. Conoce los diferentes estados y comprende qué significa cada uno para tus capacidades de procesamiento de pagos.

Instrucciones de pago

Proporciona a los pagadores los datos correctos del beneficiario que aparecen en la respuesta de la API Get Virtual Account Status para procesar los pagos correctamente. Consulta las instrucciones específicas de cada país para garantizar una ejecución de pagos precisa y conforme a la normativa.

Habilitar/deshabilitar una cuenta virtual

Gestiona la disponibilidad de tu cuenta activando o desactivando temporalmente las cuentas virtuales. Esto resulta útil para negocios de temporada, mantenimiento de cuentas o suspensiones temporales.

Eliminar una 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 12 de noviembre de 2026