> Kontinuierliche Prozessoptimierung > Zahlungsabwicklung > Adyen > Datenvorlage

Your Payments Processing Data Template

Adyen

Zahlungsabwicklungs-Attribute (20) Zahlungsabwicklungs-Aktivitäten (16) Extraktionsleitfäden (2)

Your Payments Processing Data Template

Dieses Template provides a Comprehensive Guide for Collecting the Necessary Data to Analyze Your Payments Processing in Adyen. It outlines All Essential Data Attributes and Process Activities to Track, along with Practical Instructions for Data Extraction. Use this to Ensure You Capture All Critical Information for Effective Process Mining.

Empfohlene Attribute zur Erfassung
Wichtige Aktivitäten zur Verfolgung
Praktische Extraction Guidance für Adyen

Neu bei Event-Logs? Erfahren Sie wie Sie ein Process-Mining-Event-Log erstellen.

Vorlage herunterladen

Zahlungsabwicklungs-Attribute

These are the Recommended Data Fields to Include in Your Event Log for Comprehensive Analysis of Your Payments Processing within Adyen.

5 Erforderlich 7 Empfohlen 8 Optional

	Name	Beschreibung
	Aktivitätsname EventCode	The Specific Stage or Action occurring in the Payment Lifecycle.
Beschreibung Dieses Attribut definiert das spezifische Event, das aufgetreten ist, such as `AUTHORISATION`, `CAPTURE` oder `REFUND`. It dictates the Nodes in the Process Map and Determines the Flow of the Transaction. In Analysis, these Codes are Translated into Human-readable Activity Names to Visualize the Process Flow. Variations in the Sequence of These Codes indicate Different Process Paths, such as Straight-through Processing versus Exception Handling. Bedeutung Definiert das 'Was' des Process Mining-Modells und ermöglicht die Visualisierung von Prozessabläufen. Datenquelle Feld 'eventCode' der Adyen Notification Webhooks. Beispiele AUTHORISATIONCAPTUREREFUNDCANCELLATIONCHARGEBACK
	Ereignis-Timestamp EventDate	The Date and Time when the Specific Payment Activity occurred.
Beschreibung Dieses Attribut records the Precise Timestamp of when an Event (like Authorization or Settlement) was Logged in the System. It allows for the Chronological Ordering of Activities within a Case. In Analysis, this is Crucial for Calculating Cycle Times, Identifying Bottlenecks, and Determining the Throughput of the System over Time. It supports all Time-based KPIs such as 'Overall Payment Cycle Time'. Bedeutung Essentiell für die Reihenfolge der Events und die Berechnung aller dauerbasierten Metriken. Datenquelle Feld 'eventDate' der Adyen Notification Webhooks. Beispiele 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	Zahlungs-Transaktions-ID PspReference	The Unique Reference Identifier assigned by Adyen to Each Payment Transaction.
Beschreibung Dieses Attribut serves as the Primary Key for the Entire Payment Lifecycle within the Adyen Ecosystem. It links the Initial Payment Request to Subsequent Events such as Authorization, Capture, Settlement, and Potential Refunds or Chargebacks. In Analysis, this ID is Used to Group Discrete Events into a Single Case, enabling End-to-End Process Reconstruction. It allows Analysts to Track the Specific Journey of a Payment from the Shopper's Initiation to the Final Financial Settlement. Bedeutung Es ist die grundlegende Verknüpfung, die getrennte Events zu einer einzigen Prozessinstanz für das Mining gruppiert. Datenquelle Adyen Payment Response 'pspReference' oder Spalte 'PSP Reference' im Settlement Detail Report. Beispiele 851564567890123479145612345678908825641234567890
	Letzte Datenaktualisierung LastDataUpdate	Der Timestamp, wann der Datensatz zuletzt extrahiert oder aktualisiert wurde.
Beschreibung Dieses Attribut indicates the Freshness of the Data in the Process Mining Model. It helps Users understand if they are looking at Real-time Data or a Snapshot. In Analysis, this is Primarily a Technical Field used for Data Governance and Validating that the Pipeline is Running Correctly. Bedeutung Technical Field zu Track Data Freshness. Datenquelle Systemzeit zum Zeitpunkt der Extraktion. Beispiele 2023-10-30T12:00:00Z
	Quellsystem SourceSystem	Der Name des Systems, aus dem die `data` stammen.
