> Kontinuierliche Prozessoptimierung > Zahlungsabwicklung > Adyen > Datenvorlage

Ihr Template für ZahlungsabwicklungsDaten

Adyen

Zahlungsabwicklungs-Attribute (19) Zahlungsabwicklungs-Aktivitäten (16) Extraktionsanleitungen (2)

Ihr Template für ZahlungsabwicklungsDaten

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

Empfohlene Attribute zur Erfassung
Wichtige Aktivitäten für das Tracking
Praktische Extraktion 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 Daten Fields to Include in Your Event Log for Comprehensive Analysis of Your Payments Processing within Adyen.

5 Erforderlich 6 Empfohlen 8 Optional

	Name	Beschreibung
	Aktivitätsname EventCode	The Specific Stage or Action occurring in the Payment Lebenszyklus.
Beschreibung Dieses Attribut definiert das spezifische Event, das aufgetreten ist, such as `AUTHORISATION`, `CAPTURE` oder `REFUND`. It dictates the Knoten in the Prozessdarstellung (Process Map) and Determines the Flow of the Transaction. In Analysis, these Codes are Translated into Human-readable Aktivitätsnames to Visualize the Prozessfluss. Variations in the Sequence of These Codes indicate Different Prozesspfade, 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-Zeitstempel EventDate	Datum und Uhrzeit der jeweiligen Zahlungsaktivität.
Beschreibung Dieses Attribut records the Precise Zeitstempel of when an Event (like Authorization or Settlement) was Logged in the System. It allows for the Chronological Ordering of Aktivitäten within a Case. In Analysis, this is wichtig für die Berechnung von Durchlaufzeits, Identifying Engpässe, and Determining the Throughput of the System over Time. It supports all zeitbasierte KPIs such as 'Overall Payment Durchlaufzeit'. Bedeutung Essentiell für die Reihenfolge der Ereignisse und die Berechnung aller zeitbasierten Kennzahlen. 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
	Zahlungstransaktions-ID PspReference	Die eindeutige Referenz-ID, die Adyen jeder Zahlungstransaktion zuweist.
Beschreibung Dieses Attribut serves as the Primary Key for the Entire Payment Lebenszyklus within the Adyen Ecosystem. It links the Initial Payment Request to Subsequent Ereignisse such as Authorization, Capture, Settlement, and Potential Refunds or Chargebacks. In Analysis, this ID is Used to Group Discrete Ereignisse 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 Ereignisse 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 Zeitstempel, wann der Datensatz zuletzt extrahiert oder aktualisiert wurde.
Beschreibung Dieses Attribut indicates the Freshness of the Daten in the Process Mining Model. It helps Nutzer understand if they are looking at Real-time Daten or a Momentaufnahme. In Analysis, this is Primarily a Technical Field used for Daten Governance and Validating that the Pipeline is Running Correctly. Bedeutung Technical Field zu Track Daten Freshness. Datenquelle Systemzeit zum Zeitpunkt der Extraktion. Beispiele 2023-10-30T12:00:00Z
	Quellsystem SourceSystem	Der Name des Systems, aus dem die Daten stammen.
Beschreibung This Statusc Attribute identifies that the Datensatz came from Adyen. In Multi-System Process Mining (e.g., Combining Adyen with SAP), this is Crucial for Lineage. In Analysis, it allows Nutzer to Filter Aktivitäten that Specifically Occurred within the Payment Gateway versus the ERP or Auftragsmanagement System. Bedeutung Wesentlich für die Daten Lineage im Multi-System Process Mining. Datenquelle Statusc Value during Extraktion. Beispiele AdyenAdyen_Production
	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 Leistungsfähigkeit, Fehlerraten und Volumina über verschiedene Geschäftseinheiten oder Marken hinweg zu vergleichen, um spezifische Verbesserungsbereiche zu identifizieren. Bedeutung Schlüssel zur Segmentierung der Leistungsfähigkeit 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 'Ja' 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 Fälle zu filtern, um zu verstehen, warum Prozessabläufe nicht dem 'Happy Path' folgen. Bedeutung Identifiziert ineffiziente Fälle, die manuelle oder Systeminterventionen erfordern. Datenquelle Berechnet basierend auf dem Auftreten von Fehler-Ereignisse > 0. Beispiele JaNein
	Refusal Reason RefusalReason	Die Textbeschreibung, die erklärt, warum eine Zahlung abgelehnt wurde oder fehlgeschlagen ist.
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 Ursachenanalyse of Failed Payments. Datenquelle Adyen Payment Response 'refusalReason'. Beispiele AbgelehntUngenügendes GuthabenAbgelaufene KarteAcquirer-FehlerBetrug
	Transaktionsbetrag PaymentAmount	Der Geldwert der Zahlungstransaktion.
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 Daten but should be Converted for Reporting. In Analysis, this enables the 'Payment Throughput' Dashboard and helps Prioritize High-Value Rework Fälle. 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	Die spezifische Methode, die der Kunde für die Zahlung verwendet hat, 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 Leistungsfähigkeit Erkenntnisse' Dashboard. It helps Correlations between Specific Payment Methods and Authorization Rates, Processing Speeds, or Technical Failures. Bedeutung Wesentlich 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	Der aktuelle Status der Zahlung (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 Filterung of Fälle (e.g., 'Show me all currently Refused payments'). It is Essential for the 'Payment Throughput and Status Monitoring' Dashboard. Bedeutung Provides a Momentaufnahme of the Current Health of the Transaction. Datenquelle Abgeleitet vom letzten Event Code im Case. Beispiele BeglichenAbgelehntAuthorisiert
	Acquirer-Referenz AcquirerReference	Referenznummer der Acquirer-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 Datensatzs against Bank Statements in External Ledgers. Bedeutung Essentiell für den 3-Wege-Abgleich und die externe Abstimmung. Datenquelle Adyen Payment Response 'additionalDaten.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-Wert RiskScore	The Risk Wert assigned to the Transaction by the Fraud Engine.
