Saltar al contenido principal
Asigna un CVU por transacción para Argentina. El pago se confirma solo cuando el pagador transfiere el monto exacto antes del vencimiento del plazo. La Cuenta Virtual con Intención de Pago asigna un CVU (Cuenta Virtual Uniforme) a cada transacción, vinculado a un importe y una fecha de vencimiento específicos. A diferencia de una cuenta virtual estándar que acepta cualquier depósito, este producto solo confirma el PayIn cuando el pagador transfiere exactamente el importe indicado antes de la fecha de vencimiento.

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.

Cómo funciona

El flujo difiere de la cuenta virtual CVU estándar en un aspecto clave: a cada pago se le asigna una CVU vinculada a un importe específico.
  1. Tu sistema llama a POST /api/payin/ con paymentMethod.code: "1060" y el importe esperado.
  2. Localpayment devuelve un código CVU único, los datos bancarios del beneficiario y una fecha de vencimiento.
  3. Tú muestras al pagador el CVU, el importe exacto y la fecha de vencimiento.
  4. El pagador inicia una transferencia bancaria al CVU desde su aplicación bancaria o billetera.
  5. Cuando la transferencia llega con el importe exacto antes de su vencimiento, Localpayment confirma el pago y envía un webhook a tu sistema.

Paso 1: Crear una intención de pago

Envía una solicitud POST al endpoint Crear Payin.

Solicitud

Ejemplo de solicitud

Respuesta exitosa

Campos de respuesta clave

Respuesta de error


Paso 2: Mostrar las instrucciones de pago al pagador

Una vez que recibas la respuesta, muestra lo siguiente al pagador:
  • CVU: el valor de wireInstructions.beneficiary.bank.account.number
  • Importe: la cantidad exacta de tu solicitud. El pagador debe enviar esta cifra precisa.
  • Vencimiento: la fecha límite de date.expirationDate
  • Nombre del beneficiario: el valor de wireInstructions.beneficiary.name (Localpayment S.R.L. como titular registrado de la cuenta)

Si el pagador transfiere una cantidad diferente, la transferencia se acredita como un pago entrante estándar a una cuenta virtual y no confirma la intención de pago.

Paso 3: Gestionar las notificaciones de pago

A diferencia de una cuenta virtual estándar (donde solo se recibe un webhook cuando se acredita un pago), Pago con Intención activa dos eventos de webhook:
  1. Notificación de creación (INPROGRESS): se activa inmediatamente cuando se crea la intención de pago e incluye el CVU asignado y la fecha de vencimiento en wireInstructions. Tu sistema puede utilizarla para confirmar la asignación del CVU.
  2. Notificación de finalización (COMPLETED): se activa cuando se procesa la transferencia del pagador y se recibe el importe exacto antes del vencimiento.

Notificación de finalización (COMPLETED)


Pruebas en Stage

Utiliza el endpoint Simular pago de cuenta virtual para realizar pruebas de extremo a extremo en Stage sin realizar transferencias bancarias reales. Simula un pago exitoso usando paymentMethod.code: "1060" y el mismo externalId devuelto en la respuesta de creación.

Demo


Próximos pasos

Recibir notificaciones de pago

Configura tu endpoint de webhook y aprende cómo verificar y gestionar las notificaciones de PayIn para pagos de cuentas virtuales.

Obtener el estado de la transacción

Consulta el endpoint de estado de la transacción para verificar el estado actual de una intención de pago.

Simular un pago

Prueba tu integración de principio a fin en el entorno de pruebas sin realizar transferencias bancarias reales.

Descripción general de las cuentas virtuales

Conoce todos los productos de cuentas virtuales y sus casos de uso.

Última modificación el 10 de noviembre de 2026