Beschreibung This Static Attribute identifies that the Record came from Adyen. In Multi-System Process Mining (e.g., Combining Adyen with SAP), this is Crucial for Lineage. In Analysis, it allows Users to Filter Activities that Specifically Occurred within the Payment Gateway versus the ERP or Order Management System. Bedeutung Entscheidend für die Data Lineage im Multi-System Process Mining. Datenquelle Static Value during Extraction. Beispiele AdyenAdyen_Production
	Gesamtzahlungszykluszeit TotalCycleTime	The Total Duration from Payment Request Creation to Settlement.
Beschreibung Dies ist eine Calculated Metric measuring the Time Elapsed between the Very First Event (e.g., 'Payment Request Received') and the 'Payment Settled' Event. In Analysis, this is the Primary Efficiency KPI. It highlights the Speed of Cash Flow. Long Cycle Times might Indicate Issues with Capture Delays or Settlement Cycles. Bedeutung KPI für die Working Capital-Optimierung. Datenquelle Berechnet: Timestamp(Settled) - Timestamp(Created). Beispiele 2 Tage4 Stunden5 Minuten
	Händlerkonto MerchantAccount	The Specific Merchant Account within Adyen Processing the Transaction.
Beschreibung Adyen ermöglicht mehrere Händlerkonten unter einem einzigen Firmenkonto. Dieses Attribut identifiziert, welche spezifische Geschäftseinheit, Marke oder regionale Entität die Zahlung verarbeitet hat. In der Analyse dient dies als primäre Dimension für die Segmentierung. Es ermöglicht Stakeholdern, die Performance, Fehlerraten und Volumina über verschiedene Geschäftseinheiten oder Marken hinweg zu vergleichen, um spezifische Verbesserungsbereiche zu identifizieren. Bedeutung Schlüssel zur Segmentierung der Performance nach Geschäftseinheit oder Tochtergesellschaft. Datenquelle Adyen Payment Request/Response 'merchantAccount'. Beispiele MyStore_UKMyStore_USGlobalSales_Main
	Ist Nacharbeit IsRework	Flag, das anzeigt, ob die Transaktion Wiederholungsversuche oder Fehlerkorrekturen beinhaltete.
Beschreibung Ein Boolesches Flag, das 'true' ist, wenn der Case mehrere Autorisierungsversuche oder Aktivitäten wie 'Zahlung abgelehnt' gefolgt von einem erneuten Versuch enthält. In der Analyse speist dies das Dashboard 'Hotspots für Zahlungsnachbearbeitung und Ausnahmen'. Es ermöglicht Analysten, gezielt nach problematischen Cases zu filtern, um zu verstehen, warum Prozessabläufe nicht dem 'Happy Path' folgen. Bedeutung Identifiziert ineffiziente Cases, die manuelle oder Systeminterventionen erfordern. Datenquelle Berechnet basierend auf dem Auftreten von Fehler-Events > 0. Beispiele truefalsch
	Refusal Reason RefusalReason	The Text Description explaining why a Payment was Refused or Failed.
Beschreibung When a Transaction Fails, Adyen provides a Reason Code or Description (e.g., 'Not enough balance', 'CVC Declined', 'Expired Card'). In Analysis, this is the Primary Driver for the 'Payment Transaction Failure Rate' Dashboard. Analyzing These Reasons helps Identify whether Failures are due to Technical Issues, Fraud Rules, or Shopper Behavior, guiding Specific Remediation Actions. Bedeutung The Key Attribute for Root Cause Analysis of Failed Payments. Datenquelle Adyen Payment Response 'refusalReason'. Beispiele AbgelehntUngenügendes GuthabenAbgelaufene KarteAcquirer-FehlerBetrug
	Transaktionsbetrag PaymentAmount	The Monetary Value of the Payment Transaction.
