> Miglioramento Continuo dei Processi > Elaborazione Pagamenti > Adyen > Template Dati

Il suo `template` di `dati` per l'elaborazione dei pagamenti

Adyen

Attributi di Elaborazione dei Pagamenti (20) Attività di Elaborazione dei Pagamenti (16) Guide all'Estrazione (2)

Il suo `template` di `dati` per l'elaborazione dei pagamenti

Questo `template` fornisce una guida completa per la raccolta dei `dati` necessari per analizzare l'elaborazione dei suoi pagamenti in Adyen. Delinea tutti gli attributi di `dati` essenziali e le attività di processo da tracciare, insieme a istruzioni pratiche per l'estrazione dei `dati`. Lo utilizzi per assicurarsi di catturare tutte le informazioni critiche per un efficace `process mining`.

Attributi consigliati da raccogliere
Attività chiave da tracciare
Guida pratica all'estrazione per Adyen

È nuovo agli event log? Impari come creare un event log di Process Mining.

Scarica Template

Attributi di Elaborazione dei Pagamenti

Questi sono i campi di dati raccomandati da includere nel suo Event Log per un'analisi completa dell'elaborazione dei suoi pagamenti all'interno di Adyen.

5 Obbligatorio 7 Consigliato 8 Facoltativo

	Nome	Descrizione
	ID Transazione di Pagamento PspReference	L'identificativo di riferimento unico assegnato da Adyen a ogni transazione di pagamento.
Descrizione Questo attributo funge da chiave primaria per l'intero ciclo di vita del pagamento all'interno dell'ecosistema Adyen. Collega la richiesta di pagamento iniziale a `eventi` successivi come autorizzazione, acquisizione, liquidazione e potenziali rimborsi o chargeback. Nell'analisi, questo ID viene utilizzato per raggruppare `eventi` discreti in un singolo `case`, consentendo la ricostruzione del processo `end-to-end`. Permette agli analisti di tracciare il percorso specifico di un pagamento dall'inizio dell'acquirente alla liquidazione finanziaria finale. Perché è importante È il legame fondamentale che raggruppa `event` disconnessi in un'unica istanza di processo per il `mining`. Dove trovare Adyen Payment Response '`pspReference`' o colonna 'PSP Reference' del Settlement Detail Report. Esempi 851564567890123479145612345678908825641234567890
	Nome attività EventCode	La fase o azione specifica che si verifica nel ciclo di vita del pagamento.
Descrizione Questo attributo definisce l'`evento` specifico che si è verificato, come AUTHORISATION, CAPTURE o REFUND. Detta i nodi nella mappa del processo e determina il flusso della transazione. Nell'analisi, questi codici sono tradotti in nomi di attività leggibili dall'uomo per visualizzare il flusso di processo. Le variazioni nella sequenza di questi codici indicano percorsi di processo diversi, come l'elaborazione diretta rispetto alla gestione delle eccezioni. Perché è importante Definisce il 'cosa' del modello di `Process Mining`, consentendo la visualizzazione dei `flow` di processo. Dove trovare Campo '`eventCode`' degli Adyen Notification Webhook. Esempi AUTHORISATIONCAPTURERIMBORSOCANCELLATIONCHARGEBACK
	Timestamp Evento EventDate	La data e l'ora in cui si è verificata la specifica attività di pagamento.
Descrizione Questo attributo registra il `timestamp` preciso di quando un `evento` (come autorizzazione o liquidazione) è stato registrato nel sistema. Consente l'ordinamento cronologico delle attività all'interno di un `case`. Nell'analisi, questo è cruciale per calcolare i tempi di ciclo, identificare i colli di bottiglia e determinare la produttività del sistema nel tempo. Supporta tutti i KPI basati sul tempo, come 'Tempo Complessivo del Ciclo di Pagamento'. Perché è importante Essenziale per ordinare gli `event` e calcolare tutte le metriche basate sulla durata. Dove trovare Campo '`eventDate`' degli Adyen Notification Webhook. Esempi 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	Sistema di Origine SourceSystem	Il nome del sistema da cui provengono i dati.
Descrizione Questo attributo statico identifica che il record proviene da Adyen. Nel `process mining` multi-sistema (es. combinando Adyen con SAP), questo è cruciale per la `lineage`. Nell'analisi, consente agli utenti di filtrare le attività che si sono verificate specificamente all'interno del `gateway` di pagamento rispetto al sistema ERP o di Order Management. Perché è importante Cruciale per la `data lineage` nel `Process Mining` multi-sistema. Dove trovare Valore statico durante l'estrazione. Esempi AdyenAdyen_Production
	Ultimo `Data Update` LastDataUpdate	Il `timestamp` dell'ultima estrazione o aggiornamento del record.
Descrizione Questo attributo indica la freschezza dei `dati` nel modello di `process mining`. Aiuta gli utenti a capire se stanno osservando `dati` in tempo reale o una snapshot. Nell'analisi, questo è principalmente un campo tecnico utilizzato per la `data governance` e per convalidare che la pipeline stia funzionando correttamente. Perché è importante Campo tecnico per tracciare la freschezza dei dati. Dove trovare Ora del sistema al momento dell'estrazione. Esempi 2023-10-30T12:00:00Z
	È una Rilavorazione IsRework	`Flag` che indica se la transazione ha comportato nuovi tentativi o correzioni di errore.
Descrizione Un `flag` booleano che è `true` se il `case` contiene più tentativi di autorizzazione, o contiene `activity` come 'Pagamento Rifiutato' seguite da un nuovo tentativo. Nell'analisi, questo alimenta la `dashboard` 'Punti Critici di Rielaborazione ed Eccezione dei Pagamenti'. Consente agli analisti di filtrare specificamente i `case` problematici per comprendere perché i `flow` di processo non seguono il percorso ideale. Perché è importante Identifica `case` inefficienti che richiedono intervento manuale o di sistema. Dove trovare Calcolato in base all'occorrenza di `event` di fallimento > 0. Esempi truefalse
	Importo della Transazione PaymentAmount	Il valore monetario della transazione di pagamento.
