> Continue verbetering > Betalingsverwerking > Adyen > datatemplate

Uw Template voor Betalingsverwerkingsdata

Adyen

Attributes voor Betalingsverwerking (20) Activiteiten in Betalingsverwerking (16) Extractie Guides (2)

Uw Template voor Betalingsverwerkingsdata

Deze template biedt een uitgebreide handleiding voor het verzamelen van de benodigde data om uw betalingsverwerking in Adyen te analyseren. Het schetst alle essentiële data attributes en procesactiviteiten om te volgen, samen met praktische instructies voor data-extractie. Gebruik deze om ervoor te zorgen dat u alle kritieke informatie vastlegt voor effectieve process mining.

Aanbevolen attributen om vast te leggen
Belangrijkste activiteiten om te volgen
Praktische extractiehandleiding voor Adyen

Nieuw met event logs? Leer hoe je een process mining event log creëert.

Template downloaden

Attributes voor Betalingsverwerking

Dit zijn de aanbevolen data velden om op te nemen in uw event log voor een uitgebreide analyse van uw betalingsverwerking binnen Adyen.

5 Verplicht 7 Aanbevolen 8 Optioneel

	Naam	Omschrijving
	Activiteitsnaam EventCode	Het specifieke stadium of de actie die plaatsvindt in de betaallevenscyclus.
Omschrijving Dit attribute definieert de specifieke gebeurtenis die heeft plaatsgevonden, zoals AUTHORISATION, CAPTURE of REFUND. Het bepaalt de nodes in de proceskaart en de stroom van de transactie. In de analyse worden deze codes vertaald naar mensleesbare activiteitsnamen om de processtroom te visualiseren. Variaties in de sequentie van deze codes duiden op verschillende procespaden, zoals straight-through processing versus exception handling. Het belang Definieert het 'wat' van het process mining model, wat de visualisatie van processtromen mogelijk maakt. Vindplaats Adyen Notificatie Webhooks 'eventCode' veld. Voorbeelden AUTHORISATIONCAPTURETERUGBETALINGCANCELLATIONCHARGEBACK
	Betalingstransactie ID PspReference	De unieke referentie-ID die door Adyen aan elke betalingstransactie is toegewezen.
Omschrijving Dit attribute dient als de primaire sleutel voor de gehele betaallevenscyclus binnen het Adyen ecosysteem. Het koppelt het initiële betaalverzoek aan volgende gebeurtenissen zoals autorisatie, vastlegging, afwikkeling en potentiële terugbetalingen of chargebacks. In de analyse wordt deze ID gebruikt om discrete gebeurtenissen te groeperen in een enkele case, wat end-to-end procesreconstructie mogelijk maakt. Het stelt analisten in staat om de specifieke reis van een betaling te volgen, van de initiatie door de koper tot de uiteindelijke financiële afwikkeling. Het belang Het is de fundamentele schakel die losgekoppelde events groepeert in een enkele procesinstantie voor mining. Vindplaats Adyen Betaalantwoord 'pspReference' of Settlement Detail Report 'PSP Reference' kolom. Voorbeelden 851564567890123479145612345678908825641234567890
	Gebeurtenistijdstempel EventDate	De datum en tijd waarop de specifieke betaalactiviteit plaatsvond.
Omschrijving Dit attribute registreert de precieze timestamp van wanneer een gebeurtenis (zoals autorisatie of afwikkeling) in het systeem werd gelogd. Het maakt de chronologische ordening van activiteiten binnen een case mogelijk. In de analyse is dit cruciaal voor het berekenen van doorlooptijden, het identificeren van bottlenecks en het bepalen van de doorvoer van het systeem over tijd. Het ondersteunt alle tijdgebonden KPI's zoals 'Totale Betaalcyclusduur'. Het belang Essentieel voor het ordenen van events en het berekenen van alle op duur gebaseerde metrics. Vindplaats Adyen Notificatie Webhooks 'eventDate' veld. Voorbeelden 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	Bronsysteem SourceSystem	De naam van het systeem waar de data vandaan komt.
Omschrijving Dit statische attribute identificeert dat de record afkomstig is van Adyen. In multi-systeem process mining (bijv. het combineren van Adyen met SAP) is dit cruciaal voor lineage. In de analyse stelt het gebruikers in staat om activiteiten te filteren die specifiek plaatsvonden binnen de betaalgateway versus het ERP- of Order Management Systeem. Het belang Cruciaal voor data lineage in multi-systeem process mining. Vindplaats Statische waarde tijdens extractie. Voorbeelden AdyenAdyen_Production
	Laatste data-update LastDataUpdate	De timestamp van de laatste extractie of verversing van de record.
