Rendi affidabili gli eventi di conversione e rimborso

Prima di iniziare

Un evento ricevuto non dimostra una commissione corretta. I messaggi possono ripetersi, un rimborso precedere la fine del processamento e un servizio rispondere anche se la registrazione commerciale fallisce. Programma e integrazione devono definire prove verificabili. Conferma le proprietà del trasporto nella documentazione del fornitore; Stripe è un esempio tecnico documentato, senza estenderne le proprietà agli altri sistemi.

Distingui tre identificatori

Separa identificatore del messaggio, dell'operazione commerciale e del partner. Riconoscono consegne ripetute, collegano ordine, fattura, annullamento ed esportazione e sostengono l'attribuzione. Aggiungi tipo di evento, versione e data commerciale al collaudo. Non ricavare un riferimento d'ordine da importo e indirizzo del cliente. Segui lo stesso riferimento nei sistemi coinvolti.

Verifica prima di elaborare

Usa il meccanismo di autenticità documentato dal fornitore, inclusa la firma quando disponibile. Definisci cosa registrare per firme non valide senza divulgare dati personali. Non modificare segreti durante una verifica editoriale. Una risposta HTTP positiva non prova autenticità o successo commerciale. Distingui ricezione, salvataggio ed esecuzione per individuare il primo errore.

Evita effetti duplicati nei tentativi

Quando un evento ritorna, recupera il risultato esistente invece di creare un'altra commissione. Conserva la prova del processamento collegata all'operazione commerciale. Chiavi di idempotenza API e deduplicazione di eventi ricevuti risolvono problemi diversi. Prova entrambi i percorsi separatamente: una protezione non copre automaticamente l'altra. Includi consegne contemporanee nel collaudo.

Gestisci eventi fuori sequenza

Descrivi un rimborso arrivato prima che l'ordine esista localmente. Prepara attesa controllata o recupero dal sistema di origine, secondo le capacità disponibili. Un aggiornamento vecchio non deve sovrascrivere uno stato più recente senza regola esplicita. Conserva orario dell'evento e della ricezione per spiegare ritardi, sequenza e correzioni successive.

Prova guasto e recupero

In un ambiente autorizzato, simula indisponibilità, risposta tardiva e ricezione ripetuta. Verifica limiti e tempi dei tentativi del fornitore. Ripetizione manuale e automatica possono coesistere. Definisci chi può ripetere un'operazione, prove richieste e controlli successivi. L'obiettivo è un solo effetto commerciale, non semplicemente un messaggio contrassegnato come ricevuto.

Riconcilia con i dati commerciali

Confronta regolarmente ordini e fatture di origine con operazioni idonee nella piattaforma. Distingui ritardo normale, rifiuto documentato e perdita reale. Verifica numero di operazioni e importi per valuta: un totale può nascondere duplicati compensati da record mancanti. Conserva esempi di riferimenti completi per acquisti, rimborsi parziali e annullamenti.

Prepara prove utili per gli incidenti

Raccogli riferimento commerciale, tipo, date, versione e stati atteso e osservato senza esporre segreti. Identifica il primo passaggio divergente, assegna responsabile e scadenza. Dopo la correzione, ripeti caso e casi vicini: riparare rimborsi non deve duplicare acquisti. Registra causa, risultato e controllo che permetterà di rilevare la stessa anomalia.

Risposte pratiche

Domande per decidere