Analizzare l'attività delle transazioni
Tracciare un ordine dalla creazione fino alla gestione, all'autenticazione, al pagamento, alla conferma, all'annullamento o al rimborso in DEUNA Admin.
In questa pagina
- Prima di iniziare
- Scegliere la visualizzazione appropriata
- Visualizza l'attività delle transazioni
- Segui la cronologia dei pagamenti
- Ispezionare gli eventi tecnici
- Raggruppare e cercare il traccia
- Indagare su un pagamento o una transazione fallita o in ritardo
- Preparare le prove per il supporto
- Limiti e recupero
- Prossimo passo
Utilizzare l'attività delle transazioni quando un ordine è in attesa, rifiutato, in ritardo o si comporta in modo diverso rispetto all'integrazione del commerciante. DEUNA Admin combina una cronologia dei pagamenti a livello aziendale con i record di richieste e risposte tecniche, consentendo ai team delle operazioni e dell'integrazione di indagare sulla stessa transazione senza dover passare da diversi strumenti.
L'attività delle transazioni è di sola lettura. Visualizzare un evento non tenta di ripetere una richiesta, modificare un ordine o contattare un processore di pagamento.
Prima di iniziare#
Il tuo ruolo deve includere le seguenti attività: sezione "Visualizza ordini" Autorizzazione. Conferma del commerciante e dell'ambiente selezionati prima di effettuare la ricerca; i dati sono validi solo per quel contesto.
Disporre di almeno un identificatore:
- ID ordine o token dell'ordine
- Transaction ID
- Indirizzo email del cliente, se consentito dalla vostra politica sulla privacy
- Data di creazione approssimativa
Se non è possibile aprire Pagamenti > Ordini, richiedere a un utente amministratore di revisionare Ruoli e permessi.
Scegliere la visualizzazione appropriata#
I dettagli dell'ordine forniscono due superfici di indagine correlate. Iniziare con Visualizza la cronologia, quindi utilizzare Tecnico quando è necessario l'interscambio sottostante.
| Superficie | Meglio per | Cosa mostra |
|---|---|---|
| Visualizza la cronologia | Comprensione del ciclo di vita dei pagamenti | Creazione e aggiornamenti dell'ordine, creazione e modifiche dello stato del pagamento, routing, 3DS e eventi di frode con i campi pertinenti a ciascun evento. |
| Tecnico | Diagnosticare un'integrazione o un'interazione con il provider | Eventi di transazione registrati, metodo HTTP e destinazione, codice di risposta, dati di richiesta e risposta, timestamp e identificatori di richiesta, traccia e span disponibili. |
| Registri di attività | Auditare le azioni eseguite dagli utenti Admin | Chi ha modificato una configurazione o eseguito un'azione Admin. I log di attività non rappresentano il tracciamento dell'esecuzione del pagamento. |
Visualizza l'attività delle transazioni#
- Accedi a DEUNA Admin.
- Seleziona il commerciante e l'ambiente associati alla transazione.
- Apri Pagamenti > Ordini.
- Cerca per ID ordine o email, oppure utilizza i filtri data e pagamento per restringere l'elenco.
- Aprire il menu delle azioni di riga e selezionare Visualizza dettagli.
- Per il riepilogo del ciclo di vita, seleziona Visualizza la cronologia. Per le attività di transazione, aprire Tecnico.
Se l'ordine non presenta eventi tecnici registrati, Tecnico mostra Nessuna attività tecnica. Questo da solo non identifica la causa o l'esito del pagamento.
Segui la cronologia dei pagamenti#
Seleziona Visualizza la cronologia dal header dei dettagli dell'ordine. La cronologia è presentata come una timeline, con l'evento più recente in cima.
I campi esatti dipendono dall'evento:
| Evento | Prove che puoi aspettarti |
|---|---|
| Ordine creato | Importo iniziale, valuta e stato dell'ordine. |
| Ordine aggiornato | Stato corrente dell'ordine e del pagamento. |
| Pagamento creato | Importo e valuta del pagamento. |
| Stato del pagamento aggiornato | Stato del pagamento e dettagli del processore applicabili, autorizzazione, conferma, rimborso o errori. |
| Routing generato | Regola e percorso applicati, nonché il fornitore di pagamento o di frode rappresentato da tale percorso. Una decisione di routing può creare più voci nella timeline. |
| 3DS aggiornato | Stato di autenticazione, provider 3DS e codice o messaggio di errore in caso di errore. |
| Analisi delle frodi | Dettagli del provider, decisione, rischio, valutazione o modalità "shadow". |
Non considerare un evento intermedio come il risultato finanziario finale. Ad esempio, una autenticazione 3DS di successo consente di continuare l'elaborazione del pagamento, ma non significa che il pagamento sia stato autorizzato o completato.
Ispezionare gli eventi tecnici#
Apri Tecnico. Questa vista presenta due aree: Attività e Dati.
Attività tecnica in DEUNA Admin. Tutti i valori relativi a merchant, utenti, provider, identificatori, tempi e payload nell’esempio sono fittizi.
Cosa contiene la vista Tecnica
| Area | Cosa viene visualizzato | Come usarlo |
|---|---|---|
| Contesto dell'ordine | Importo totale dell'ordine, stato dell'ordine e stato del pagamento, ultima modifica, token dell'ordine, ID dell'ordine e ID del cliente. | Verificare di aver aperto l'ordine corretto e l'ambiente prima di interpretare un evento. |
| Controlli sull'attività | Conteggio degli eventi registrati, controllo di ordinamento, ricerca per nome dell'evento e tre modalità di raggruppamento: Nessuna, Richiesta e Traccia. | Ridurre un lungo tracciamento della transazione agli eventi relativi all'operazione che si sta indagando. |
| Intestazione di gruppo | Tipo di gruppo, ID di richiesta o ID di traccia abbreviato, numero di eventi e somma del tempo di esecuzione registrato per gli eventi in quel gruppo. | Espandi o ripristina i checkpoint correlati e confronta una richiesta o una traccia con un'altra. |
| Checkpoint di attività | Badge di codice di risposta quando disponibile, nome dell'evento, ora di creazione dell'evento e timestamp del log registrato. | Seleziona il checkpoint che corrisponde meglio alla fase fallita, ritardata o inaspettata. |
| Riepilogo dello scambio | Metodo HTTP o protocollo, destinazione, ID di richiesta, ID di traccia e ID di span. Gli identificatori disponibili includono i controlli di copia. | Correlare l'evento con i log del commerciante, le prove del fornitore o un'indagine di supporto DEUNA. |
| Visualizzatore dati | Schede "Richiesta" e "Risposta", badge con codice di stato, valore del tempo trascorso (se disponibile) e dati del payload formattati con controllo di copia. | Confronta i dati di uscita con il risultato restituito. Copia solo le prove minime necessarie. |
Il visualizzatore del payload mantiene visibili i nomi degli oggetti e dei campi in modo da poter ispezionare la struttura dello scambio. I valori e l'incapsulamento variano a seconda dell'evento e del fornitore. Un campo mostrato nell'esempio non è garantito che appaia in ogni transazione.
Leggi un evento
- selezionare un evento in Attività. Sul dispositivo mobile, espandere l'evento.
- Verificare il nome dell'evento e il timestamp.
- Confrontare il metodo HTTP, la destinazione e il badge del codice di risposta con l'operazione prevista.
- Passare tra Richiesta e Risposta in Dati.
- Registrare l'ID della richiesta, l'ID di traccia o l'ID di span quando sono presenti.
Quando un evento ha 4xx risposta, DEUNA Admin può visualizzare un messaggio di errore Al di sopra del payload. Gli altri codici di risposta rimangono visibili nell'evento e nel pannello dati.
Il codice di risposta indica lo stato della transazione tecnica, non necessariamente il risultato finale del pagamento. Prima di completare un ordine, confrontare il codice con Stato di pagamento, Visualizza la cronologia, e notifiche di stato asincrone.
Eventi generati durante un flusso di ordine
L'attività disponibile dipende dal percorso seguito dalla transazione. Gruppi comuni includono:
| Fase | Esempi visibili nell'attività | Cosa controllare |
|---|---|---|
| Ordine | È stato creato un nuovo ordine; l'ordine è stato aggiornato | Identificatori dell'ordine e lo stato restituito all'integrazione del commerciante. |
| Routing | Generare il routing del pagamento | il percorso selezionato e gli scambi con il provider che lo seguono. |
| Pagamento | Generare il pagamento; richiedere l'autorizzazione | Importo e valuta richiesti, risposta del processore e stato risultante del pagamento. |
| Autenticazione | È iniziata, sfidata, aggiornata, completata o fallita la valutazione 3DS | Se è stato richiesto un'azione da parte del cliente e se l'elaborazione del pagamento è continuata successivamente. |
| Verifica dell'indirizzo | Validazione AVS, soppressione o annullamento | Risultato di validazione normalizzato e l'azione di pagamento che ne ha seguito. |
| Frode | Generare l'analisi del motore antisfiducia; valutazione "shadow" | Risultato del provider e se la transazione è proseguita con l'elaborazione del pagamento o la revisione. |
| Operazioni post-pagamento | Elaborazione, autorizzazione parziale, rimborso, rimborso parziale, annullamento, richiesta di annullamento | Importo e identificatore dell'operazione, risposta e l'evento di stato di pagamento successivo che conferma il risultato. |
Alcuni eventi registrano che si è verificato un passaggio, ma non contengono il corpo della richiesta o della risposta. La disponibilità del payload varia a seconda dell'operazione e del provider.
Raggruppare e cercare il traccia#
In Attività, utilizzare i seguenti controlli per ridurre una lunga traccia:
- Nessuno mostra ogni evento in un elenco piatto.
- Richiesta raggruppa gli eventi che condividono un ID di richiesta. Utilizzalo per seguire il lavoro avviato da una richiesta in entrata.
- Traccia raggruppa gli eventi che condividono un ID di traccia. Utilizzalo per seguire una transazione attraverso passaggi di elaborazione correlati.
- Cerca evento filtra in base al nome dell'evento visualizzato.
- Ordina l'attività inverte l'ordine degli eventi.
Quando un evento non ha un valore per l'identificatore di raggruppamento selezionato, DEUNA Admin lo inserisce in Orfano. L'evento può comunque essere utile quando corrisponde all'intervallo di tempo dell'incidente, in base al suo ID di transazione, al timestamp e agli eventi adiacenti.
Indagare su un pagamento o una transazione fallita o in ritardo#
Seguire questo ordine per evitare di confondere un errore tecnico intermedio con il risultato finale:
- Verificare l'ambiente, lo stato corrente dell'ordine, lo stato corrente del pagamento. Order IDe Transaction ID.
- Apri Visualizza la cronologia e identificare l'ultimo evento del ciclo di vita.
- Apri Tecnico e raggruppare per Traccia.
- Trovare il pagamento, il routing, l'autenticazione, la frode o l'evento post-pagamento corrispondente.
- Confrontare il suo codice di risposta e i dati di risposta con l'evento successivo nel traccia.
- Verificare se un aggiornamento dello stato successivo ha ripristinato il pagamento, lo ha spostato a un altro fornitore o ha confermato un fallimento finale.
- Confrontare lo stato finale di DEUNA con lo stato ricevuto tramite il webhook di pagamento.
Per un rifiuto, cercare nel pubblico riferimento al codice di errore utilizzando il codice di errore di DEUNA. I codici e i messaggi specifici del fornitore devono essere interpretati in base alla documentazione del fornitore pertinente.
Preparare le prove per il supporto#
Quando è necessario che DEUNA Support intervenga, fornire le prove minime richieste:
- Commerciante e ambiente
- ID ordine o token dell'ordine
- Transaction ID
- Timestamp UTC e finestra temporale dell'incidente
- Nome dell'evento visualizzato e codice di risposta
- ID della richiesta, ID del traccia e ID dello span quando disponibili
- Stato corrente dell'ordine e del pagamento
- Comportamento previsto e comportamento osservato
Inviare solo il payload completo quando richiesto dal supporto tramite un canale approvato.
Limiti e recupero#
- L'attività di transazione è un registro di osservabilità, non un controllo di riproduzione o di retry.
- Non ogni fase produce un corpo di richiesta e risposta.
- Gli eventi possono arrivare dopo la richiesta iniziale quando un fornitore segnala un risultato asincrono.
- La mancanza di attività non stabilisce se un fornitore ha elaborato la transazione.
- Lo stato corrente del pagamento o dell'ordine è l'istantanea amministrativa autorevole; utilizzare i webhook e la risposta API pertinenti per la gestione dello stato sul lato di integrazione.
Se gli identificatori e l'ambiente sono corretti, ma l'evento richiesto è ancora assente, raccogliere le prove di cui sopra e contattare DEUNA Support. Non ripetere l'operazione di pagamento fino a quando non si è confermato che è sicuro farlo.