Omschrijving Dit attribute geeft de actualiteit van de data in het process mining model aan. Het helpt gebruikers te begrijpen of ze naar real-time data of een snapshot kijken. In de analyse is dit voornamelijk een technisch veld dat wordt gebruikt voor data governance en het valideren dat de pipeline correct functioneert. Het belang Technisch veld om de actualiteit van data te volgen. Vindplaats Systeemtijd bij extractie. Voorbeelden 2023-10-30T12:00:00Z
	Betaalmethode PaymentMethod	De specifieke methode die de koper gebruikt om te betalen, zoals Visa of PayPal.
Omschrijving Dit attribute legt het type betaalinstrument vast, inclusief creditcardmerken (Visa, MC), digitale wallets (PayPal, Apple Pay) of lokale betaalmethoden (iDEAL, Sofort). In de analyse is dit cruciaal voor het 'Payment Method Performance Insights' dashboard. Het helpt bij het leggen van correlaties tussen specifieke betaalmethoden en autorisatiepercentages, verwerkingssnelheden of technische storingen. Het belang Cruciaal voor het analyseren van slagingspercentages en kosten bij verschillende betaaldienstverleners. Vindplaats Adyen Betaalantwoord 'paymentMethod.brand' of 'paymentMethod.type'. Voorbeelden visamcpaypalidealklarna
	Betaalstatus PaymentStatus	De huidige status van de betaling (bijv. Geautoriseerd, Afgewikkeld, Geweigerd).
Omschrijving Dit attribute geeft de laatst bekende status van de betalingstransactie weer. Het is vaak afgeleid van de meest recente activiteit in de case. In de analyse maakt het snelle filtering van cases mogelijk (bijv. 'Toon mij alle momenteel geweigerde betalingen'). Het is essentieel voor het 'Payment Throughput and Status Monitoring' dashboard. Het belang Biedt een momentopname van de huidige status van de transactie. Vindplaats Afgeleid van de laatste event code in de case. Voorbeelden AfgehandeldGeweigerdAuthorised
	Is herstelwerk IsRework	Vlag die aangeeft of de transactie herpogingen of foutcorrecties omvatte.
Omschrijving Een booleaanse vlag die 'waar' is als de case meerdere autorisatiepogingen bevat, of activiteiten zoals 'Payment Refused' gevolgd door een herpoging. Bij analyse stuurt dit het 'Payment Rework and Exception Hotspots' dashboard aan. Het stelt analisten in staat om specifiek te filteren op problematische cases om te begrijpen waarom process flows niet de happy path volgen. Het belang Identificeert inefficiënte cases die handmatige of systeeminterventie vereisen. Vindplaats Berekend op basis van het aantal mislukte events > 0. Voorbeelden truefalse
	Merchant Account MerchantAccount	De specifieke verkopersrekening binnen Adyen die de transactie verwerkt.
Omschrijving Adyen maakt meerdere merchant accounts mogelijk onder één bedrijfsaccount. Dit attribuut identificeert welke specifieke bedrijfseenheid, merk of regionale entiteit de betaling heeft verwerkt. Bij analyse dient dit als een primaire dimensie voor segmentatie. Het stelt stakeholders in staat om prestaties, faalpercentages en volumes te vergelijken tussen verschillende bedrijfseenheden of merken om specifieke verbeterpunten te identificeren. Het belang Sleutel voor het segmenteren van prestaties per bedrijfseenheid of dochteronderneming. Vindplaats Adyen Betaalverzoek/Antwoord 'merchantAccount'. Voorbeelden MyStore_UKMyStore_USGlobalSales_Main
	Reden van Weigering RefusalReason	De tekstuele beschrijving die verklaart waarom een betaling werd geweigerd of mislukte.