Beschreibung Dieses Attribut represents the Financial Value associated with the Transaction. It is usually Stored as a Minor Unit (e.g., Cents) in the Raw Data but should be Converted for Reporting. In Analysis, this enables the 'Payment Throughput' Dashboard and helps Prioritize High-Value Rework Cases. It is also Used to Calculate the Total Volume Processed and Financial Impact of Failed Transactions. Bedeutung Notwendig für die Analyse der finanziellen Auswirkungen und das Durchsatz-Monitoring. Datenquelle Adyen Payment Request 'amount.value'. Beispiele 10005509900
	Zahlungsmethode PaymentMethod	The Specific Method used by the Shopper to Pay, such as Visa or PayPal.
Beschreibung Dieses Attribut erfasst die Art des verwendeten Payment Instrument, including Credit Card Brands (Visa, MC), Digital Wallets (PayPal, Apple Pay), or Local Payment Methods (iDEAL, Sofort). In Analysis, this is Vital for the 'Payment Method Performance Erkenntnisse' Dashboard. It helps Correlations between Specific Payment Methods and Authorization Rates, Processing Speeds, or Technical Failures. Bedeutung Entscheidend für die Analyse von Erfolgsquoten und Kosten über verschiedene Zahlungsanbieter hinweg. Datenquelle Adyen Payment Response 'paymentMethod.brand' oder 'paymentMethod.type'. Beispiele visamcpaypalidealklarna
	Zahlungsstatus PaymentStatus	The Current State of the Payment (e.g., Authorised, Settled, Refused).
Beschreibung Dieses Attribut reflects the Latest Known Status of the Payment Transaction. It is often Derived from the Most Recent Activity in the Case. In Analysis, it allows for Quick Filtering of Cases (e.g., 'Show me all currently Refused payments'). It is Essential for the 'Payment Throughput and Status Monitoring' Dashboard. Bedeutung Provides a Snapshot of the Current Health of the Transaction. Datenquelle Abgeleitet vom letzten Event Code im Case. Beispiele BeglichenAbgelehntAuthorisiert
	Acquirer-Referenz AcquirerReference	Reference Number provided by the Acquiring Bank.
Beschreibung This is the External Reference assigned by the Underlying Financial Institution (Acquirer) that Processes the Card Transaction. It is Distinct from the Adyen PSP Reference. In Analysis, this Field is Critical for the 'Payment Reconciliation Delay Analysis'. It is the Key used to Match Adyen Records against Bank Statements in External Ledgers. Bedeutung Essentiell für den 3-Wege-Abgleich und die externe Abstimmung. Datenquelle Adyen Payment Response 'additionalData.acquirerReference'. Beispiele 1234567890987654321
	Auth-Code AuthorisationCode	The Authorization Code returned by the Issuer upon Approval.
Beschreibung Ein Code, der anzeigt, dass die Gelder auf der Karte des Käufers reserviert wurden. Dies ist der Nachweis einer erfolgreichen Autorisierung. In der Analyse dient dies primär der Prüfung und Nachvollziehbarkeit. Es bestätigt, dass die Aktivität 'Zahlung autorisiert' legitim war. Bedeutung Proof of Successful Authorization for Audit Trails. Datenquelle Adyen Payment Response 'authCode'. Beispiele 123456098712
	Betrugsrisiko-Score RiskScore	The Risk Score assigned to the Transaction by the Fraud Engine.
Beschreibung Die RevenueProtect-Engine von Adyen weist einen numerischen Score (0-100) zu, der die Wahrscheinlichkeit von Betrug anzeigt. Höhere Scores lösen oft eine manuelle Überprüfung oder automatische Blockierung aus. In der Analyse unterstützt dies den 'Financial Compliance Risk Overview'. Das Korrelieren hoher Risikoscores mit Chargebacks hilft, die Betrugsregeln anzupassen. Hohe Scores, die zu erfolgreichen Zahlungen führen, könnten falsch positive Ergebnisse im Risikomodell anzeigen. Bedeutung Essentiell für die Analyse der Effizienz der Betrugspräventionslogik. Datenquelle Adyen Risk API-Antwort oder Reporting 'fraudResult.accountScore'. Beispiele 025100
	Kunden-ID ShopperReference	Eine eindeutige Referenz zur Identifizierung des Käufers über mehrere Transaktionen hinweg.
