Manejo de errores de la API, reintentos e idempotencia

Diseña pensando en el fallo, no solo en el camino feliz. El caso más peligroso es el ambiguo: una solicitud que pudo o no haber tenido éxito antes de que se cortara la conexión.

Usa una clave de idempotencia en las solicitudes de pedido para que un reintento seguro tras un tiempo de espera devuelva el pedido existente en lugar de crear un cobro duplicado. Reintenta los errores transitorios (límites de tasa, errores 5xx temporales) con un backoff creciente y un tope.

Falla rápido ante errores permanentes, como una solicitud incorrecta o saldo insuficiente, y muéstralos a una persona: reintentarlos solo desperdicia tiempo. Registra cada solicitud y respuesta con su ID de pedido para poder conciliar más adelante.