Saltar al contenido principal
Aprende a probar la integración de tu cuenta virtual simulando pagos entrantes en el entorno de prueba. Valida tus receptores de webhook y la lógica de conciliación sin transferencias bancarias reales. Probar la integración de tu cuenta virtual es un paso fundamental antes de tu lanzamiento. Para facilitar este proceso, Localpayment proporciona un endpoint de simulación en el entorno de prueba que te permite simular un pago entrante a cualquier cuenta virtual activa. Esta simulación imita el comportamiento de una transferencia ACH local real, lo que activa las mismas actualizaciones de estado internas y notificaciones de webhook que cabría esperar en un entorno de producción.

Flujo de simulación

  1. Crear una cuenta virtual: Primero, genera una cuenta virtual en el entorno de prueba.
  2. Obtener estado de la cuenta virtual: Usa el endpoint Obtener estado de la cuenta virtual para confirmar que la cuenta se creó correctamente y recuperar el campo beneficiary.bank.account.number de la respuesta.
  3. Vincular con la simulación: En tu solicitud de simulación, usa el beneficiary.bank.account.number obtenido en el paso anterior para vincular el pago simulado a la cuenta correcta. Además, proporciona un externalId único — este actúa como el ID del payin generado para esta transacción; utiliza un externalId diferente para cada solicitud de simulación. También debes incluir el accountNumber (ID de comerciante) de tu cuenta de Localpayment para identificar la cuenta del comerciante asociada al pago simulado.
  4. Activar simulación: Llama al endpoint Simular un pago de cuenta virtual.
  5. Recibir Webhook: Localpayment enviará un webhook payin.completed (o similar) a tu endpoint configurado.
  6. Verificar estado: utiliza la API de estado de la transacción para confirmar que la transacción simulada ha alcanzado el estado esperado.

Dependencias técnicas

Requisito secuencial: No se puede simular un pago para una cuenta que no se haya creado correctamente. Si la llamada para Crear una cuenta virtual falla, el intento de simulación devolverá un error 404 (No encontrado).

Ejemplos de código (Stage)

Selecciona tu mercado objetivo para ver un ejemplo completo de curl. Utiliza los mismos datos del beneficiario proporcionados al crear la cuenta virtual y proporciona un externalId único para cada solicitud de simulación.

Ejemplo de notificación de webhook

Tras un procesamiento exitoso, Localpayment envía un evento payin.completed síncrono a tu endpoint configurado. Esta notificación sigue la estructura PayIn de alto nivel estándar observada en todos los productos de pago.

Solución de problemas


Próximos pasos

Verificar estado

Obtén actualizaciones de estado en tiempo real para confirmar el progreso de la transacción simulada.

Configurar webhooks

Valida la lógica de tu oyente con notificaciones de éxito en tiempo real.
Última modificación el 10 de noviembre de 2026