Manejo de Capturas y Reembolsos Concurrentes

Contexto

La funcionalidad de Manejo Concurrente de Capturas y Reembolsos permite a DEUNA gestionar múltiples operaciones financieras — específicamente capturas parciales y reembolsos — que ocurren de forma concurrente o en rápida sucesión sobre la misma transacción. Esta capacidad es esencial para comercios que operan en entornos con alta concurrencia, donde pueden darse traslapes en el tiempo entre llamadas a la API.

Este mecanismo asegura que cada operación se procese de forma atómica y secuencial, evitando condiciones de carrera y manteniendo la consistencia del estado de la transacción en todos los servicios involucrados.

Capacidades Clave

✅ Mecanismo de bloqueo secuencial: Garantiza que solo una operación financiera se procese a la vez para una misma transacción.

🔄 Soporte para solicitudes concurrentes: Permite manejar múltiples solicitudes de captura o reembolso para la misma transacción sin comprometer la integridad.

🧾 Auditoría y trazabilidad: Cada operación (captura o reembolso) se registra con su marca de tiempo, origen y resultado.

💳 Compatibilidad con todos los PSPs: Funciona con todas las integraciones actuales (por ejemplo, Fiserv, Kushki, MercadoPago) mediante una capa de orquestación unificada.

Notas de Integración

No se requiere ningún cambio por parte del comercio.
Los endpoints existentes /capture y /refund son totalmente compatibles.
El manejo de concurrencia es completamente gestionado por la infraestructura interna de DEUNA.

Limitaciones

Este mecanismo soporta actualmente operaciones de captura y reembolso. Las autorizaciones y anulaciones (voids) no se ven afectadas.