Omschrijving Wanneer een transactie mislukt, geeft Adyen een reden code of beschrijving (bijv. 'Onvoldoende saldo', 'CVC geweigerd', 'Vervallen kaart'). In de analyse is dit de belangrijkste drijfveer voor het 'Payment Transaction Failure Rate' dashboard. Het analyseren van deze redenen helpt te identificeren of mislukkingen te wijten zijn aan technische problemen, frauderegels of kopersgedrag, wat specifieke herstelacties stuurt. Het belang Het belangrijkste attribute voor de hoofdoorzaakanalyse van mislukte betalingen. Vindplaats Adyen Betaalantwoord 'refusalReason'. Voorbeelden GeweigerdOnvoldoende saldoExpired CardAcquirer ErrorFraude
	Totale Betaalcyclusduur TotalCycleTime	De totale duur van het aanmaken van het betaalverzoek tot de afwikkeling.
Omschrijving Dit is een berekende metric die de verstreken tijd meet tussen de allereerste gebeurtenis (bijv. 'Betaalverzoek Ontvangen') en de gebeurtenis 'Betaling Afgewikkeld'. In de analyse is dit de primaire efficiëntie KPI. Het benadrukt de snelheid van de cashflow. Lange doorlooptijden kunnen duiden op problemen met vastleggingsvertragingen of afwikkelingscycli. Het belang KPI voor werkkapitaaloptimalisatie. Vindplaats Berekend: Timestamp(Settled) - Timestamp(Created). Voorbeelden 2 dagen4 uur5 minuten
	Transactiebedrag PaymentAmount	De monetaire waarde van de betalingstransactie.
Omschrijving Dit attribute vertegenwoordigt de financiële waarde die aan de transactie is gekoppeld. Het wordt meestal opgeslagen als een kleine eenheid (bijv. centen) in de ruwe data, maar moet worden geconverteerd voor rapportage. In de analyse maakt dit het 'Payment Throughput' dashboard mogelijk en helpt het bij het prioriteren van herstelwerk cases met hoge waarde. Het wordt ook gebruikt om het totale verwerkte volume en de financiële impact van mislukte transacties te berekenen. Het belang Noodzakelijk voor financiële impactanalyse en doorvoermonitoring. Vindplaats Adyen Betaalverzoek 'amount.value'. Voorbeelden 10005509900
	Acquirer Reference AcquirerReference	Referentienummer verstrekt door de acquirerende bank.
Omschrijving Dit is de externe referentie die is toegewezen door de onderliggende financiële instelling (acquirer) die de kaarttransactie verwerkt. Deze is distinct van de Adyen PSP referentie. In de analyse is dit veld cruciaal voor de 'Analyse van Reconciliatievertraging Betaling'. Het is de sleutel die wordt gebruikt om Adyen records af te stemmen met bankafschriften in externe grootboeken. Het belang Essentieel voor 3-way matching en externe afstemming. Vindplaats Adyen Betaalantwoord 'additionalData.acquirerReference'. Voorbeelden 1234567890987654321
	Afwikkelingsbatchnummer BatchNumber	Het batchnummer dat gekoppeld is aan de afwikkeling van middelen.
Omschrijving Adyen groepeert afgewikkelde betalingen in batches voor uitbetaling. Dit attribuut identificeert tot welke batch een specifieke transactie behoort. Bij analyse wordt dit gebruikt om betalingen te groeperen op hun uitbetalingscyclus. Het helpt bij het controleren of specifieke batches vertraagd zijn en ondersteunt de 'Payment Settled' activiteitstracking. Het belang Koppelt individuele transacties aan bulk financiële afrekeningen. Vindplaats Adyen Settlement Detail Report 'Batch Nummer'. Voorbeelden 100255
	Auth Code AuthorisationCode	De autorisatiecode die door de uitgever wordt geretourneerd na goedkeuring.
