Un fallo de red es ambiguo: ConverterHQ puede aceptar la petición aunque el cliente no reciba la respuesta. Diseña creaciones y handlers para replay seguro.
Creaciones idempotentes
Usa la misma Idempotency-Key solo para la misma operación lógica y client_reference_id para tu ID de negocio. Nunca reutilices una key con un body diferente.
Reintentos de transporte
Reintenta timeouts, resets, 429 y 5xx retryable con backoff exponencial y jitter. Respeta Retry-After; no repitas 4xx deterministas automáticamente.
Reintentos de Tasks
Un retry de ejecución crea una nueva attempt y conserva el fallo anterior. El trabajo upstream ya correcto no desaparece si solo hay que repetir una rama downstream.
Idempotencia de webhooks
Verifica la firma antes del efecto y deduplica por event_id. Responde rápido y envía trabajo lento a tu propia cola.