Gestire errori API, retry e idempotenza

Progetta tenendo conto degli errori, non solo del percorso ideale. Il caso più pericoloso è quello ambiguo: una richiesta che potrebbe essere andata a buon fine oppure no prima che la connessione cadesse.

Usa una chiave di idempotenza sulle richieste d'ordine così che un retry sicuro dopo un timeout restituisca l'ordine esistente invece di creare un addebito duplicato. Ritenta gli errori transitori (rate limit, 5xx temporanei) con un backoff crescente e un limite massimo.

Fallisci subito sugli errori permanenti come una richiesta errata o un saldo insufficiente e portali all'attenzione di una persona: ritentarli non fa che sprecare tempo. Registra ogni richiesta e risposta con il relativo ID ordine così da poter riconciliare in seguito.