Descrizione Questo attributo rappresenta il valore finanziario associato alla transazione. Di solito è memorizzato come unità minore (es. centesimi) nei `dati` grezzi, ma dovrebbe essere convertito per la rendicontazione. Nell'analisi, questo abilita la `dashboard` 'Payment Throughput' e aiuta a prioritizzare i `case` di rilavorazione di alto valore. Viene anche utilizzato per calcolare il volume totale elaborato e l'impatto finanziario delle transazioni fallite. Perché è importante Necessario per l'analisi dell'impatto finanziario e il monitoraggio del `throughput`. Dove trovare Adyen Payment Request '`amount.value`'. Esempi 10005509900
	Merchant Account MerchantAccount	Lo specifico account commerciante all'interno di Adyen che elabora la transazione.
Descrizione Adyen consente più `merchant account` sotto un unico `company account`. Questo `attributo` identifica quale specifica `business unit`, `brand` o entità regionale ha elaborato il pagamento. Nell'analisi, questo serve come dimensione primaria per la segmentazione. Permette agli `stakeholder` di confrontare performance, tassi di fallimento e volumi tra diverse `business unit` o `brand` per identificare aree specifiche di miglioramento. Perché è importante Chiave per segmentare le performance per `business unit` o sussidiaria. Dove trovare Adyen Payment Request/Response '`merchantAccount`'. Esempi MyStore_UKMyStore_USGlobalSales_Main
	Metodo di Pagamento PaymentMethod	Il metodo specifico utilizzato dall'acquirente per pagare, come Visa o PayPal.
Descrizione Questo attributo cattura il tipo di strumento di pagamento utilizzato, inclusi marchi di carte di credito (Visa, MC), wallet digitali (PayPal, Apple Pay) o metodi di pagamento locali (iDEAL, Sofort). Nell'analisi, questo è vitale per la dashboard 'Payment Method Performance Insights'. Aiuta le correlazioni tra metodi di pagamento specifici e tassi di autorizzazione, velocità di elaborazione o fallimenti tecnici. Perché è importante Critico per l'analisi dei tassi di successo e dei costi tra diversi fornitori di pagamento. Dove trovare Adyen Payment Response '`paymentMethod.brand`' o '`paymentMethod.type`'. Esempi visamcpaypalidealklarna
	Motivo del Rifiuto RefusalReason	La descrizione testuale che spiega perché un pagamento è stato rifiutato o non è riuscito.
Descrizione Quando una transazione fallisce, Adyen fornisce un codice motivo o una descrizione (es. 'Saldo insufficiente', 'CVC Rifiutato', 'Carta Scaduta'). Nell'analisi, questo è il driver principale per la `dashboard` 'Tasso di Fallimento delle Transazioni di Pagamento'. L'analisi di queste ragioni aiuta a identificare se i fallimenti sono dovuti a problemi tecnici, regole antifrode o comportamento dell'acquirente, guidando azioni di rimedio specifiche. Perché è importante L'attributo chiave per l'analisi delle cause principali dei pagamenti falliti. Dove trovare Adyen Payment Response '`refusalReason`'. Esempi RifiutatoSaldo insufficienteCarta ScadutaErrore dell'AcquirerFrode
	Stato del Pagamento PaymentStatus	Lo stato attuale del pagamento (es. Autorizzato, Liquidato, Rifiutato).
Descrizione Questo attributo riflette l'ultimo stato noto della transazione di pagamento. È spesso derivato dall'attività più recente nel `case`. Nell'analisi, consente un filtraggio rapido dei `case` (ad esempio, 'Mostrami tutti i pagamenti attualmente Rifiutati'). È essenziale per la `dashboard` 'Payment Throughput and Status Monitoring'. Perché è importante Fornisce una panoramica dello stato attuale della transazione. Dove trovare Derivato dall'ultimo `event code` nel `case`. Esempi SaldatoRifiutatoAutorizzato
	Tempo Complessivo del Ciclo di Pagamento TotalCycleTime	La durata totale dalla creazione della richiesta di pagamento alla liquidazione.
Descrizione Questo è una metrica calcolata che misura il tempo trascorso tra il primissimo `evento` (es. 'Richiesta di Pagamento Ricevuta') e l'`evento` 'Pagamento Liquidato'. Nell'analisi, questo è il KPI di efficienza primario. Evidenzia la velocità del flusso di cassa. Tempi di ciclo lunghi potrebbero indicare problemi con ritardi di acquisizione o cicli di liquidazione. Perché è importante `KPI` per l'ottimizzazione del capitale circolante. Dove trovare Calcolato: `Timestamp`(Settled) - `Timestamp`(Created). Esempi 2 giorni4 ore5 minuti
	Codice di Autorizzazione AuthorisationCode	Il codice di autorizzazione restituito dall'emittente al momento dell'approvazione.
Descrizione Un codice che indica che i fondi sono stati riservati sulla `card` dell'acquirente. Questa è la prova di un'autorizzazione riuscita. Nell'analisi, questo è principalmente per l'`audit` e la tracciabilità. Convalida che l'`activity` 'Pagamento Autorizzato' fosse legittima. Perché è importante Prova di autorizzazione riuscita per audit trail. Dove trovare Adyen Payment Response '`authCode`'. Esempi 123456098712
	ID Cliente ShopperReference	Un riferimento unico utilizzato per identificare l'acquirente attraverso più transazioni.
Descrizione Questo identificativo collega diverse transazioni alla stessa entità cliente. Viene fornito dal commerciante durante la richiesta di pagamento. Nell'analisi, questo consente un'analisi customer-centric, permettendo l'individuazione di recidivi in `case` di frode o clienti fedeli nell'analisi di transazioni riuscite. Facilita la mappatura `generica` del 'Cliente'. Perché è importante Consente l'aggregazione a livello di cliente e l'analisi del comportamento. Dove trovare Adyen Payment Request '`shopperReference`'. Esempi CUST-001user_12345email@example.com
	Numero Lotto di Liquidazione BatchNumber	Il numero di lotto associato alla liquidazione dei fondi.