Beschreibung Dieser Identifier links Different Transactions to the Same Customer Entity. It is Provided by the Merchant during the Payment Request. In Analysis, this allows for a Customer-centric Analysis, enabling the Detection of Repeat Offenders in Fraud Cases or Loyal Customers in Successful Transaction Analysis. It facilitates the 'Customer' Generic Mapping. Bedeutung Ermöglicht kundenbezogene Aggregation und Verhaltensanalyse. Datenquelle Adyen Payment Request 'shopperReference'. Beispiele CUST-001user_12345email@example.com
	Settlement Batch Number BatchNumber	The Batch Number associated with the Settlement of Funds.
Beschreibung Adyen gruppiert abgerechnete Zahlungen in Batches zur Auszahlung. Dieses Attribut identifiziert, zu welchem Batch eine spezifische Transaktion gehört. In der Analyse wird dies verwendet, um Zahlungen nach ihrem Auszahlungszyklus zu gruppieren. Es hilft bei der Prüfung, ob bestimmte Batches verzögert sind, und unterstützt die Nachverfolgung der Aktivität 'Zahlung abgerechnet'. Bedeutung Verknüpft einzelne Transaktionen mit Sammel-Finanzabrechnungen. Datenquelle Adyen Settlement Detail Report 'Batch Number'. Beispiele 100255
	Shopper Country ShopperCountry	The Two-Letter Country Code of the Shopper.
Beschreibung Dieses Attribut indicates the Location of the Shopper, typically Derived from the Card Issuing Country or Billing Address. In Analysis, it is Used for Regional Performance Analysis. It helps Identify if Specific Countries have Higher Decline Rates or Slower Processing Times due to Local Banking Infrastructure. Bedeutung Ermöglicht die geografische Segmentierung der Zahlungsperformance. Datenquelle Adyen Payment Request 'countryCode' oder 'billingAddress.country'. Beispiele NLUSDE
	Shopper Interaction Type ShopperInteraction	Zeigt an, ob die Zahlung E-Commerce, POS oder ein Abonnement (ContAuth) war.
Beschreibung Dieses Attribut kategorisiert die Nature of the Interaction between the Shopper and the Merchant. Typical Values sind `Ecommerce` (online), `POS` (im Geschäft) oder `ContAuth` (wiederkehrend/Abonnement). In Analysis, this helps Distinguish between Different Business Models and Sales Channels. Process Flows often Differ Significantly between POS and Ecommerce, making this a Vital Filter for Clean Process Discovery. Bedeutung Unterscheidet Prozessabläufe zwischen Online-, In-Store- und wiederkehrenden Zahlungen. Datenquelle Adyen Payment Request 'shopperInteraction'. Beispiele E-CommerceContAuthPOSMoto
	Währung PaymentCurrency	The Three-Letter ISO Code denoting the Currency of the Transaction.
Beschreibung Dieses Attribut definiert die Currency, in der der `PaymentAmount` ausgedrückt wird. Common Values include EUR, USD, GBP, etc. In Analysis, this is Used to Group Transactions by Market and is Essential for Normalizing Financial Values when Aggregating Data across Different Regions. Bedeutung Kontextualisiert das Betragsfeld für die Mehrwährungsberichterstattung. Datenquelle Adyen Payment Request 'amount.currency'. Beispiele EURUSDGBP

Erforderlich Empfohlen Optional

Zahlungsabwicklungs-Aktivitäten

These are the Key Process Steps and Milestones zu Capture in Your Event Log for Accurate Process Discovery in Your Adyen Payments Flows.

5 Empfohlen 11 Optional

	Aktivität	Beschreibung
	Zahlung abgelehnt	The Transaction was Declined by the Issuer or Adyen's Risk Rules. Captured via the Authorization Webhook with a Failure Status.
Bedeutung Wirkt sich direkt auf den KPI 'Payment Transaction Failure Rate' aus. Die Analyse von Ablehnungsgründen hilft, die Autorisierungsraten zu optimieren. Datenquelle Adyen Notification Webhook: eventCode 'AUTHORISATION' mit success='false'. Erfassen Protokolliert bei AUTHORISATION Webhook-Fehler Ereignistyp explicit
	Zahlung autorisiert	The Card Issuer or Payment Method has Approved the Transaction and Funds are Reserved. Captured via the Standard Adyen Notification Webhook.
