Reintentos automáticos
El plugin procesa los eventos Pix de forma asíncrona. Si falla al procesar un evento, el plugin reintenta ahí mismo y después captura el evento en una dead-letter queue sin pérdida. Un operador reproduce un evento retenido, limitado a un número máximo de intentos. Después del límite, el registro permanece retenido para inspección y el plugin nunca lo descarta. El plugin reintenta las llamadas salientes al proveedor ante respuestas 5xx y timeouts. Cada reintento usa backoff exponencial con jitter.
Conciliació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 conciliació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 que siguen atascadas en pending. Para cada una, vuelve a ejecutar los pasos idempotentes (settle, confirm o close), que el proveedor deduplica por la referencia de la devolución. Retiene para un operador una fila que sigue en el paso create, porque una repetición ciega de create podría causar una devolución doble. Cada intento fallido espera más que el anterior, desde un minuto hasta una hora. Después de un número máximo de intentos, el sweeper retiene el registro y genera una alerta. No reintenta para siempre. El sweeper es opcional y está desactivado de forma predeterminada.
Configuración
Puedes ajustar el comportamiento de reintentos y conciliación con variables de entorno:
Qué debes hacer
El plugin gestiona los reintentos y la conciliación por ti. Los ajustes predeterminados sirven para 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 jobs o soporte de repetición de eventos.