Omschrijving Een code die aangeeft dat de fondsen zijn gereserveerd op de kaart van de shopper. Dit is het bewijs van een succesvolle autorisatie. Bij analyse is dit voornamelijk voor audit en traceerbaarheid. Het valideert dat de 'Payment Authorised' activiteit legitiem was. Het belang Bewijs van succesvolle autorisatie voor audit trails. Vindplaats Adyen Betaalantwoord 'authCode'. Voorbeelden 123456098712
	Frauderisicoscore RiskScore	De risicoscore die door de fraudemotor aan de transactie is toegewezen.
Omschrijving De RevenueProtect engine van Adyen kent een numerieke score (0-100) toe die de waarschijnlijkheid van fraude aangeeft. Hogere scores leiden vaak tot handmatige beoordeling of automatische blokkering. Bij analyse ondersteunt dit het 'Financial Compliance Risk Overview'. Het correleren van hoge risicoscores met chargebacks helpt bij het afstemmen van frauderegels. Hoge scores die resulteren in succesvolle betalingen kunnen wijzen op false positives in het risicomodel. Het belang Essentieel voor het analyseren van de efficiëntie van fraudepreventielogica. Vindplaats Adyen Risk API-antwoord of Rapportering 'fraudResult.accountScore'. Voorbeelden 025100
	Klant-ID ShopperReference	Een unieke referentie die wordt gebruikt om de shopper te identificeren over meerdere transacties heen.
Omschrijving Deze identifier koppelt verschillende transacties aan dezelfde klantentiteit. Deze wordt door de verkoper geleverd tijdens het betaalverzoek. In de analyse maakt dit een klantgerichte analyse mogelijk, waardoor het opsporen van recidivisten in fraudegevallen of loyale klanten bij succesvolle transactieanalyses wordt vergemakkelijkt. Het faciliteert de 'Klant' generieke mapping. Het belang Maakt aggregatie op klantniveau en gedragsanalyse mogelijk. Vindplaats Adyen Betaalverzoek 'shopperReference'. Voorbeelden CUST-001user_12345email@example.com
	Land van Koper ShopperCountry	De tweeletterige landcode van de koper.
Omschrijving Dit attribute geeft de locatie van de koper aan, doorgaans afgeleid van het land van de kaartuitgever of het factuuradres. In de analyse wordt het gebruikt voor regionale prestatieanalyse. Het helpt te identificeren of specifieke landen hogere afwijzingspercentages of tragere verwerkingstijden hebben als gevolg van lokale bankinfrastructuur. Het belang Maakt geografische segmentatie van betaalprestaties mogelijk. Vindplaats Adyen Betaalverzoek 'countryCode' of 'billingAddress.country'. Voorbeelden NLVSDE
	Type Klantinteractie ShopperInteraction	Geeft aan of de betaling Ecommerce, POS of een abonnement (ContAuth) was.
Omschrijving Dit attribute categoriseert de aard van de interactie tussen de koper en de verkoper. Typische waarden zijn `Ecommerce` (online), `POS` (in-store), of `ContAuth` (terugkerend/abonnement). In de analyse helpt dit om onderscheid te maken tussen verschillende bedrijfsmodellen en verkoopkanalen. Processtromen verschillen vaak aanzienlijk tussen POS en Ecommerce, waardoor dit een essentieel filter is voor een zuivere procesontdekking. Het belang Differentieert processtromen tussen online, in-store en terugkerende betalingen. Vindplaats Adyen Betaalverzoek 'shopperInteraction'. Voorbeelden EcommerceContAuthPOSMoto
	Valuta PaymentCurrency	De drieletterige ISO-code die de valuta van de transactie aangeeft.
Omschrijving Dit attribute definieert de valuta waarin het `PaymentAmount` wordt uitgedrukt. Veelvoorkomende waarden zijn EUR, USD, GBP, etc. In de analyse wordt dit gebruikt om transacties per markt te groeperen en is het essentieel voor het normaliseren van financiële waarden bij het aggregeren van data over verschillende regio's. Het belang Contextualiseert het bedragveld voor multi-valuta rapportering. Vindplaats Adyen Betaalverzoek 'amount.currency'. Voorbeelden EURUSDGBP