Bedeutung Ein entscheidender Meilenstein, der anzeigt, dass die Transaktion gültig ist und die Gelder verfügbar sind. Voraussetzung für die Erfassung (Capture). Datenquelle Adyen Notification Webhook: eventCode 'AUTHORISATION' mit success='true'. Erfassen Protokolliert bei AUTHORISATION Webhook-Erfolg Ereignistyp explicit
	Zahlung beglichen	Gelder wurden erfolgreich verrechnet und dem Adyen-Konto des Händlers gutgeschrieben. Dies erscheint im Settlement Detail Report.
Bedeutung The Financial Conclusion of the Successful Process. Essential for 'Overall Payment Cycle Time' und 'Payment Reconciliation Delay Analysis'. Datenquelle Adyen Settlement Detail Report (SDR), Datensatztyp 'Settled'. Erfassen Protokolliert, wenn Transaktion im Settlement Report erscheint Ereignistyp explicit
	Zahlung erfasst	The Command to Transfer Funds from the Shopper to the Merchant has been Successfully Processed. This can be Immediate (Auto-Capture) oder Delayed (Manual Capture).
Bedeutung Bestätigt die Umsatzrealisierung. Die Zeit zwischen Autorisierung und Capture ist entscheidend für den KPI 'Payment Authorization Lead Time'. Datenquelle Adyen Notification Webhook: eventCode 'CAPTURE' mit success='true'. Erfassen Protokolliert bei CAPTURE Webhook-Erfolg Ereignistyp explicit
	Zahlungsanfrage erhalten	The Initial Receipt of the Transaction Request by the Adyen Payment Platform. This is Captured from the Initial API Request Timestamp or the Creation of the pspReference.
Bedeutung Markiert den absoluten Start der Prozessinstanz. Essentiell für die Berechnung der gesamten End-to-End-Zykluszeit. Datenquelle Adyen Payment API-Protokolle oder der `Timestamp`, der der Erstellung der pspReference zugeordnet ist. Erfassen Protokolliert, wenn pspReference über API generiert wird Ereignistyp explicit
	Auszahlung bestätigt	Gelder, die mit einem Batch abgerechneter Transaktionen verbunden sind, wurden auf das Bankkonto des Händlers ausgezahlt.
Bedeutung Represents the Actual Cash Transfer to the Business, linked zu 'Payment Reconciliation Cycle Time'. Datenquelle Adyen Notification Webhook: eventCode 'PAYOUT_THIRD_PARTY' oder aus dem Payout Report abgeleitet. Erfassen Verbinden Sie die Batch-ID des Payout Report mit der Transaktions-ID Ereignistyp inferred
	Capture fehlgeschlagen	The Attempt to Capture Authorized Funds Failed, often due to Technical Timeout or Card Status Changes between Auth and Capture.
Bedeutung Kritischer Fehlerpunkt, der Nachbearbeitung oder einen erneuten Versuch erfordert. Trägt zur 'Payment Exception Rate' bei. Datenquelle Adyen Notification Webhook: eventCode 'CAPTURE_FAILED'. Erfassen Protokolliert bei CAPTURE_FAILED Webhook Ereignistyp explicit
	Chargeback rückgängig gemacht	The Dispute was Won, and Funds are Returned to the Merchant. This is a Successful Resolution of an Exception.
Bedeutung Positives Outcome für das Risk Management. Offsets den Financial Impact des initialen Chargeback. Datenquelle Adyen Notification Webhook: eventCode 'CHARGEBACK_REVERSED'. Erfassen Protokolliert bei CHARGEBACK_REVERSED Webhook Ereignistyp explicit
	Chargeback verteidigt	Nachweise wurden bei Adyen eingereicht, um einen Chargeback anzufechten. Dies stellt eine Nachbearbeitung/manuelle Aktivität im Dispute Flow dar.
Bedeutung Tracks the Effort Spent on Revenue Protection. Important for 'Payment Rework Rate'. Datenquelle Adyen Disputes API oder Case Management-Protokolle, die die Übermittlung von Nachweisen zeigen. Erfassen Abgeleitet aus der Statusänderung zu 'Defense Supplied' Ereignistyp inferred
	Chargeback-Benachrichtigung erhalten	Adyen hat eine Streitfallbenachrichtigung vom Kartensystem erhalten. Dies löst den Dispute Workflow aus.