Descrizione Adyen raggruppa i pagamenti regolati in `batch` per il `payout`. Questo `attributo` identifica a quale `batch` appartiene una specifica transazione. Nell'analisi, questo viene utilizzato per raggruppare i pagamenti in base al loro ciclo di `payout`. Aiuta a verificare se specifici `batch` sono in ritardo e supporta il tracciamento dell'`activity` 'Pagamento Regolato'. Perché è importante Collega le singole transazioni ai regolamenti finanziari in blocco. Dove trovare Campo '`Batch Number`' dell'Adyen Settlement Detail Report. Esempi 100255
	Paese dell'Acquirente ShopperCountry	Il codice paese di due lettere dell'acquirente.
Descrizione Questo attributo indica la posizione dell'acquirente, tipicamente derivata dal paese di emissione della carta o dall'indirizzo di fatturazione. Nell'analisi, viene utilizzato per l'analisi delle prestazioni regionali. Aiuta a identificare se paesi specifici hanno tassi di rifiuto più alti o tempi di elaborazione più lenti a causa dell'infrastruttura bancaria locale. Perché è importante Consente la segmentazione geografica delle performance di pagamento. Dove trovare Adyen Payment Request '`countryCode`' o '`billingAddress.country`'. Esempi NLUSDE
	Punteggio di Rischio Frode RiskScore	Il punteggio di rischio assegnato alla transazione dal motore antifrode.
Descrizione Il motore RevenueProtect di Adyen assegna un `score` numerico (0-100) che indica la probabilità di frode. `Score` più elevati spesso attivano una revisione manuale o un blocco automatico. Nell'analisi, questo supporta la 'Panoramica del Rischio di Conformità Finanziaria'. Correlare `score` di rischio elevati con i `chargeback` aiuta a calibrare le regole antifrode. `Score` elevati che si traducono in pagamenti riusciti potrebbero indicare falsi positivi nel modello di rischio. Perché è importante Essenziale per analizzare l'efficienza della logica di prevenzione delle frodi. Dove trovare Risposta dell'Adyen Risk API o Reporting '`fraudResult.accountScore`'. Esempi 025100
	Riferimento dell'Acquirer AcquirerReference	Numero di riferimento fornito dalla banca acquirente.
Descrizione Questo è il riferimento esterno assegnato dall'istituzione finanziaria sottostante (acquirente) che elabora la transazione della carta. È distinto dal riferimento PSP di Adyen. Nell'analisi, questo campo è critico per l''Analisi del Ritardo di Riconciliazione dei Pagamenti'. È la chiave utilizzata per abbinare i record Adyen agli estratti conto bancari nei registri esterni. Perché è importante Essenziale per la riconciliazione a 3 vie e la riconciliazione esterna. Dove trovare Adyen Payment Response '`additionalData.acquirerReference`'. Esempi 1234567890987654321
	Tipo di Interazione dell'Acquirente ShopperInteraction	Indica se il pagamento era `Ecommerce`, `POS` o un abbonamento (`ContAuth`).
Descrizione Questo attributo classifica la natura dell'interazione tra l'acquirente e il commerciante. I valori tipici sono `Ecommerce` (online), `POS` (in negozio) o `ContAuth` (ricorrente/abbonamento). Nell'analisi, questo aiuta a distinguere tra diversi modelli di business e canali di vendita. I flussi di processo spesso differiscono significativamente tra POS ed Ecommerce, rendendo questo un filtro vitale per una chiara scoperta del processo. Perché è importante Differenzia i `flow` di processo tra pagamenti `online`, in negozio (`in-store`) e ricorrenti. Dove trovare Adyen Payment Request '`shopperInteraction`'. Esempi EcommerceContAuthPOSMoto
	Valuta PaymentCurrency	Il codice ISO di tre lettere che indica la valuta della transazione.
Descrizione Questo attributo definisce la valuta in cui è espresso il `PaymentAmount`. I valori comuni includono EUR, USD, GBP, ecc. Nell'analisi, questo viene utilizzato per raggruppare le transazioni per mercato ed è essenziale per normalizzare i valori finanziari quando si aggregano i dati in diverse regioni. Perché è importante Contestualizza il campo `amount` per il `reporting` multi-valuta. Dove trovare Adyen Payment Request '`amount.currency`'. Esempi EURUSDGBP

Obbligatorio Consigliato Facoltativo

Attività di Elaborazione dei Pagamenti

Questi sono i passaggi chiave del processo e le pietre miliari da catturare nel suo Event Log per una scoperta accurata del processo nei suoi flussi di pagamento Adyen.

5 Consigliato 11 Facoltativo

	Activity	Descrizione
	Pagamento Acquisito	Il comando per trasferire i fondi dall'acquirente al commerciante è stato elaborato con successo. Questo può essere immediato (acquisizione automatica) o ritardato (acquisizione manuale).
Perché è importante Conferma il riconoscimento dei ricavi. Il tempo tra Autorizzazione e Cattura è fondamentale per il `KPI` 'Tempo di `Lead` Autorizzazione Pagamento'. Dove trovare Adyen Notification Webhook: `eventCode` 'CAPTURE' con `success`='true'. Acquisisci Registrato su successo del `webhook` CAPTURE Tipo di evento explicit
	Pagamento Autorizzato	L'emittente della carta o il metodo di pagamento ha approvato la transazione e i fondi sono riservati. Acquisito tramite il webhook di notifica standard di Adyen.
Perché è importante Una pietra miliare critica che indica che la transazione è valida e i fondi sono disponibili. Precondizione per la cattura. Dove trovare Adyen Notification Webhook: `eventCode` 'AUTHORISATION' con `success`='true'. Acquisisci Registrato su successo del `webhook` AUTHORISATION Tipo di evento explicit
	Pagamento Rifiutato	La transazione è stata rifiutata dall'emittente o dalle regole di rischio di Adyen. Acquisita tramite il webhook di autorizzazione con uno stato di fallimento.
