Flujo de simulación
- Crear una cuenta virtual: Primero, genera una cuenta virtual en el entorno de prueba.
- 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.numberde la respuesta. - Vincular con la simulación: En tu solicitud de simulación, usa el
beneficiary.bank.account.numberobtenido en el paso anterior para vincular el pago simulado a la cuenta correcta. Además, proporciona unexternalIdúnico — este actúa como el ID del payin generado para esta transacción; utiliza unexternalIddiferente 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. - Activar simulación: Llama al endpoint Simular un pago de cuenta virtual.
- Recibir Webhook: Localpayment enviará un webhook
payin.completed(o similar) a tu endpoint configurado. - 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 decurl. Utiliza los mismos datos del beneficiario proporcionados al crear la cuenta virtual y proporciona un externalId único para cada solicitud de simulación.
- Argentina
- Brasil
- Chile
- Colombia
- Costa Rica (CRC)
- Costa Rica (USD)
- México (SPEI)
- México (TEF)
- Perú
Ejemplo de notificación de webhook
Tras un procesamiento exitoso, Localpayment envía un eventopayin.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.