Bedeutung Wichtiger Compliance- und Risikoindikator. Speist die 'Compliance Incident Rate' und erfordert sofortige manuelle Intervention. Datenquelle Adyen Notification Webhook: eventCode 'CHARGEBACK' oder 'NOTIFICATION_OF_CHARGEBACK'. Erfassen Protokolliert bei CHARGEBACK Webhook Ereignistyp explicit
	Refund Initiated	Eine Anforderung zur Rückerstattung von Geldern an den Käufer wurde ausgelöst. Dies startet einen umgekehrten Prozessfluss.
Bedeutung Zeigt eine Nachabwicklungs-Ausnahme an. Hohe Refund-Raten können auf vorgelagerte Qualitätsprobleme hinweisen. Datenquelle Adyen Notification Webhook: eventCode 'REFUND'. Erfassen Protokolliert bei REFUND Webhook-Auslösung Ereignistyp explicit
	Refund Settled	The Refund has been Processed Financially and Debited from the Merchant Account. Confirmed via the Settlement Detail Report.
Bedeutung Schließt den Kreis des Refund-Prozesses. Wichtig für die 'Durchschnittliche Fehlerbehebungszeit', wenn die Rückerstattung aufgrund eines Fehlers erfolgte. Datenquelle Adyen Settlement Detail Report, Datensatztyp 'Refunded' oder 'RefundedReversed'. Erfassen Protokolliert, wenn Refund im Settlement Report erscheint Ereignistyp explicit
	Risk Screening Performed	Die RevenueProtect-Engine von Adyen analysiert die Transaktion auf Betrugssignale. Dies wird aus dem Vorhandensein eines Fraud Score oder Risikoresultats in der Autorisierungsantwort abgeleitet.
Bedeutung Hohe Risikoscores können manuelle Überprüfungen oder automatische Ablehnungen auslösen und so Engpässe oder Prozessendpunkte schaffen. Datenquelle Adyen Payment Response (Feld fraudResult) oder Case Management-Protokolle. Erfassen Abgeleitet aus dem Vorhandensein des fraudResult-Objekts Ereignistyp inferred
	Technical Error Logged	Während der Verarbeitung ist ein Systemfehler aufgetreten, z. B. ein Webhook-Fehler oder ein API-Timeout. Identifiziert durch spezifische Fehlercodes in der Oberfläche.
Bedeutung Unterstützt direkt die Analyse der 'Payment Transaction Failure Rate' durch Kategorisierung von technischen vs. finanziellen Fehlern. Datenquelle Adyen-Interface-Protokolle oder spezifische Fehlermeldungen bei API-Aufrufen. Erfassen Protokolliert, wenn Fehler-Antwortcode 5xx oder 4xx zurückgegeben wird Ereignistyp explicit
	Zahlung storniert	The Authorization was Voided before Funds were Captured. This Releases the Reserved Funds on the Shopper's Card.
Bedeutung Represents a Process Loop where a Valid Order is Terminated before Completion, often due to Customer Request or Inventory Timeout. Datenquelle Adyen Notification Webhook: eventCode 'CANCELLATION'. Erfassen Protokolliert bei CANCELLATION Webhook Ereignistyp explicit
	Zahlung zur Abrechnung gesendet	Adyen hat die Transaktion zur Finanzverarbeitung an die Acquirer-Bank oder das Netzwerk weitergeleitet. Der Status ändert sich zu SentForSettlement.
Bedeutung Markiert den Übergang von der operativen Verarbeitung zur finanziellen Verrechnung. Verzögerungen hier wirken sich auf den Cashflow aus. Datenquelle Adyen Transaction Status API oder abgeleitet aus Statusänderungs-Historienprotokollen. Erfassen Vergleichen Sie den Übergang des Statusfeldes zu SentForSettlement Ereignistyp inferred

Extraktionsleitfäden

So erhalten Sie Ihre Daten von Adyen

Schritte