Perché è importante Influisce direttamente sul `KPI` 'Tasso di Fallimento delle Transazioni di Pagamento'. L'analisi delle ragioni di rifiuto aiuta a ottimizzare i tassi di autorizzazione. Dove trovare Adyen Notification Webhook: `eventCode` 'AUTHORISATION' con `success`='false'. Acquisisci Registrato su fallimento del `webhook` AUTHORISATION Tipo di evento explicit
	Pagamento Saldato	I fondi sono stati liquidati e accreditati con successo sull'`account` Adyen dell'esercente. Questo appare nel Settlement Detail Report.
Perché è importante La conclusione finanziaria del processo riuscito. Essenziale per 'Tempo Complessivo del Ciclo di Pagamento' e 'Analisi del Ritardo di Riconciliazione dei Pagamenti'. Dove trovare Adyen Settlement Detail Report (SDR), tipo di `record` 'Settled'. Acquisisci Registrato quando la transazione appare nel Settlement Report Tipo di evento explicit
	Richiesta di Pagamento Ricevuta	La ricezione iniziale della richiesta di transazione da parte della piattaforma di pagamento Adyen. Questo viene acquisito dal timestamp della richiesta API iniziale o dalla creazione del pspReference.
Perché è importante Segna l'inizio assoluto dell'istanza del processo. Essenziale per il calcolo del tempo di ciclo totale end-to-end. Dove trovare `Log` dell'API di Pagamento Adyen o il `timestamp` associato alla creazione del `pspReference`. Acquisisci Registrato quando il `pspReference` viene generato tramite `API` Tipo di evento explicit
	Cattura Fallita	Il tentativo di acquisire fondi autorizzati è fallito, spesso a causa di un timeout tecnico o di modifiche dello stato della carta tra l'autorizzazione e l'acquisizione.
Perché è importante Punto di errore critico che richiede rilavorazione o nuovo tentativo. Contribuisce al 'Tasso di Eccezione di Pagamento'. Dove trovare Adyen Notification Webhook: `eventCode` 'CAPTURE_FAILED'. Acquisisci Registrato su `webhook` CAPTURE_FAILED Tipo di evento explicit
	Chargeback Annullato	La contestazione è stata vinta e i fondi vengono restituiti al commerciante. Questa è una risoluzione riuscita di un'eccezione.
Perché è importante Esito positivo per la gestione del rischio. Compensa l'impatto finanziario del chargeback iniziale. Dove trovare Adyen Notification Webhook: `eventCode` 'CHARGEBACK_REVERSED'. Acquisisci Registrato su `webhook` CHARGEBACK_REVERSED Tipo di evento explicit
	Chargeback Difeso	Sono state presentate prove ad Adyen per contestare un `chargeback`. Questo rappresenta un'`activity` di rilavorazione/manuale nel `flow` di contestazione.
Perché è importante Traccia lo sforzo speso per la protezione delle entrate. Importante per il 'Tasso di Rilavorazione dei Pagamenti'. Dove trovare Adyen Disputes API o `log` di `Case Management` che mostrano l'invio di prove. Acquisisci Inferito dal cambiamento di `status` in 'Defense Supplied' Tipo di evento inferred
	Erogazione Confermata	I fondi associati a un `batch` di transazioni regolate sono stati erogati al `bank account` dell'esercente.
Perché è importante Rappresenta il trasferimento di denaro effettivo all'attività, collegato a 'Tempo del Ciclo di Riconciliazione dei Pagamenti'. Dove trovare Adyen Notification Webhook: `eventCode` 'PAYOUT_THIRD_PARTY' o inferito dal Payout Report. Acquisisci Unire l'`ID` del `batch` del Payout Report all'`ID` della Transazione Tipo di evento inferred
	Errore Tecnico Registrato	Si è verificato un errore di sistema durante l'elaborazione, come un errore di `webhook` o un `API timeout`. Identificato tramite codici di errore specifici nell'interfaccia.
Perché è importante Supporta direttamente l'analisi del 'Tasso di Fallimento delle Transazioni di Pagamento' categorizzando i fallimenti tecnici rispetto a quelli finanziari. Dove trovare `Log` dell'interfaccia Adyen o risposte specifiche di errore nelle chiamate `API`. Acquisisci Registrato quando viene restituito il codice di risposta errore 5xx o 4xx Tipo di evento explicit
	Notifica di Chargeback Ricevuta	Adyen ha ricevuto una notifica di contestazione dal circuito della `card`. Questo innesca il `workflow` di contestazione.
Perché è importante Importante indicatore di Conformità e rischio. Alimenta il 'Tasso di Incidenti di Conformità' e richiede un intervento manuale immediato. Dove trovare Adyen Notification Webhook: `eventCode` 'CHARGEBACK' o 'NOTIFICATION_OF_CHARGEBACK'. Acquisisci Registrato su `webhook` CHARGEBACK Tipo di evento explicit
	Pagamento Annullato	L'autorizzazione è stata annullata prima che i fondi fossero acquisiti. Ciò rilascia i fondi riservati sulla carta dell'acquirente.
Perché è importante Rappresenta un ciclo di processo in cui un ordine valido viene terminato prima del completamento, spesso a causa della richiesta del cliente o di un timeout dell'inventario. Dove trovare Adyen Notification Webhook: `eventCode` 'CANCELLATION'. Acquisisci Registrato su `webhook` CANCELLATION Tipo di evento explicit
	Pagamento Inviato per la Liquidazione	Adyen ha inoltrato la transazione alla `bank` acquirente o alla `network` per l'elaborazione finanziaria. Lo `status` cambia in SentForSettlement.