Beschreibung Die RevenueProtect-Engine von Adyen weist einen numerischen Wert (0-100) zu, der den Antrag bearbeitet.ie Wahrscheinlichkeit von Betrug anzeigt. Höhere Werts lösen oft eine manuelle Überprüfung oder automatische Blockierung aus. In der Analyse unterstützt dies den 'Financial Compliance Risk Übersicht'. Das Korrelieren hoher Risikoscores mit Chargebacks hilft, die Betrugsregeln anzupassen. Hohe Werts, die zu erfolgreichen Zahlungen führen, könnten Nein positive Resultate im Risikomodell anzeigen. Bedeutung Essentiell für die Analyse der Effizienz der Betrugspräventionslogik. Datenquelle Adyen Risk API-Antwort oder Reporting 'fraudResult.accountWert'. Beispiele 025100
	Kunden-ID ShopperReference	Eine eindeutige Referenz zur Identifizierung des Käufers über mehrere Transaktionen hinweg.
Beschreibung Dieser Identifikator 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 Fälle 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_1, 2, 3, 45email@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 Leistungsfähigkeit Analysis. It helps Identify if Specific Länder have Higher Decline Rates or Slower Bearbeitungszeiten due to Local Banking Infrastructure. Bedeutung Ermöglicht die geografische Segmentierung der Zahlungsperformance. Datenquelle Adyen Payment Request 'countryCode' oder 'billingAddress.country'. Beispiele NLUSADE
	Shopper Interaction Typ ShopperInteraction	Zeigt an, ob die Zahlung E-Commerce, POS oder ein Abonnementnnement (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/Abonnementnnement). In Analysis, this helps Distinguish between Different Business Models and Sales Channels. Prozessflusss often Differ Significantly between POS and Ecommerce, making this a Vital Filter for Clean Prozessanalyse (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 den Antrag bearbeitet.er `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 Standardizing Financial Values when Aggregating Daten 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 Prozessanalyse (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 wichtiger 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='Ja'. 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 Durchlaufzeit' 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 maßgeblich für den KPI 'Payment Authorization Lead Time'. Datenquelle Adyen Notification Webhook: EventCode 'CAPTURE' mit success='Ja'. 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 Zeitstempel 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 den Antrag bearbeitet.er `Zeitstempel`, der den Antrag bearbeitet.er 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 Durchlaufzeit'. 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 Streitfalle was Won, and Funds are Returned to the Merchant. This is a Successful Resolution of an Exception.
Bedeutung Positives Ergebnisse 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 Streitfalle Flow dar.
Bedeutung Tracks the Effort Spent on Revenue Protection. Important for 'Payment Rework Rate'. Datenquelle Adyen Streitfalles 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 Streitfalle 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 Wert 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 Fehler 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 den Antrag bearbeitet.as 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

Extraktionsanleitungen

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, Typ, 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 Typs (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“-Ereignisse zu erstellen, und ordnet die Spalte Typ 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 Typ: 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), Typ (Activity), Creation Date, Booking Date (Event-Zeitstempel), Merchant Account.
Filter Einstellungen: Vergewissern Sie sich, dass keine Filter die Typn „Chargeback“ oder „Refund“ ausschließen, um die Prozessvollständigkeit zu sicherstellen.

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 DatenFrames ein. Adyen-Berichte sind in der Regel im „Wide“-Format (eine Zeile pro Transaktion mit mehreren Statusspalten), daher ist eine Transformation erforderlich.
Aktivitäten-Mapping – Operativ: Verarbeiten Sie den Received Payment Detail Report. Ordnen Sie das CreationDate dem Event Payment Request Received zu. Verwenden Sie Logik, um die Spalte Status (z. B. Authorised, Refused, Fehler) zu prüfen und Ereignisse wie Payment Authorised, Payment Refused oder Technical Fehler Logged zu generieren.
Aktivitäten-Mapping – Finanziell: Verarbeiten Sie den Settlement Detail Report. Dieser Bericht enthält eine Spalte JournalTyp. 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 FraudWert 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-Typn 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 Typ-Filter einsetzen.
Abschließender Export: Das Skript exportiert den verarbeiteten DatenFrame 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. Verwenden Sie für die Management-API keine Basic Auth.
Report Typs:
- settlement_detail_report: Wesentlich für finanzielle Lebenszyklus-Ereignisse.
- received_payment_detail_report: Wesentlich 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 Listee der Konten oder einsetzen 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.')

Ihr Template für ZahlungsabwicklungsDaten

Ihr Template für ZahlungsabwicklungsDaten

Zahlungsabwicklungs-Attribute

Zahlungsabwicklungs-Aktivitäten

Extraktionsanleitungen

Export des Adyen Settlement Detail Report

Schritte

Konfiguration

a Beispielabfrage config

Python Extraktion via Reporting API

Schritte

Konfiguration

a Beispielabfrage python

Bereit, um loszulegen?

Unlock Seamless Payments Processing in Adyen Today.

Ihr Template für ZahlungsabwicklungsDaten

Ihr Template für ZahlungsabwicklungsDaten

Zahlungsabwicklungs-Attribute

Zahlungsabwicklungs-Aktivitäten

Extraktionsanleitungen

Export des Adyen Settlement Detail Report

Schritte

Konfiguration

a Beispielabfrage config

Python Extraktion via Reporting API

Schritte

Konfiguration

a Beispielabfrage python

Ihre Privatsphäre ist uns wichtig

Bereit, um loszulegen?

Unlock Seamless Payments Processing in Adyen Today.