Melden Sie sich im Adyen Customer Area mit einem Benutzerkonto an, das über die Rolle Merchant Report verfügt.
Navigieren Sie zu Reports und wählen Sie Settlement details aus dem Menü.
Suchen Sie die Einstellungen für die Automatic generation oder wählen Sie Generate report für einen einmaligen Export.
Stellen Sie im Konfigurationspanel sicher, dass das Format auf CSV (kommagetrennte Werte) eingestellt ist.
Stellen Sie unter Include columns sicher, dass Sie All wählen oder explizit folgende Spalten aktivieren: 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 und Interchange.
WICHTIG: Stellen Sie sicher, dass der Berichtsumfang alle Journal Types (Settled, Refunded, Chargeback, PaidOut usw.) umfasst, um den gesamten finanziellen Lebenszyklus abzubilden.
Erstellen Sie den Bericht für den gewünschten Zeitraum (z. B. letzte 90 Tage). Beachten Sie, dass Settlement-Berichte auf Basis des Settlement-Batch-Datums generiert werden, nicht nach dem Transaktionsdatum.
Laden Sie die erzeugte CSV-Datei in Ihre lokale Extraktionsumgebung herunter.
Führen Sie das Transformation-Skript (unten bereitgestellt) aus, um das „breite“ CSV-Journal in das für ProcessMind erforderliche „lange“ Event-Log-Format umzuwandeln.
Das Skript führt wichtige Transformationen durch: Es entpivotisiert das Creation Date, um „Payment Request Received“-Events zu erstellen, und ordnet die Spalte Type spezifischen Finanzaktivitäten zu.
Überprüfen Sie, ob die ausgegebene CSV die Header PspReference, EventCode, EventDate und SourceSystem enthält.
Laden Sie die finale, transformierte CSV-Datei in ProcessMind hoch.

Konfiguration

Report Type: Settlement Detail Report (Finanzbuchhaltung)
File Format: CSV (Standard-Kommatrennung)
Granularity: Transaktionsebene (eine Zeile pro Finanzbuchungssatz)
Timezone: UTC (dringend empfohlen, um die Extraktion mit anderen Systemen abzugleichen)
Date Range: Orientiert sich an den Abrechnungschargen (Batch Closed Date), nicht am Erstellungsdatum der Transaktion. Stellen Sie sicher, dass Überlappungen bei inkrementellen Durchläufen berücksichtigt werden.
Required Columns: Psp Reference (Key), Type (Activity), Creation Date, Booking Date (Event-Zeitstempel), Merchant Account.
Filter Settings: Vergewissern Sie sich, dass keine Filter die Typen „Chargeback“ oder „Refund“ ausschließen, um die Prozessvollständigkeit zu gewährleisten.

a Beispielabfrage 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}')

Schritte