Verplicht Aanbevolen Optioneel

Activiteiten in Betalingsverwerking

Dit zijn de belangrijkste processtappen en mijlpalen om vast te leggen in uw event log voor accurate procesontdekking in uw Adyen betalingsstromen.

5 Aanbevolen 11 Optioneel

	Activiteit	Omschrijving
	Betaalverzoek Ontvangen	De initiële ontvangst van het transactieverzoek door het Adyen betaalplatform. Dit wordt vastgelegd vanaf de initiële API request timestamp of de aanmaak van de pspReference.
Het belang Markeert de absolute start van de procesinstantie. Essentieel voor het berekenen van de totale end-to-end doorlooptijd. Vindplaats Adyen Payment API logs of de timestamp die geassocieerd is met de creatie van de pspReference. Vastleggen Vastgelegd wanneer pspReference wordt gegenereerd via API Gebeurtenistype explicit
	Betaling afgewikkeld	Fondsen zijn succesvol verrekend en gecrediteerd op de Adyen-rekening van de merchant. Dit verschijnt in het Settlement Detail Report.
Het belang De financiële conclusie van het succesvolle proces. Essentieel voor 'Totale Betaalcyclusduur' en 'Analyse van Reconciliatievertraging Betaling'. Vindplaats Adyen Settlement Detail Report (SDR), record type 'Settled'. Vastleggen Vastgelegd wanneer transactie verschijnt in Settlement Report Gebeurtenistype explicit
	Betaling Geautoriseerd	De kaartuitgever of betaalmethode heeft de transactie goedgekeurd en middelen zijn gereserveerd. Vastgelegd via de standaard Adyen notificatie webhook.
Het belang Een kritieke mijlpaal die aangeeft dat de transactie geldig is en fondsen beschikbaar zijn. Voorwaarde voor capture. Vindplaats Adyen Notificatie Webhook: eventCode 'AUTHORISATION' met success='true'. Vastleggen Vastgelegd bij AUTHORISATION webhook-succes Gebeurtenistype explicit
	Betaling Geweigerd	De transactie werd geweigerd door de uitgever of de risicoregels van Adyen. Vastgelegd via de autorisatie webhook met een foutstatus.
Het belang Heeft direct invloed op de 'Payment Transaction Failure Rate' KPI. Analyse van weigeringsredenen helpt bij het optimaliseren van autorisatiepercentages. Vindplaats Adyen Notificatie Webhook: eventCode 'AUTHORISATION' met success='false'. Vastleggen Vastgelegd bij AUTHORISATION webhook-fout Gebeurtenistype explicit
	Betaling vastgelegd	Het commando om middelen over te dragen van de koper naar de verkoper is succesvol verwerkt. Dit kan onmiddellijk zijn (auto-capture) of vertraagd (handmatige capture).
Het belang Bevestigt omzetherkenning. De tijd tussen autorisatie en capture is essentieel voor de 'Payment Authorization Lead Time' KPI. Vindplaats Adyen Notificatie Webhook: eventCode 'CAPTURE' met success='true'. Vastleggen Vastgelegd bij CAPTURE webhook-succes Gebeurtenistype explicit
	Betaling geannuleerd	De autorisatie werd geannuleerd voordat middelen werden vastgelegd. Dit maakt de gereserveerde middelen op de kaart van de koper vrij.
Het belang Vertegenwoordigt een proceslus waarbij een geldige order wordt beëindigd voordat deze is voltooid, vaak als gevolg van een klantverzoek of een voorraad-timeout. Vindplaats Adyen Notificatie Webhook: eventCode 'CANCELLATION'. Vastleggen Vastgelegd bij CANCELLATION webhook Gebeurtenistype explicit
	Betaling Verstuurd voor Afwikkeling	Adyen heeft de transactie doorgestuurd naar de acquirerende bank of het netwerk voor financiële verwerking. De status verandert naar SentForSettlement.
