> Continue procesverbetering > Betalingsverwerkingingng > Adyen > Datatemplate

Uw betalingsverwerking datatemplate

Adyen

Attributen Betalingsverwerkingingng (19) Activiteiten Betalingsverwerkingingng (16) Extractiegidsen (2)

Uw betalingsverwerking datatemplate

Deze template biedt een volledige gids voor het verzamelen van de data om uw betalingsverwerking in Adyen te analyseren. Het schetst alle benodigde data attributen en procesactiviteiten om te volgen, samen met praktische instructies voor data-extractie. Gebruik deze om ervoor te zorgen dat je 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

Attributen Betalingsverwerkingingng

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

5 Verplicht 6 Aanbevolen 8 Optioneel

	Naam	Beschrijving
	Activiteitsnaam EventCode	Het specifieke stadium of de actie die plaatsvindt in de betaallevenscyclus.
Beschrijving Dit attribuut definieert de specifieke gebeurtenis die heeft plaatsgevonden, zoals AUTHORISATION, CAPTURE of REFUND. Het bepaalt de stappen 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 volgorde van deze codes duiden op verschillende procespaden, zoals straight-through processing versus exception handling. Waarom het belangrijk is Definieert het 'wat' van het process mining model, wat de visualisatie van processtromen mogelijk maakt. Waar te verkrijgen Adyen Notificatie Webhooks 'gebeurtenisCode' veld. Voorbeelden AUTHORISATIONCAPTURETERUGBETALINGCANCELLATIONCHARGEBACK
	Payment Transaction ID PspReference	De unieke referentie-ID die door Adyen aan elke betalingstransactie is toegewezen.
Beschrijving Dit attribuut dient als de primary key 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 analysesten in staat om de specifieke reis van een betaling te volgen, van de initiatie door de koper tot de uiteindelijke financiële afwikkeling. Waarom het belangrijk is Het is de fundamentele schakel die losgekoppelde gebeurtenissen groepeert in een enkele procesinstantie voor mining. Waar te verkrijgen Adyen Betaalantwoord 'pspReference' of Settlement Detail Report 'PSP Reference' kolom. Voorbeelden 851564567890123479145612345678908825641234567890
	Tijdstempel EventDate	De datum en tijd waarop de specifieke betaalactiviteit plaatsvond.
Beschrijving Dit attribuut 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 belangrijk voor het berekenen van doorlooptijden, het vinden van knelpunten en het bepalen van de doorvoer van het systeem over tijd. Het ondersteunt alle tijdgebonden KPI's zoals 'Totale Betaalcyclusduur'. Waarom het belangrijk is Essentieel voor het ordenen van gebeurtenissen en het berekenen van alle op duur gebaseerde meetwaarden. Waar te verkrijgen Adyen Notificatie Webhooks 'gebeurtenisDate' 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.
Beschrijving Dit statische attribuut identificeert dat de record afkomstig is van Adyen. In multi-systeem process mining (bijv. het combineren van Adyen met SAP) is dit belangrijk voor lineage. In de analyse stelt het gebruikers in staat om activiteiten te filteren die specifiek plaatsvonden binnen de betaalgateway versus het ERP- of Orderbeheer Systeem. Waarom het belangrijk is Belangrijk voor data lineage in multi-systeem process mining. Waar te verkrijgen Statische waarde tijdens extractie. Voorbeelden AdyenAdyen_Production
	Tijdstip van extractie LastDataUpdate	De timestamp van de laatste extractie of verversing van het record.
Beschrijving Dit attribuut geeft de relevantie 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 bevestigen dat de pijplijn correct functioneert. Waarom het belangrijk is Technisch veld om de relevantie van data te volgen. Waar te verkrijgen Systeemtijd tijdens extractie. Voorbeelden 2023-10-30T12:00:00Z
	Betaalstatus PaymentStatus	De huidige status van de betaling (bijv. Geautoriseerd, Afgewikkeld, Geweigerd).
