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.
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ís | Residentes locales | residentes extranjeros | Propietario de la cuenta | Alias | Nombre para mostrar de la transferencia bancaria |
|---|---|---|---|---|---|
| Argentina | ✅ | ✅ |
| Creación de hasta 1 alias |
|
| Brasil | ✅ | ✅ |
| N / A | Nombre de la entidad legal de Localpayment |
| Chile | ✅ | ✅ | FBO | N / A | Nombre de la entidad legal de Localpayment |
| Colombia | ✅ | ✅ | FBO | Clave predeterminada | Nombre de la entidad legal de Localpayment |
| México | ✅ | ✅ | DDA = Residentes locales | N / A | Nombre de la entidad legal de Localpayment |
| Perú | ✅ | ✅ | FBO | N / A | Nombre de la entidad legal de Localpayment |
| Costa Rica | ✅ | ✅ | FBO | N / A | Nombre 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:- Argentina
- Brasil
- Chile
- Colombia
- Costa Rica
- México
- Perú
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).
0000003112345678901234Paso 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 solicitudPOST 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 utilizacurl:
curl
Respuesta exitosa
Una solicitud exitosa dará como resultado que la API devuelva un código de estado de100, 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 solicitudPOST al endpoint Crear cuentas virtuales en lote.
Parámetros clave de la solicitud
La solicitud requiere varios parámetros clave:Ejemplo de solicitud
A continuación se muestra un ejemplo que utilizacurl:
curl
Respuesta exitosa
Una solicitud exitosa dará como resultado que la API devuelva un código de estado de100, 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: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.