Het belang Markeert de overgang van operationele verwerking naar financiële verrekening. Vertragingen hier beïnvloeden de cashflow. Vindplaats Adyen Transactiestatus API of afgeleid uit statuswijzigingshistorie logs. Vastleggen Vergelijk de statusveldovergang naar SentForSettlement Gebeurtenistype inferred
	Capture Failed	De poging om geautoriseerde middelen vast te leggen is mislukt, vaak door een technische timeout of wijzigingen in de kaartstatus tussen autorisatie en vastlegging.
Het belang Kritiek foutpunt dat herstel of een nieuwe poging vereist. Draagt bij aan het 'Payment Exception Rate'. Vindplaats Adyen Notificatie Webhook: eventCode 'CAPTURE_FAILED'. Vastleggen Vastgelegd bij CAPTURE_FAILED webhook Gebeurtenistype explicit
	Chargeback Defended	Er is bewijs ingediend bij Adyen om een chargeback aan te vechten. Dit vertegenwoordigt een herstel/handmatige activiteit in de dispute flow.
Het belang Volgt de inspanning besteed aan omzetbescherming. Belangrijk voor 'Percentage Herstelwerk Betalingen'. Vindplaats Adyen Disputes API of Case Management logs die bewijsaanlevering tonen. Vastleggen Afgeleid uit statuswijziging naar 'Defense Supplied' Gebeurtenistype inferred
	Chargeback Notification Received	Adyen heeft een geschilmeldingsbericht ontvangen van het kaartschema. Dit activeert de dispute workflow.
Het belang Belangrijke compliance- en risico-indicator. Stuurt de 'Compliance Incident Rate' aan en vereist onmiddellijke handmatige interventie. Vindplaats Adyen Notificatie Webhook: eventCode 'CHARGEBACK' of 'NOTIFICATION_OF_CHARGEBACK'. Vastleggen Vastgelegd bij CHARGEBACK webhook Gebeurtenistype explicit
	Chargeback Reversed	Het geschil werd gewonnen en de middelen worden teruggestort naar de verkoper. Dit is een succesvolle oplossing van een uitzondering.
Het belang Positieve uitkomst voor risicobeheer. Compenseert de financiële impact van de initiële chargeback. Vindplaats Adyen Notificatie Webhook: eventCode 'CHARGEBACK_REVERSED'. Vastleggen Vastgelegd bij CHARGEBACK_REVERSED webhook Gebeurtenistype explicit
	Risicoscreening Uitgevoerd	De RevenueProtect engine van Adyen analyseert de transactie op fraudesignalen. Dit wordt afgeleid uit de aanwezigheid van een fraudescore of risicoresultaat in de autorisatierespons.
Het belang Hoge risicoscores kunnen handmatige beoordelingen of automatische weigeringen activeren, wat knelpunten of procesafsluitingspunten creëert. Vindplaats Adyen Betaalantwoord (fraudResult veld) of Case Management logs. Vastleggen Afgeleid uit de aanwezigheid van het fraudResult object Gebeurtenistype inferred
	Technische Fout Geregistreerd	Er is een systeemfout opgetreden tijdens de verwerking, zoals een webhookfout of API-timeout. Geïdentificeerd via specifieke foutcodes in de interface.
Het belang Ondersteunt direct de analyse van het 'Payment Transaction Failure Rate' door technische versus financiële storingen te categoriseren. Vindplaats Adyen Interface logs of specifieke storingsreacties in API-aanroepen. Vastleggen Vastgelegd wanneer foutresponscode 5xx of 4xx wordt geretourneerd Gebeurtenistype explicit
	Terugbetaling Afgewikkeld	De terugbetaling is financieel verwerkt en gedebiteerd van de verkopersrekening. Bevestigd via het Settlement Detail Report.