Beschrijving Dit attribuut 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 belangrijk voor het 'Payment Throughput and Status Monitoring' dashboard. Waarom het belangrijk is Biedt een momentopname van de huidige status van de transactie. Waar te verkrijgen Afgeleid van de laatste gebeurtenis code in de case. Voorbeelden AfgehandeldGeweigerdAuthorised
	Is herstelwerk IsRework	Vlag die aangeeft of de transactie herpogingen of foutcorrecties omvatte.
Beschrijving 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 analysesten in staat om specifiek te filteren op problematische cases om te begrijpen waarom processtromen niet de happy path volgen. Waarom het belangrijk is Identificeert inefficiënte cases die handmatige of systeeminterventie vereisen. Waar te verkrijgen Berekend op basis van het aantal mislukte gebeurtenissen > 0. Voorbeelden truefalse
	Merchant Account MerchantAccount	De specifieke verkopersrekening binnen Adyen die de transactie verwerkt.
Beschrijving 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, foutpercentages en volumes te vergelijken tussen verschillende bedrijfseenheden of merken om specifieke verbeterpunten te vinden. Waarom het belangrijk is Sleutel voor het segmenteren van prestaties per bedrijfseenheid of dochteronderneming. Waar te verkrijgen Adyen Betaalverzoek/Antwoord 'merchantAccount'. Voorbeelden MyStore_UKMyStore_USWereldwijdSales_Main
	Payment Method PaymentMethod	De specifieke methode die de koper gebruikt om te betalen, zoals Visa of PayPal.
Beschrijving Dit attribuut legt het type betaalinstrument vast, inclusief creditcardmerken (Visa, MC), digitale wallets (PayPal, Apple Pay) of lokale betaalmethoden (iDEAL, Sofort). In de analyse is dit belangrijk voor het 'Payment Method Performance Insights' dashboard. Het helpt bij het leggen van correlaties tussen specifieke betaalmethoden en autorisatiepercentages, verwerkingssnelheden of technische storingen. Waarom het belangrijk is Belangrijk voor het analyseren van slagingspercentages en kosten bij verschillende betaaldienstverleners. Waar te verkrijgen Adyen Betaalantwoord 'paymentMethod.brand' of 'paymentMethod.type'. Voorbeelden visamcpaypalidealklarna
	Reden van Weigering RefusalReason	De tekstuele beschrijving die verklaart waarom een betaling werd geweigerd of mislukte.
Beschrijving Wanneer een transactie mislukt, geeft Adyen een redencode 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 vinden of mislukkingen te wijten zijn aan technische problemen, frauderegels of kopersgedrag, wat specifieke herstelacties stuurt. Waarom het belangrijk is Het belangrijkste attribuut voor de hoofdoorzaakanalyse van mislukte betalingen. Waar te verkrijgen Adyen Betaalantwoord 'refusalReason'. Voorbeelden GeweigerdOnvoldoende saldoExpired CardAcquirer ErrorFraude
	Transactiebedrag PaymentAmount	De financiële waarde van de betalingstransactie.
Beschrijving Dit attribuut 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 hoogwaardige. Het wordt ook gebruikt om het totale verwerkte volume en de financiële impact van mislukte transacties te berekenen. Waarom het belangrijk is Noodzakelijk voor financiële impactanalyse en doorvoermonitoring. Waar te verkrijgen Adyen Betaalverzoek 'amount.waarde'. Voorbeelden 10005509900
	Acquirer Reference AcquirerReference	Referentienummer verstrekt door de acquirerende bank.
Beschrijving 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 belangrijk voor de 'Analyse van Reconciliatievertraging Betaling'. Het is de sleutel die wordt gebruikt om Adyen records af te stemmen met bankafschriften in externe grootboeken. Waarom het belangrijk is Essentieel voor 3-way matching en externe afstemming. Waar te verkrijgen Adyen Betaalantwoord 'additionalData.acquirerReference'. Voorbeelden 1234567890987654321
	Afwikkelingsbatchnummer BatchNumber	Het batchnummer dat gekoppeld is aan de afwikkeling van middelen.
Beschrijving 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. Waarom het belangrijk is Koppelt individuele transacties aan bulk financiële afrekeningen. Waar te verkrijgen Adyen Settlement Detail Report 'Batch Nummer'. Voorbeelden 100255
	Auth Code AuthorisationCode	De autorisatiecode die door de uitgever wordt geretourneerd na goedkeuring.
