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.- Tu sistema llama a
POST /api/payin/conpaymentMethod.code: "1060"y el importe esperado. - Localpayment devuelve un código CVU único, los datos bancarios del beneficiario y una fecha de vencimiento.
- Tú muestras al pagador el CVU, el importe exacto y la fecha de vencimiento.
- El pagador inicia una transferencia bancaria al CVU desde su aplicación bancaria o billetera.
- 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 solicitudPOST 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)
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:- 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 enwireInstructions. Tu sistema puede utilizarla para confirmar la asignación del CVU. - 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 usandopaymentMethod.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.