Perché è importante Segna il passaggio dall'elaborazione operativa al `clearing` finanziario. Ritardi qui influenzano il `cash flow`. Dove trovare Adyen Transaction `Status API` o inferito dai `log` di cronologia delle modifiche di `status`. Acquisisci Confrontare la transizione del campo `status` a SentForSettlement Tipo di evento inferred
	Rimborso Avviato	È stata attivata una richiesta di restituzione dei fondi all'acquirente. Questo avvia un `flow` di processo inverso.
Perché è importante Indica un'eccezione post-regolamento. Tassi di `refund` elevati potrebbero indicare problemi di qualità a monte. Dove trovare Adyen Notification Webhook: `eventCode` 'REFUND'. Acquisisci Registrato all'attivazione del `webhook` REFUND Tipo di evento explicit
	Rimborso Liquidato	Il rimborso è stato elaborato finanziariamente e addebitato sul conto del commerciante. Confermato tramite il Rapporto Dettaglio Liquidazione.
Perché è importante Chiude il `loop` del processo di `refund`. Importante per il 'Tempo Medio di Risoluzione degli Errori' se il `refund` è stato causato da un errore. Dove trovare Adyen Settlement Detail Report, tipo di `record` 'Refunded' o 'RefundedReversed'. Acquisisci Registrato quando il `refund` appare nel Settlement Report Tipo di evento explicit
	Screening del Rischio Eseguito	Il motore RevenueProtect di Adyen analizza la transazione per individuare segnali di frode. Questo viene inferito dalla presenza di un `fraud score` o di un risultato di rischio nella risposta di autorizzazione.
Perché è importante Punteggi di rischio elevati possono innescare revisioni manuali o rifiuti automatici, creando colli di bottiglia o punti di terminazione del processo. Dove trovare Adyen Payment Response (campo `fraudResult`) o `log` di `Case Management`. Acquisisci Inferito dalla presenza dell'`object` `fraudResult` Tipo di evento inferred

Consigliato Facoltativo

Guide all'Estrazione

Come ottenere i vostri `dati` da Adyen

Fasi

Accedete all'Area Clienti Adyen con un account utente che ha il ruolo Merchant Report.
Navigate su Report e selezionate Dettagli di regolamento dal menu.
Individuate le impostazioni di Generazione automatica o scegliete Genera report per un'export una tantum.
Nel pannello di configurazione, assicuratevi che il Formato sia impostato su CSV (valori separati da virgola).
Sotto Includi colonne, assicuratevi di selezionare Tutte o di spuntare specificamente: Company Account, Merchant Account, Psp Reference, Merchant Reference, Payment Method, Creation Date, TimeZone, Type, Modification Reference, Gross Currency, Gross Debit, Gross Credit, Exchange Rate, Net Currency, Net Debit, Net Credit, Commission, Markup, Scheme Fees e Interchange.
IMPORTANTE: Assicuratevi che lo scope del report includa tutti i Tipi di Journal (Settled, Refunded, Chargeback, PaidOut, ecc.) per catturare l'intero ciclo di vita finanziario.
Generate il report per l'intervallo di date desiderato (ad es., Ultimi 90 giorni). Notate che i report di regolamento vengono generati in base alla data del batch di regolamento, non alla data della transazione.
Scaricate il file CSV generato nel vostro ambiente di estrazione locale.
Eseguite lo script di trasformazione (fornito di seguito) per rimodellare il ledger CSV 'Wide' in un formato Event Log 'Long' richiesto da ProcessMind.
Lo script esegue trasformazioni critiche: effettua l'unpivot della Creation Date per creare event di 'Richiesta di Pagamento Ricevuta' e mappa la colonna Type a specifiche activity finanziarie.
Verificate che l'output CSV contenga le intestazioni: PspReference, EventCode, EventDate, SourceSystem.
Caricate il CSV trasformato finale su ProcessMind.

Configurazione