Beschrijving 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. Waarom het belangrijk is Bewijs van succesvolle autorisatie voor audit trails. Waar te verkrijgen Adyen Betaalantwoord 'authCode'. Voorbeelden 123456098712
	Frauderisicoscore RiskScore	De risicoscore die door de fraudemotor aan de transactie is toegewezen.
Beschrijving 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 Overzicht'. 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. Waarom het belangrijk is Essentieel voor het analyseren van de efficiëntie van fraudepreventielogica. Waar te verkrijgen Adyen Risk API-antwoord of Rapportering 'fraudResult.accountScore'. Voorbeelden 025100
	Klant-ID ShopperReference	Een unieke referentie die wordt gebruikt om de shopper te vinden over meerdere transacties heen.
Beschrijving Deze kenmerk 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 mogelijk maakt de 'Klant' generieke mapping. Waarom het belangrijk is Maakt aggregatie op klantniveau en gedragsanalyse mogelijk. Waar te verkrijgen Adyen Betaalverzoek 'shopperReference'. Voorbeelden CUST-001user_12345email@example.com
	Land van Koper ShopperCountry	De tweeletterige landcode van de koper.
Beschrijving Dit attribuut 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 vinden of specifieke landen hogere afwijzingspercentages of tragere verwerkingstijden hebben als gevolg van lokale bankinfrastructuur. Waarom het belangrijk is Maakt geografische segmentatie van betaalprestaties mogelijk. Waar te verkrijgen Adyen Betaalverzoek 'countryCode' of 'billingAddress.country'. Voorbeelden NLVSDE
	Type Klantinteractie ShopperInteraction	Geeft aan of de betaling Ecommerce, POS of een abonnement (ContAuth) was.
Beschrijving Dit attribuut 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 belangrijk filter is voor een zuivere procesbekijkking. Waarom het belangrijk is Differentieert processtromen tussen online, in-store en terugkerende betalingen. Waar te verkrijgen Adyen Betaalverzoek 'shopperInteraction'. Voorbeelden EcommerceContAuthPOSMoto
	Valuta PaymentCurrency	De drieletterige ISO-code die de valuta van de transactie aangeeft.
Beschrijving Dit attribuut definieert de valuta waarin het `PaymentBedrag` wordt uitgedrukt. Veelvoorkomende waarden zijn EUR, USD, GBP, etc. In de analyse wordt dit gebruikt om transacties per markt te groeperen en is het belangrijk voor het normaliseren van financiële waarden bij het aggregeren van data over verschillende regio's. Waarom het belangrijk is Contextualiseert het bedragveld voor multi-valuta rapportering. Waar te verkrijgen Adyen Betaalverzoek 'amount.currency'. Voorbeelden EURUSDGBP

Verplicht Aanbevolen Optioneel

Activiteiten Betalingsverwerkingingng

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

5 Aanbevolen 11 Optioneel

	Activiteit	Beschrijving
	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.
Waarom het belangrijk is Markeert de absolute start van de procesinstantie. Essentieel voor het berekenen van de totale end-to-end doorlooptijd. Waar te verkrijgen 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.
Waarom het belangrijk is De financiële conclusie van het succesvolle proces. Essentieel voor 'Totale Betaalcyclusduur' en 'Analyse van Reconciliatievertraging Betaling'. Waar te verkrijgen 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.
Waarom het belangrijk is Een kritieke mijlpaal die aangeeft dat de transactie geldig is en fondsen beschikbaar zijn. Voorwaarde voor capture. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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.
Waarom het belangrijk is Heeft direct invloed op de 'Payment Transaction Failure Rate' KPI. Analyse van weigeringsredenen helpt bij het optimaliseren van autorisatiepercentages. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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).
Waarom het belangrijk is Bevestigt omzetherkenning. De tijd tussen autorisatie en capture is belangrijk voor de 'Payment Authorization Lead Time' KPI. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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.
Waarom het belangrijk is Vertegenwoordigt een proceslus waarbij een geldige order wordt beëindigd voordat deze is voltooid, vaak als gevolg van een klantverzoek of een voorraad-timeout. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode 'CANCELLATION'. Vastleggen Vastgelegd bij CANCELLATION webhook Gebeurtenistype explicit
	Betaling Verzendend voor Afwikkeling	Adyen heeft de transactie doorgestuurd naar de acquirerende bank of het netwerk voor financiële verwerking. De status verandert naar SentForSettlement.
