Reintentos automáticos
El plugin procesa los eventos Pix de forma asíncrona. Si falla al procesar un evento, el plugin reintenta en el momento y luego captura el evento en una cola de mensajes fallidos sin pérdida. Un operador reprocesa un evento aislado, con un número máximo de intentos. Tras el límite, el registro queda aislado para inspección y el plugin nunca lo descarta. El plugin reintenta las llamadas salientes al proveedor ante respuestas 5xx y tiempos de espera agotados. Cada reintento usa retroceso exponencial con jitter.
Reconciliación de devoluciones
Una devolución puede tener éxito en el proveedor pero fallar al registrarse localmente si el servicio se cae entre los dos pasos. El sweeper de reconciliación de devoluciones es una red de seguridad en segundo plano para este caso. El sweeper se ejecuta con un temporizador y encuentra las devoluciones aún atascadas en pendiente. Para cada una, reejecuta los pasos idempotentes — liquidar, confirmar o cerrar — que el proveedor deduplica por la referencia de la devolución. Aísla para un operador una fila aún en el paso de creación, porque una recreación a ciegas podría causar una doble devolución. Cada intento fallido espera más que el anterior, desde un minuto hasta una hora. Tras un número máximo de intentos, el sweeper aísla el registro y genera una alerta. No reintenta para siempre. El sweeper es opcional y está desactivado por defecto.
Configuración
Puedes ajustar el comportamiento de reintentos y reconciliación con variables de entorno:
Lo que necesitas hacer
El plugin gestiona los reintentos y la reconciliación por ti. La configuración predeterminada se ajusta a la mayoría de los despliegues. Para mantener las operaciones sanas:
- Usa IDs únicos y rastreables para tus transacciones y cuentas.
- Monitorea la entrega de eventos y el estado de las transacciones.
- Contacta a Lerian para obtener visibilidad de los trabajos o soporte de reproducción de eventos.