Tipo di Report: Settlement Detail Report (registro finanziario)
Formato File: CSV (separazione standard tramite virgola)
Granularità: Livello di Transazione (una riga per ogni voce di journal finanziario)
Fuso Orario: UTC (fortemente consigliato per allineare l'estrazione con altri sistemi)
Intervallo Date: Si allinea con i Batch di Settlement (Data di Chiusura del Batch), non con la Data di Creazione della Transazione. Assicurarsi che la sovrapposizione sia gestita se l'esecuzione è incrementale.
Colonne Richieste: Psp Reference (Key), Type (Activity), Creation Date, Booking Date (Event Timestamp), Merchant Account.
Impostazioni Filtri: Assicurarsi che nessun filtro escluda i tipi 'Chargeback' o 'Refund' per garantire la completezza del processo.

a Query di Esempio config

import pandas as pd
from datetime import datetime

# CONFIGURATION
INPUT_FILE = 'settlement_detail_report.csv'
OUTPUT_FILE = 'adyen_event_log.csv'
SOURCE_SYSTEM = 'Adyen'

# Load the Adyen Settlement Detail Report
# Skip standard Adyen header rows if present (often reports start on row 1 or have metadata on top)
df = pd.read_csv(INPUT_FILE, keep_default_na=False)

# Define the output list
event_log = []

# Helper function to append events
def add_event(psp_ref, activity, timestamp, attributes):
    if not timestamp or str(timestamp).strip() == '':
        return
    base_event = {
        'PspReference': psp_ref,
        'EventCode': activity,
        'EventDate': timestamp,
        'SourceSystem': SOURCE_SYSTEM,
        'LastDataUpdate': datetime.utcnow().isoformat(),
        'MerchantAccount': attributes.get('Merchant Account', ''),
        'PaymentMethod': attributes.get('Payment Method', ''),
        'PaymentAmount': attributes.get('Gross Credit', 0) if attributes.get('Gross Credit') else attributes.get('Gross Debit', 0) * -1
    }
    # Merge optional attributes
    base_event.update(attributes)
    event_log.append(base_event)

# Iterate through the ledger rows
for index, row in df.iterrows():
    psp_ref = row.get('Psp Reference')
    journal_type = row.get('Type')
    creation_date = row.get('Creation Date') # Used for Auth/Request
    booking_date = row.get('Booking Date')   # Used for Settlement/Financials
    
    # Common attributes for this row
    row_attrs = {
        'MerchantAccount': row.get('Merchant Account'),
        'PaymentMethod': row.get('Payment Method'),
        'RefusalReason': row.get('Refusal Reason', ''),
        'PaymentStatus': journal_type
    }

    # --- 1. DERIVED UPSTREAM ACTIVITIES ---
    # Since this is a settlement report, we infer the Request/Auth from the Creation Date
    # of the first record we see for this PSP Reference. 
    # Logic: If Creation Date exists, implies Request and Auth occurred.
    
    if creation_date:
        # Activity: Payment Request Received
        add_event(psp_ref, 'Payment Request Received', creation_date, row_attrs)
        
        # Activity: Risk Screening Performed (Inferred from existence of transaction)
        # Note: True risk score requires 'Payments Accounting Report', inferred here for process continuity
        add_event(psp_ref, 'Risk Screening Performed', creation_date, row_attrs)
        
        # Activity: Payment Authorised
        # Typically happens immediately after request for successful settled items
        add_event(psp_ref, 'Payment Authorised', creation_date, row_attrs)

    # --- 2. MAPPED FINANCIAL ACTIVITIES ---
    # Map Adyen Ledger Types to Process Activities using Booking Date
    
    if journal_type == 'Settled':
        add_event(psp_ref, 'Payment Settled', booking_date, row_attrs)
        
        # Activity: Payment Sent for Settlement
        # Inferred: Occurs shortly before settlement. 
        # Using Creation Date if Booking Date is distinct, or defaulting to Booking Date.
        sent_date = creation_date if creation_date else booking_date
        add_event(psp_ref, 'Payment Sent for Settlement', sent_date, row_attrs)

    elif journal_type == 'Refunded':
        add_event(psp_ref, 'Refund Initiated', creation_date, row_attrs)
        add_event(psp_ref, 'Refund Settled', booking_date, row_attrs)

    elif journal_type == 'Chargeback':
        add_event(psp_ref, 'Chargeback Notification Received', booking_date, row_attrs)

    elif journal_type == 'ChargebackRetried':
        add_event(psp_ref, 'Chargeback Defended', booking_date, {'IsRework': 'True'})

    elif journal_type == 'ChargebackReversed':
        add_event(psp_ref, 'Chargeback Reversed', booking_date, row_attrs)

    elif journal_type == 'PaidOut':
        # Payouts often group many transactions. 
        # If the report is at transaction level, this row represents the batch payout.
        add_event(psp_ref, 'Payout Confirmed', booking_date, row_attrs)

    elif journal_type == 'CaptureFailed':
        add_event(psp_ref, 'Capture Failed', booking_date, {'IsRework': 'True'})

    # --- 3. EXCEPTION HANDLING ---
    # These statuses often appear in 'Received payment details' reports but rarely in Settlement
    # unless fees were applied.
    
    elif journal_type == 'Refused': 
        add_event(psp_ref, 'Payment Refused', creation_date, row_attrs)
        
    elif journal_type == 'Cancelled':
        add_event(psp_ref, 'Payment Cancelled', creation_date, row_attrs)

    elif journal_type == 'Error':
        add_event(psp_ref, 'Technical Error Logged', booking_date, {'IsRework': 'True'})

# Convert to DataFrame
events_df = pd.DataFrame(event_log)

# Deduping: Adyen reports may have multiple lines for partial settlements.
# We sort by date and keep unique Activity per PSP Reference if timestamps match exactly.
events_df.drop_duplicates(subset=['PspReference', 'EventCode', 'EventDate'], inplace=True)

# Output
events_df.to_csv(OUTPUT_FILE, index=False)
print(f'Successfully extracted {len(events_df)} events to {OUTPUT_FILE}')

Fasi

Configurazione dei Prerequisiti: Assicuratevi di avere un utente Adyen Report con il ruolo Merchant Report abilitato. Ottenete la vostra API Key dall'Area Clienti sotto Sviluppatori > Credenziali API.
Identificare i Report Richiesti: Questa estrazione si basa su due report CSV chiave generati da Adyen: il Settlement Detail Report (per event finanziari come Settlement, Chargeback, Refund) e il Received Payment Detail Report (per event operativi come Richieste, Rifiuti, Autorizzazioni).
Setup dell'Ambiente Python: Installate le librerie necessarie usando pip: pandas, requests e numpy. Queste verranno utilizzate per la comunicazione API e la trasformazione dei dati.
Implementazione della Connessione API: Configurate lo script Python (fornito di seguito) per autenticarsi agli endpoint https://management-test.adyen.com o https://management-live.adyen.com. Utilizzerete l'API di Report per elencare i report disponibili per il vostro specifico intervallo di date e scaricare gli URL.
Ingestione dei Dati: Lo script legge i dati CSV grezzi in DataFrame di pandas. I report Adyen sono tipicamente 'wide' (una riga per transazione con più colonne di status), quindi è richiesta una trasformazione.
Mappatura delle Attività - Operazionale: Elaborate il Received Payment Detail Report. Mappate la CreationDate a Richiesta di Pagamento Ricevuta. Usate la logica per ispezionare la colonna Status (es. Authorised, Refused, Error) per generare gli event Pagamento Autorizzato, Pagamento Rifiutato, o Errore Tecnico Registrato.
Mappatura delle Attività - Finanziaria: Elaborate il Settlement Detail Report. Questo report contiene una colonna JournalType. Mappate valori come Settled a Pagamento Regolato, Refunded a Rimborso Avviato, e Chargeback a Notifica di Chargeback Ricevuta.
Inferenza di Attività Complesse:
- Verifica Rischio Eseguita: Controllate se la colonna FraudScore è popolata e maggiore di -1.
- Payout Confermato: Collegate le transazioni tramite il BatchNumber alla voce Payout nel report di regolamento.
- Chargeback Difeso: Cercate i tipi di journal SecondChargeback o Defense.
Trasformazione dei Dati: Applicate un'operazione 'melt' o 'stack' in pandas per convertire il dataset ampio in un formato event log lungo dove ogni activity è una riga separata.
Standardizzazione degli Attributi: Rinominate le colonne per corrispondere allo schema di destinazione: PspReference, EventCode, EventDate, SourceSystem (hardcoded su 'Adyen') e PaymentAmount. Assicuratevi che le date siano analizzate in formato ISO 8601.
Filtro: Filtrate le righe di riconciliazione interna che non rappresentano passaggi di processo (ad es. righe di intestazione o riporti di saldo) utilizzando il filtro Type.
Esportazione Finale: Lo script esporta il DataFrame elaborato in un file CSV chiamato adyen_event_log.csv, pronto per l'upload su ProcessMind.

Configurazione

Ambiente API: Cambiare tra gli endpoint Adyen Test (management-test.adyen.com) e Live (management-live.adyen.com) in base alla fase di deployment.
Autenticazione: Utilizzare x-api-key nell'header. Non utilizzare Basic Auth per l'API di Management.
Tipi di Report:
- settlement_detail_report: Fondamentale per gli event del ciclo di vita finanziario.
- received_payment_detail_report: Fondamentale per la logica iniziale di richiesta e autorizzazione.
Intervallo Date: I report Adyen sono generati in base alla chiusura del batch. Assicurarsi che lo script richieda report che coprano la CreationDate di interesse + 7 giorni per acquisire i regolamenti ritardati.
Merchant Account Scope: Se si dispone di più merchant account, iterare l'elenco degli account o utilizzare il report a livello di Company Account, se disponibile.
Configurazione Pandas: Assicurarsi che low_memory=False sia impostato durante la lettura dei CSV se il volume delle transazioni supera le 100k righe per prevenire errori di inferenza del tipo.

a Query di Esempio python

import pandas as pd
import requests
import io
import numpy as np
from datetime import datetime

class=class="hl-string">"hl-comment"># Configuration
API_KEY = class="hl-string">'YOUR_ADYEN_API_KEY'
MERCHANT_ACCOUNT = class="hl-string">'YOUR_MERCHANT_ACCOUNT'
BASE_URL = class="hl-string">'https://management-live.adyen.com/v1'
HEADERS = {class="hl-string">'x-api-key': API_KEY, class="hl-string">'Content-Type': class="hl-string">'application/json'}

class=class="hl-string">"hl-comment"># Placeholder for fetching report URLs via API
class=class="hl-string">"hl-comment"># In production, use GET /companies/{companyId}/reports or /merchants/{merchantId}/reports
class=class="hl-string">"hl-comment"># For this script, we assume the CSV content is loaded into DataFrames

def transform_adyen_data(received_payments_csv_path, settlement_details_csv_path):
    
    class=class="hl-string">"hl-comment"># 1. Load Data
    print(class="hl-string">'Loading reports...')
    df_received = pd.read_csv(received_payments_csv_path)
    df_settled = pd.read_csv(settlement_details_csv_path)

    events = []

    class=class="hl-string">"hl-comment"># 2. Process Received Payment Detail Report (Operational Events)
    class=class="hl-string">"hl-comment"># This report covers: Request, Auth, Refusal, Risk, Capture, Errors
    
    for _, row in df_received.iterrows():
        psp = str(row.get(class="hl-string">'PspReference', class="hl-string">''))
        created_date = pd.to_datetime(row.get(class="hl-string">'CreationDate'))
        amount = row.get(class="hl-string">'Amount', 0)
        status = row.get(class="hl-string">'Status', class="hl-string">'')
        fraud_score = row.get(class="hl-string">'FraudScore', None)
        refusal_reason = row.get(class="hl-string">'RefusalReason', class="hl-string">'')
        
        class=class="hl-string">"hl-comment"># Activity: Payment Request Received
        events.append({
            class="hl-string">'PspReference': psp,
            class="hl-string">'EventCode': class="hl-string">'Payment Request Received',
            class="hl-string">'EventDate': created_date,
            class="hl-string">'PaymentAmount': amount,
            class="hl-string">'PaymentMethod': row.get(class="hl-string">'PaymentMethod', class="hl-string">''),
            class="hl-string">'RefusalReason': None,
            class="hl-string">'SourceSystem': class="hl-string">'Adyen'
        })

        class=class="hl-string">"hl-comment"># Activity: Risk Screening Performed
        class=class="hl-string">"hl-comment"># Inferred if a fraud score was calculated
        if pd.notna(fraud_score):
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Risk Screening Performed',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=1), class=class="hl-string">"hl-comment"># Slight offset
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

        class=class="hl-string">"hl-comment"># Activity: Payment Authorised / Refused / Error
        if status == class="hl-string">'Authorised':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Authorised',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Refused':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Refused',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'RefusalReason': refusal_reason,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Error':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Technical Error Logged',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=2),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'RefusalReason': row.get(class="hl-string">'AcquirerResponse', class="hl-string">'Technical Error'),
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })
        elif status == class="hl-string">'Cancelled':
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Cancelled',
                class="hl-string">'EventDate': created_date + pd.Timedelta(seconds=5),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

    class=class="hl-string">"hl-comment"># 3. Process Settlement Detail Report (Financial Events)
    class=class="hl-string">"hl-comment"># This report covers: Capture, Settlement, Refunds, Chargebacks, Payouts
    
    for _, row in df_settled.iterrows():
        psp = str(row.get(class="hl-string">'PspReference', class="hl-string">''))
        journal_type = row.get(class="hl-string">'JournalType', class="hl-string">'')
        process_date = pd.to_datetime(row.get(class="hl-string">'CreationDate')) class=class="hl-string">"hl-comment"># Or ProcessingDate
        amount = row.get(class="hl-string">'NetCredit', 0) if pd.notna(row.get(class="hl-string">'NetCredit')) else row.get(class="hl-string">'GrossCredit', 0)
        
        class=class="hl-string">"hl-comment"># Map JournalType to Activities
        activity_name = None
        
        if journal_type == class="hl-string">'SentForSettlement':
            activity_name = class="hl-string">'Payment Sent for Settlement'
        elif journal_type == class="hl-string">'Settled':
            activity_name = class="hl-string">'Payment Settled'
        elif journal_type == class="hl-string">'SentForRefund' or journal_type == class="hl-string">'Refunded':
            activity_name = class="hl-string">'Refund Initiated'
        elif journal_type == class="hl-string">'SettledRefund':
            activity_name = class="hl-string">'Refund Settled'
        elif journal_type == class="hl-string">'Chargeback':
            activity_name = class="hl-string">'Chargeback Notification Received'
        elif journal_type == class="hl-string">'SecondChargeback' or journal_type == class="hl-string">'Defense':
            activity_name = class="hl-string">'Chargeback Defended'
        elif journal_type == class="hl-string">'ChargebackReversed':
            activity_name = class="hl-string">'Chargeback Reversed'
        elif journal_type == class="hl-string">'CaptureFailed':
            activity_name = class="hl-string">'Capture Failed'
        elif journal_type == class="hl-string">'PaidOut':
            class=class="hl-string">"hl-comment"># PaidOut is usually batch level, if psp is present, map it
            activity_name = class="hl-string">'Payout Confirmed'
        
        class=class="hl-string">"hl-comment"># Logic for class="hl-string">'Payment Captured' 
        class=class="hl-string">"hl-comment"># Adyen often auto-captures. If we see Settled, we assume Captured occurred prior if not explicitly logged.
        class=class="hl-string">"hl-comment"># Here we rely on class="hl-string">'SentForSettlement' as the trigger for Capture success in many flows.
        if journal_type == class="hl-string">'SentForSettlement':
             events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': class="hl-string">'Payment Captured',
                class="hl-string">'EventDate': process_date - pd.Timedelta(seconds=1),
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen'
            })

        if activity_name:
            events.append({
                class="hl-string">'PspReference': psp,
                class="hl-string">'EventCode': activity_name,
                class="hl-string">'EventDate': process_date,
                class="hl-string">'PaymentAmount': amount,
                class="hl-string">'SourceSystem': class="hl-string">'Adyen',
                class="hl-string">'MerchantAccount': row.get(class="hl-string">'MerchantAccount', MERCHANT_ACCOUNT),
                class="hl-string">'PaymentMethod': row.get(class="hl-string">'PaymentMethod', class="hl-string">'')
            })

    class=class="hl-string">"hl-comment"># 4. Create DataFrame
    df_events = pd.DataFrame(events)
    
    class=class="hl-string">"hl-comment"># 5. Post-Processing & Cleanup
    if not df_events.empty:
        class=class="hl-string">"hl-comment"># Ensure standard columns
        df_events[class="hl-string">'LastDataUpdate'] = datetime.now().isoformat()
        df_events[class="hl-string">'TotalCycleTime'] = None class=class="hl-string">"hl-comment"># Calculated in ProcessMind
        df_events[class="hl-string">'IsRework'] = df_events[class="hl-string">'EventCode'].apply(lambda x: 1 if class="hl-string">'Chargeback' in x or class="hl-string">'Refused' in x else 0)
        df_events[class="hl-string">'PaymentStatus'] = df_events.sort_values(class="hl-string">'EventDate').groupby(class="hl-string">'PspReference')[class="hl-string">'EventCode'].transform(class="hl-string">'last')
        
        class=class="hl-string">"hl-comment"># Filter invalid rows (empty PspReference)
        df_events = df_events[df_events[class="hl-string">'PspReference'] != class="hl-string">'nan']
        df_events = df_events[df_events[class="hl-string">'PspReference'] != class="hl-string">'']

        class=class="hl-string">"hl-comment"># Sort
        df_events = df_events.sort_values([class="hl-string">'PspReference', class="hl-string">'EventDate'])
        
    return df_events