Waarom het belangrijk is Markeert de overgang van operationele verwerking naar financiële verrekening. Vertragingen hier beïnvloeden de cashflow. Waar te verkrijgen 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.
Waarom het belangrijk is Kritiek foutpunt dat herstel of een nieuwe poging vereist. Draagt bij aan het 'Payment Exception Rate'. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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.
Waarom het belangrijk is Volgt de inspanning besteed aan omzetbescherming. Belangrijk voor 'Percentage Herstelwerk Betalingen'. Waar te verkrijgen 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.
Waarom het belangrijk is Belangrijke compliance- en risico-indicator. Stuurt de 'Compliance Incident Rate' aan en vereist onmiddellijke handmatige interventie. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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.
Waarom het belangrijk is Positieve uitkomst voor risicobeheer. Compenseert de financiële impact van de initiële chargeback. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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 autorisapakketespons.
Waarom het belangrijk is Hoge risicoscores kunnen handmatige beoordelingen of automatische weigeringen activeren, wat knelpunten of procesafsluitingspunten creëert. Waar te verkrijgen 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.
Waarom het belangrijk is Ondersteunt direct de analyse van het 'Payment Transaction Failure Rate' door technische versus financiële storingen te categoriseren. Waar te verkrijgen 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.
Waarom het belangrijk is Sluit de cyclus van het terugbetalingsproces af. Belangrijk voor 'Gemiddelde foutoplossingstijd' als de terugbetaling het gevolg was van een fout. Waar te verkrijgen 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.
Waarom het belangrijk is Duiding van een post-settlement uitzondering. Hoge terugbetalingspercentages kunnen wijzen op upstream kwaliteitsissues. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode '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.
Waarom het belangrijk is Vertegenwoordigt de daadwerkelijke geldoverdracht naar het bedrijf, gekoppeld aan 'Doorlooptijd Reconciliatie Betaling'. Waar te verkrijgen Adyen Notificatie Webhook: gebeurtenisCode 'PAYOUT_THIRD_PARTY' of afgeleid uit Payout Report. Vastleggen Koppel Payout Report batch ID aan Transactie-ID Gebeurtenistype inferred

Aanbevolen Optioneel

Extractiegidsen

Hoe u je data van Adyen krijgt

Stappen

Log in op de Adyen Klant 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 Valuta, Gross Debit, Gross Credit, Exchange Rate, Net Valuta, 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 belangrijke transformaties uit: het 'unpivots' de Creation Date om 'Payment Request Received'-gebeurtenissen 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 Bronsysteem 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 (Activiteit), 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 Klant 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 gebeurtenissen like Settlement, Chargebacks, Refunds) and the Received Payment Detail Report (for operational gebeurtenissen 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.
Activiteit 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 gebeurtenissen.
Activiteit Mapping - Financial: Process the Settlement Detail Report. This report contains a JournalType column. Map waardes 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: Koppeling 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: Hernoemen columns to match the target schema: PspReference, EventCode, EventDate, Bronsysteem (hardcoded to 'Adyen'), and PaymentBedrag. Ensure dates are parsed to ISO 8601 format.
Filtering: Filter out internal reconciliation rows that do not represent process steps (e.g., header-rijs or balance carry-overs) using the Type filter.
Final Export: The script exports the processed DataFrame to a CSV file named adyen_gebeurtenis_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: Belangrijk 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 betalingsverwerking datatemplate

Uw betalingsverwerking datatemplate

Attributen Betalingsverwerkingingng

Activiteiten Betalingsverwerkingingng

Extractiegidsen

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 Betalingsverwerkingingng in Adyen Vandaag.

Uw betalingsverwerking datatemplate

Uw betalingsverwerking datatemplate

Attributen Betalingsverwerkingingng

Activiteiten Betalingsverwerkingingng

Extractiegidsen

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 Betalingsverwerkingingng in Adyen Vandaag.