Voraussetzungen konfigurieren: Stellen Sie sicher, dass Sie einen Adyen-Berichtsbenutzer mit der Rolle Merchant Report haben. Rufen Sie Ihren API Key im Customer Area unter Developers > API Credentials ab.
Benötigte Berichte identifizieren: Diese Extraktion basiert auf zwei wichtigen CSV-Berichten von Adyen: dem Settlement Detail Report (für finanzielle Ereignisse wie Settlement, Chargebacks, Refunds) und dem Received Payment Detail Report (für operative Ereignisse wie Requests, Refusals, Authorizations).
Einrichtung der Python-Umgebung: Installieren Sie die erforderlichen Bibliotheken via pip: pandas, requests und numpy. Diese werden für die API-Kommunikation und Datentransformation verwendet.
Implementierung der API-Verbindung: Konfigurieren Sie das unten stehende Python-Skript für die Authentifizierung an den Endpunkten https://management-test.adyen.com oder https://management-live.adyen.com. Verwenden Sie die Report-API, um verfügbare Berichte für Ihren Zeitraum aufzulisten und die URLs herunterzuladen.
Datenaufnahme: Das Skript liest die CSV-Rohdaten in pandas DataFrames ein. Adyen-Berichte sind typischerweise im „Wide“-Format (eine Zeile pro Transaktion mit mehreren Statusspalten), daher ist eine Transformation erforderlich.
Activity Mapping - Operativ: Verarbeiten Sie den Received Payment Detail Report. Ordnen Sie das CreationDate dem Event Payment Request Received zu. Nutzen Sie Logik, um die Spalte Status (z. B. Authorised, Refused, Error) zu prüfen und Events wie Payment Authorised, Payment Refused oder Technical Error Logged zu generieren.
Activity Mapping - Finanziell: Verarbeiten Sie den Settlement Detail Report. Dieser Bericht enthält eine Spalte JournalType. Ordnen Sie Werte wie Settled dem Event Payment Settled zu, Refunded dem Event Refund Initiated und Chargeback dem Event Chargeback Notification Received.
Ableitung komplexer Aktivitäten:
- Risk Screening Performed: Prüfen Sie, ob die Spalte FraudScore befüllt und größer als -1 ist.
- Payout Confirmed: Verknüpfen Sie Transaktionen über die BatchNumber mit dem Payout-Eintrag im Settlement-Bericht.
- Chargeback Defended: Suchen Sie nach den Journal-Typen SecondChargeback oder Defense.
Datentransformation: Wenden Sie eine „Melt“- oder „Stack“-Operation in pandas an, um den breiten Datensatz in ein langes Event-Log-Format zu konvertieren, bei dem jede Aktivität eine eigene Zeile darstellt.
Standardisierung der Attribute: Benennen Sie die Spalten entsprechend dem Zielschema um: PspReference, EventCode, EventDate, SourceSystem (festgelegt auf „Adyen“) und PaymentAmount. Stellen Sie sicher, dass Daten im ISO 8601 Format vorliegen.
Filterung: Filtern Sie interne Abstimmungszeilen heraus, die keine Prozessschritte darstellen (z. B. Kopfzeilen oder Saldovorträge), indem Sie den Type-Filter nutzen.
Abschließender Export: Das Skript exportiert den verarbeiteten DataFrame in eine CSV-Datei namens adyen_event_log.csv, die für den Upload in ProcessMind bereit ist.

Konfiguration

API Environment: Wechseln Sie je nach Deployment-Phase zwischen den Adyen-Endpunkten Test (management-test.adyen.com) und Live (management-live.adyen.com).
Authentication: Verwenden Sie x-api-key im Header. Nutzen Sie für die Management-API keine Basic Auth.
Report Types:
- settlement_detail_report: Entscheidend für finanzielle Lifecycle-Events.
- received_payment_detail_report: Entscheidend für die ursprüngliche Anfrage und Autorisierungslogik.
Date Range: Adyen-Berichte werden basierend auf dem Batch-Abschluss erstellt. Stellen Sie sicher, dass das Skript Berichte anfordert, die das relevante CreationDate plus 7 Tage abdecken, um verzögerte Abrechnungen zu erfassen.
Merchant Account Scope: Wenn Sie mehrere Händlerkonten besitzen, iterieren Sie durch die Liste der Konten oder nutzen Sie den Bericht auf Unternehmenskonto-Ebene (Company Account), falls verfügbar.
Pandas Configuration: Stellen Sie sicher, dass beim Lesen von CSV-Dateien low_memory=False gesetzt ist, falls das Transaktionsvolumen 100.000 Zeilen überschreitet, um Fehler bei der Typ-Inferenz zu vermeiden.

a Beispielabfrage 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.')

Your Payments Processing Data Template

Your Payments Processing Data Template

Zahlungsabwicklungs-Attribute

Zahlungsabwicklungs-Aktivitäten

Extraktionsleitfäden

Export des Adyen Settlement Detail Report

Schritte

Konfiguration

a Beispielabfrage config

Python Extraction via Reporting API

Schritte

Konfiguration

a Beispielabfrage python

Bereit, um loszulegen?

Unlock Seamless Payments Processing in Adyen Today.

Your Payments Processing Data Template

Your Payments Processing Data Template

Zahlungsabwicklungs-Attribute

Zahlungsabwicklungs-Aktivitäten

Extraktionsleitfäden

Export des Adyen Settlement Detail Report

Schritte

Konfiguration

a Beispielabfrage config

Python Extraction via Reporting API

Schritte

Konfiguration

a Beispielabfrage python

Ihre Privatsphäre ist uns wichtig

Bereit, um loszulegen?

Unlock Seamless Payments Processing in Adyen Today.