class=class="hl-string">"hl-comment"># Execution Entry Point
class=class="hl-string">"hl-comment"># Replace paths with actual file locations or API download streams
if __name__ == class="hl-string">'__main__':
    class=class="hl-string">"hl-comment"># Example usage
    df_log = transform_adyen_data(class="hl-string">'received_payment_detail_report.csv', class="hl-string">'settlement_detail_report.csv')
    
    class=class="hl-string">"hl-comment"># Export
    df_log.to_csv(class="hl-string">'ProcessMind_Adyen_Log.csv', index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">'Extraction Complete. Generated {len(df_log)} events.')

Il suo `template` di `dati` per l'elaborazione dei pagamenti

Il suo `template` di `dati` per l'elaborazione dei pagamenti

Attributi di Elaborazione dei Pagamenti

Attività di Elaborazione dei Pagamenti

Guide all'Estrazione

Esportazione Adyen Settlement Detail Report

Fasi

Configurazione

a Query di Esempio config

Estrazione Python tramite Reporting API

Fasi

Configurazione

a Query di Esempio python

Pronto per iniziare?

Sblocchi un'Elaborazione dei Pagamenti Senza Soluzione di Continuità in Adyen Oggi.

Il suo template di dati per l'elaborazione dei pagamenti

Il suo template di dati per l'elaborazione dei pagamenti

Attributi di Elaborazione dei Pagamenti

Attività di Elaborazione dei Pagamenti

Guide all'Estrazione

Esportazione Adyen Settlement Detail Report

Fasi

Configurazione

a Query di Esempio config

Estrazione Python tramite Reporting API

Fasi

Configurazione

a Query di Esempio python

Abbiamo a cuore la Sua privacy

Pronto per iniziare?

Sblocchi un'Elaborazione dei Pagamenti Senza Soluzione di Continuità in Adyen Oggi.

Il suo `template` di `dati` per l'elaborazione dei pagamenti

Il suo `template` di `dati` per l'elaborazione dei pagamenti