Het belang Sluit de cyclus van het terugbetalingsproces af. Belangrijk voor 'Gemiddelde foutoplossingstijd' als de terugbetaling het gevolg was van een fout. Vindplaats Adyen Settlement Detail Report, record type 'Refunded' of 'RefundedReversed'. Vastleggen Vastgelegd wanneer terugbetaling verschijnt in Settlement Report Gebeurtenistype explicit
	Terugbetaling Gestart	Er is een verzoek geactiveerd om geld terug te storten aan de shopper. Dit start een omgekeerde processtroom.
Het belang Duiding van een post-settlement uitzondering. Hoge terugbetalingspercentages kunnen wijzen op upstream kwaliteitsissues. Vindplaats Adyen Notificatie Webhook: eventCode 'REFUND'. Vastleggen Vastgelegd bij REFUND webhook-activering Gebeurtenistype explicit
	Uitbetaling Bevestigd	Fondsen die geassocieerd zijn met een batch van afgewikkelde transacties zijn uitbetaald aan de bankrekening van de merchant.
Het belang Vertegenwoordigt de daadwerkelijke geldoverdracht naar het bedrijf, gekoppeld aan 'Doorlooptijd Reconciliatie Betaling'. Vindplaats Adyen Notificatie Webhook: eventCode 'PAYOUT_THIRD_PARTY' of afgeleid uit Payout Report. Vastleggen Koppel Payout Report batch ID aan Transactie ID Gebeurtenistype inferred

Aanbevolen Optioneel

Extractie Guides

Hoe u uw data van Adyen krijgt

Stappen

Log in op de Adyen Customer Area met een account dat de rol Merchant Report heeft.
Navigeer naar Reports en selecteer Settlement details in het menu.
Ga naar de instellingen voor Automatic generation of kies Generate report voor een eenmalige export.
Zorg er in het configuratiepaneel voor dat het Format op CSV (door komma's gescheiden waarden) staat.
Selecteer bij Include columns de optie All of vink specifiek de volgende velden aan: 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 en Interchange.
BELANGRIJK: Zorg dat het rapport alle Journal Types bevat (Settled, Refunded, Chargeback, PaidOut, etc.) om de volledige financiële levenscyclus vast te leggen.
Genereer het rapport voor de gewenste periode (bijv. de afgelopen 90 dagen). Houd er rekening mee dat settlement-rapporten worden gegenereerd op basis van de settlement batch date en niet op de transactiedatum.
Download het gegenereerde CSV-bestand naar uw lokale extractie-omgeving.
Voer het transformatiescript (hieronder meegeleverd) uit om het 'brede' CSV-grootboek om te zetten naar het 'lange' event log-formaat dat nodig is voor ProcessMind.
Het script voert cruciale transformaties uit: het 'unpivots' de Creation Date om 'Payment Request Received'-events aan te maken en koppelt de kolom Type aan specifieke financiële activiteiten.
Controleer of het resulterende CSV-bestand de koppen PspReference, EventCode, EventDate en SourceSystem bevat.
Upload het definitieve getransformeerde CSV-bestand naar ProcessMind.

Configuratie

Report Type: Settlement Detail Report (financieel grootboek)
File Format: CSV (standaard scheiding door komma's)
Granularity: Transactieniveau (één rij per financiële boeking)
Timezone: UTC (sterk aanbevolen om extracties uit verschillende systemen op elkaar af te stemmen)
Date Range: Sluit aan bij Settlement Batches (Batch Closed Date) en niet bij de aanmaakdatum van de transactie. Let op eventuele overlap bij incrementele verwerking.
Required Columns: Psp Reference (Key), Type (Activity), Creation Date, Booking Date (Event Timestamps), Merchant Account.
Filter Settings: Zorg dat er geen filters zijn ingesteld die types als 'Chargeback' of 'Refund' uitsluiten, zodat het proces volledig in kaart wordt gebracht.

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

Stappen

Prerequisite Configuration: Ensure you have an Adyen Report user with the Merchant Report role enabled. Obtain your API Key from the Customer Area under Developers > API Credentials.
Identify Required Reports: This extraction relies on two key CSV reports generated by Adyen: the Settlement Detail Report (for financial events like Settlement, Chargebacks, Refunds) and the Received Payment Detail Report (for operational events like Requests, Refusals, Authorizations).
Python Environment Setup: Install the necessary libraries using pip: pandas, requests, and numpy. These will be used for API communication and data transformation.
API Connection Implementation: Configure the Python script (provided below) to authenticate against the https://management-test.adyen.com or https://management-live.adyen.com endpoints. You will use the Report API to list available reports for your specific date range and download the URLs.
Data Ingestion: The script reads the raw CSV data into pandas DataFrames. Adyen reports are typically 'wide' (one row per transaction with multiple status columns), so transformation is required.
Activity Mapping - Operational: Process the Received Payment Detail Report. Map the CreationDate to Payment Request Received. Use logic to inspect the Status column (e.g., Authorised, Refused, Error) to generate Payment Authorised, Payment Refused, or Technical Error Logged events.
Activity Mapping - Financial: Process the Settlement Detail Report. This report contains a JournalType column. Map values like Settled to Payment Settled, Refunded to Refund Initiated, and Chargeback to **Chargeback Notification Received`.
Inferring Complex Activities:
- Risk Screening Performed: Check if the FraudScore column is populated and greater than -1.
- Payout Confirmed: Link transactions via the BatchNumber to the Payout entry in the settlement report.
- Chargeback Defended: Look for SecondChargeback or Defense journal types.
Data Transformation: Apply a 'melt' or 'stack' operation in pandas to convert the wide dataset into a long event log format where every activity is a separate row.
Attribute Standardization: Rename columns to match the target schema: PspReference, EventCode, EventDate, SourceSystem (hardcoded to 'Adyen'), and PaymentAmount. Ensure dates are parsed to ISO 8601 format.
Filtering: Filter out internal reconciliation rows that do not represent process steps (e.g., header rows or balance carry-overs) using the Type filter.
Final Export: The script exports the processed DataFrame to a CSV file named adyen_event_log.csv, ready for upload to ProcessMind.

Configuratie

API Environment: Schakel tussen de Adyen Test- (management-test.adyen.com) en Live-endpoints (management-live.adyen.com) op basis van de implementatiefase.
Authentication: Gebruik x-api-key in de header. Gebruik geen Basic Auth voor de Management API.
Report Types:
- settlement_detail_report: Essentieel voor gebeurtenissen in de financiële levenscyclus.
- received_payment_detail_report: Cruciaal voor de initiële aanvraag en autorisatielogica.
Date Range: Adyen-rapporten worden gegenereerd op basis van batch-afsluiting. Zorg dat het script rapporten opvraagt die de gewenste CreationDate plus 7 dagen dekken om ook vertraagde vereffeningen mee te nemen.
Merchant Account Scope: Indien u meerdere merchant accounts heeft, doorloop dan de lijst met accounts of gebruik het rapport op Company Account-niveau indien beschikbaar.
Pandas Configuration: Stel low_memory=False in bij het inlezen van CSV-bestanden als het transactievolume de 100.000 rijen overschrijdt, om fouten bij de type-inferentie te voorkomen.

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

Uw Template voor Betalingsverwerkingsdata

Uw Template voor Betalingsverwerkingsdata

Attributes voor Betalingsverwerking

Activiteiten in Betalingsverwerking

Extractie Guides

Adyen Settlement Detail Report Export

Stappen

Configuratie

a Voorbeeldquery config

Python Extractie via Reporting API

Stappen

Configuratie

a Voorbeeldquery python

Klaar om te starten?

Ontgrendel Naadloze Betalingsverwerking in Adyen Vandaag.

Uw Template voor Betalingsverwerkingsdata

Uw Template voor Betalingsverwerkingsdata

Attributes voor Betalingsverwerking

Activiteiten in Betalingsverwerking

Extractie Guides

Adyen Settlement Detail Report Export

Stappen

Configuratie

a Voorbeeldquery config

Python Extractie via Reporting API

Stappen

Configuratie

a Voorbeeldquery python

Wij hechten veel waarde aan je privacy

Klaar om te starten?

Ontgrendel Naadloze Betalingsverwerking in Adyen Vandaag.