> Průběžné zlepšování procesů > Zpracování plateb > Adyen > Datová šablona

Šablona dat pro zpracování plateb

Adyen

Atributy zpracování plateb(19) Aktivity při zpracování plateb(16) Návody k extrakci dat(2)

Šablona dat pro zpracování plateb

Tato šablona vám pomůže shromáždit potřebná data pro analýzu zpracování plateb v Adyen. Obsahuje přehled důležitých datových atributů a aktivit procesu, které je vhodné sledovat, i praktický návod k extrakci dat. Pomocí šablony zajistíte, že zachytíte všechny údaje potřebné pro process mining.

Doporučené atributy ke sběru
Důležité aktivity ke sledování
Praktický návod k extrakci dat z Adyen

Pracujete se záznamy událostí poprvé? Přečtěte si, jak vytvořit záznam událostí pro process mining.

Stáhnout šablonu

Atributy zpracování plateb

Toto jsou doporučená datová pole pro záznam událostí, který slouží k podrobné analýze zpracování plateb v Adyen.

5 Povinné 6 Doporučené 8 Volitelné

	Název	Popis
	Časové razítko události EventDate	Datum a čas, kdy došlo ke konkrétní platební aktivitě.
Popis Tento atribut zaznamenává přesné časové razítko události, například autorizace nebo vypořádání, tak jak byla zaznamenána v systému. Umožňuje seřadit aktivity v případu podle času. Při analýze je zásadní pro výpočet doby průchodu, hledání úzkých míst a sledování propustnosti systému v čase. Slouží pro všechny časové KPI, například „Celková doba platebního cyklu“. Proč je to důležité Nezbytný pro řazení událostí a výpočet všech metrik založených na době trvání. Kde data získat Pole „eventDate“ v Adyen Notification Webhooks. Příklady 2023-10-27T10:00:00+01:002023-10-27T10:05:30+01:002023-10-28T09:15:00+01:00
	ID platební transakce PspReference	Jedinečný referenční identifikátor, který Adyen přiřazuje každé platební transakci.
Popis Tento atribut slouží jako primární klíč pro celý životní cyklus platby v prostředí Adyen. Propojuje původní požadavek na platbu s následnými událostmi, jako jsou autorizace, stržení a vypořádání, případně vrácení platby nebo reklamace. Při analýze se toto ID používá ke spojení jednotlivých událostí do jednoho případu, což umožňuje rekonstruovat celý proces. Analytici tak mohou sledovat konkrétní průběh platby od zahájení zákazníkem až po konečné finanční vypořádání. Proč je to důležité Jde o základní identifikátor, který při process miningu spojuje nesouvisející události do jedné instance procesu. Kde data získat Pole 'pspReference' v Adyen Payment Response nebo sloupec 'PSP Reference' v Settlement Detail Report. Příklady 851564567890123479145612345678908825641234567890
	Název aktivity EventCode	Konkrétní fáze nebo úkon, ke kterému dochází během životního cyklu platby.
Popis Tento atribut určuje konkrétní událost, ke které došlo, například AUTHORISATION, CAPTURE nebo REFUND. Určuje uzly v mapě procesů a průběh transakce. Při analýze se tyto kódy převádějí na srozumitelné názvy aktivit, aby bylo možné zobrazit průběh procesu. Rozdíly v pořadí kódů ukazují různé cesty procesem, například automatické zpracování bez zásahu nebo řešení výjimek. Proč je to důležité Určuje, co se v modelu process mining zobrazuje, a umožňuje vizualizovat průběh procesů. Kde data získat Pole „eventCode“ v Adyen Notification Webhooks. Příklady AUTHORISATIONCAPTUREREFUNDCANCELLATIONCHARGEBACK
	Poslední aktualizace dat LastDataUpdate	Časové razítko poslední extrakce nebo aktualizace záznamu.
Popis Tento atribut ukazuje, jak aktuální jsou data v modelu process mining. Pomáhá zjistit, zda pracujete s aktuálními daty, nebo se snímkem dat. Jde především o technické pole pro správu dat a ověření, že datový tok funguje správně. Proč je to důležité Technické pole pro sledování aktuálnosti dat. Kde data získat Systémový čas při extrakci. Příklady 2023-10-30T12:00:00Z
	Zdrojový systém SourceSystem	Název systému, ze kterého data pocházejí.
Popis Tento statický atribut označuje, že záznam pochází z Adyen. Při process mining z více systémů, například při spojení Adyen a SAP, je zásadní pro sledování původu dat. Umožňuje filtrovat aktivity, ke kterým došlo přímo v platební bráně, a odlišit je od aktivit v ERP nebo systému pro správu objednávek. Proč je to důležité Zásadní pro sledování původu dat při process mining z více systémů. Kde data získat Statická hodnota při extrakci. Příklady AdyenAdyen_Production
	Částka transakce PaymentAmount	Peněžní hodnota platební transakce.
Popis Tento atribut představuje finanční hodnotu transakce. V nezpracovaných datech se obvykle ukládá v nejmenších měnových jednotkách, například v centech, ale pro reporting je třeba ji převést. Umožňuje sestavit dashboard „Objem zpracovaných plateb“ a upřednostnit případy s opakovaným zpracováním a vysokou hodnotou. Používá se také k výpočtu celkového zpracovaného objemu a finančního dopadu neúspěšných transakcí. Proč je to důležité Potřebný k analýze finančního dopadu a sledování objemu zpracování. Kde data získat Pole „amount.value“ v požadavku Adyen Payment. Příklady 10005509900
	Důvod zamítnutí RefusalReason	Textové vysvětlení, proč byla platba zamítnuta nebo se nezdařila.
Popis Pokud se transakce nezdaří, Adyen uvede kód nebo popis důvodu, například „Nedostatečný zůstatek“, „CVC zamítnuto“ nebo „Platnost karty vypršela“. Při analýze je tento atribut hlavním podkladem pro dashboard „Míra neúspěšných platebních transakcí“. Analýza důvodů pomáhá určit, zda za neúspěchem stojí technické potíže, pravidla proti podvodům, nebo chování zákazníků, a zvolit konkrétní nápravná opatření. Proč je to důležité Zásadní atribut pro hledání příčin neúspěšných plateb. Kde data získat Pole „refusalReason“ v odpovědi Adyen Payment. Příklady ZamítnutoNedostatečný zůstatekPlatnost karty vypršelaChyba acquireraPodvod
	Opakované zpracování IsRework	Příznak, který udává, zda transakce zahrnovala opakované pokusy nebo opravy chyb.
Popis Logická hodnota je true, pokud případ obsahuje více pokusů o autorizaci nebo aktivity jako „Platba zamítnuta“ následované opakováním pokusu. Tento atribut slouží jako podklad pro dashboard „Opakované zpracování plateb a místa s výjimkami“. Analytici mohou filtrovat problematické případy a zjistit, proč proces neprobíhá obvyklou cestou. Proč je to důležité Odhaluje neefektivní případy, které vyžadují ruční zásah nebo zásah systému. Kde data získat Vypočítá se podle toho, zda počet neúspěšných událostí přesahuje 0. Příklady truefalse
	Stav platby PaymentStatus	Aktuální stav platby, například autorizována, vypořádána nebo zamítnuta.
Popis Tento atribut uvádí poslední známý stav platební transakce. Často se odvozuje od poslední aktivity v případu. Umožňuje rychle filtrovat případy, například zobrazit všechny aktuálně zamítnuté platby. Je nezbytný pro dashboard „Objem a sledování stavu plateb“. Proč je to důležité Poskytuje přehled o aktuálním stavu transakce. Kde data získat Odvozuje se od posledního kódu události v případu. Příklady VypořádánoZamítnutoAutorizováno
	Účet obchodníka MerchantAccount	Konkrétní účet obchodníka v Adyen, přes který se zpracovává transakce.
Popis Adyen umožňuje mít pod jedním firemním účtem více účtů obchodníků. Tento atribut určuje, která obchodní jednotka, značka nebo regionální společnost platbu zpracovala. Při analýze slouží jako hlavní dimenze pro segmentaci. Umožňuje porovnat výkonnost, míru neúspěšných transakcí a jejich objem mezi obchodními jednotkami nebo značkami a určit oblasti, které je třeba zlepšit. Proč je to důležité Umožňuje porovnávat výkonnost podle obchodních jednotek nebo dceřiných společností. Kde data získat Pole „merchantAccount“ v požadavku nebo odpovědi Adyen Payment. Příklady MyStore_UKMyStore_USGlobalSales_Main
	Způsob platby PaymentMethod	Konkrétní způsob, kterým zákazník platí, například Visa nebo PayPal.
Popis Tento atribut zachycuje typ použitého platebního prostředku, například značku kreditní karty (Visa, MC), digitální peněženku (PayPal, Apple Pay) nebo místní platební metodu (iDEAL, Sofort). Při analýze je důležitý pro dashboard „Přehled výkonnosti platebních metod“. Pomáhá odhalit souvislosti mezi konkrétní platební metodou a mírou autorizace, rychlostí zpracování nebo technickými chybami. Proč je to důležité Umožňuje analyzovat úspěšnost a náklady u různých poskytovatelů plateb. Kde data získat Pole „paymentMethod.brand“ nebo „paymentMethod.type“ v odpovědi Adyen Payment. Příklady visamcpaypalidealklarna
	Autorizační kód AuthorisationCode	Autorizační kód, který vydavatel karty vrátí při schválení.
Popis Kód potvrzující, že prostředky byly na kartě zákazníka rezervovány. Dokládá úspěšnou autorizaci. Při analýze slouží především k auditu a dohledatelnosti. Ověřuje, že aktivita „Platba autorizována“ proběhla oprávněně. Proč je to důležité Doklad o úspěšné autorizaci pro potřeby auditu. Kde data získat Pole „authCode“ v odpovědi Adyen Payment. Příklady 123456098712
	Číslo dávky vypořádání BatchNumber	Číslo dávky spojené s vypořádáním prostředků.
Popis Adyen sdružuje vypořádané platby do dávek, které se následně vyplácejí. Tento atribut určuje, do které dávky konkrétní transakce patří. Při analýze se používá ke skupinování plateb podle výplatního cyklu. Pomáhá kontrolovat, zda se některé dávky nezpožďují, a sledovat aktivitu „Platba vypořádána“. Proč je to důležité Propojuje jednotlivé transakce s hromadným finančním vypořádáním. Kde data získat Pole „Batch Number“ v Adyen Settlement Detail Report. Příklady 100255
	ID zákazníka ShopperReference	Jedinečný identifikátor, který umožňuje rozpoznat zákazníka napříč transakcemi.
Popis Tento identifikátor propojuje různé transakce se stejným zákazníkem. Obchodník jej předává v požadavku na platbu. Při analýze umožňuje sledovat transakce z pohledu zákazníka a odhalovat opakované podvodné jednání nebo věrné zákazníky při analýze úspěšných transakcí. Slouží také k obecnému mapování „Zákazník“. Proč je to důležité Umožňuje agregovat data a analyzovat chování na úrovni zákazníka. Kde data získat Pole „shopperReference“ v požadavku Adyen Payment. Příklady CUST-001user_12345email@example.com
	Měna PaymentCurrency	Třípísmenný kód ISO označující měnu transakce.
Popis Tento atribut určuje měnu, ve které je vyjádřena hodnota `PaymentAmount`. Mezi běžné hodnoty patří EUR, USD nebo GBP. Při analýze se používá ke seskupování transakcí podle trhu a k převedení finančních hodnot na srovnatelný základ při agregaci dat z různých regionů. Proč je to důležité Určuje, v jaké měně je částka uvedena, což je důležité pro reporting ve více měnách. Kde data získat Pole „amount.currency“ v požadavku Adyen Payment. Příklady EURUSDGBP
	Reference acquirera AcquirerReference	Referenční číslo poskytnuté bankou acquirera.
Popis Jde o externí referenci, kterou transakci kartou přidělila finanční instituce (acquirer), jež ji zpracovává. Liší se od reference PSP v Adyen. Toto pole je důležité pro „Analýzu zpoždění při párování plateb“. Slouží k párování záznamů Adyen s bankovními výpisy v externích účetních knihách. Proč je to důležité Nezbytná pro třístranné párování a externí odsouhlasení. Kde data získat Pole „additionalData.acquirerReference“ v odpovědi Adyen Payment. Příklady 1234567890987654321
	Skóre rizika podvodu RiskScore	Skóre rizika, které transakci přidělil systém pro odhalování podvodů.
Popis Systém RevenueProtect od Adyen přiřazuje číselné skóre od 0 do 100, které vyjadřuje pravděpodobnost podvodu. Vyšší skóre často vede k ruční kontrole nebo automatickému zablokování. Při analýze slouží jako podklad pro „Přehled rizik finanční shody“. Porovnání vysokého skóre rizika s chargebacky pomáhá upravit pravidla proti podvodům. Pokud platby s vysokým skóre přesto proběhnou úspěšně, může to ukazovat na falešně pozitivní výsledky rizikového modelu. Proč je to důležité Nezbytný pro analýzu účinnosti pravidel pro prevenci podvodů. Kde data získat Odpověď Adyen Risk API nebo pole „fraudResult.accountScore“ v reportu. Příklady 025100
	Typ interakce se zákazníkem ShopperInteraction	Udává, zda šlo o platbu v e-shopu, na POS terminálu, nebo o předplatné (ContAuth).
Popis Tento atribut rozlišuje způsob interakce zákazníka s obchodníkem. Běžné hodnoty jsou `Ecommerce` (online), `POS` (v kamenné prodejně) a `ContAuth` (opakovaná platba nebo předplatné). Při analýze pomáhá rozlišit různé obchodní modely a prodejní kanály. Průběh procesu se u POS a Ecommerce často výrazně liší, proto je tento atribut důležitým filtrem pro přesné mapování procesů. Proč je to důležité Rozlišuje průběh procesů u online plateb, plateb v prodejně a opakovaných plateb. Kde data získat Pole „shopperInteraction“ v požadavku Adyen Payment. Příklady EcommerceContAuthPOSMoto
	Země zákazníka ShopperCountry	Dvoupísmenný kód země zákazníka.
Popis Tento atribut označuje polohu zákazníka, obvykle podle země vydání karty nebo fakturační adresy. Při analýze slouží k porovnání výkonnosti v jednotlivých regionech. Pomáhá zjistit, zda je v některých zemích vyšší míra zamítnutí nebo delší doba zpracování kvůli místní bankovní infrastruktuře. Proč je to důležité Umožňuje porovnávat výkonnost plateb podle geografické oblasti. Kde data získat Pole „countryCode“ nebo „billingAddress.country“ v požadavku Adyen Payment. Příklady NLUSDE

Povinné Doporučené Volitelné

Aktivity při zpracování plateb

Toto jsou důležité kroky a milníky procesu, které je vhodné zachytit v záznamu událostí pro přesné zjištění průběhu plateb v Adyen.

5 Doporučené 11 Volitelné

	Aktivita	Popis
	Platba autorizována	Vydavatel karty nebo poskytovatel platební metody transakci schválil a prostředky jsou rezervovány. Událost se zaznamenává prostřednictvím standardního webhooku Adyen.
Proč je to důležité Důležitý milník potvrzující platnost transakce a dostupnost prostředků. Je podmínkou pro stržení platby. Kde data získat Webhook Adyen Notification: eventCode 'AUTHORISATION' se success='true'. Zachycení Zaznamená se při úspěšném webhooku AUTHORISATION Typ události explicit
	Platba stržena	Příkaz k převodu prostředků od zákazníka obchodníkovi byl úspěšně zpracován. Stržení může proběhnout ihned (automatické stržení) nebo později (ruční stržení).
Proč je to důležité Potvrzuje zaúčtování výnosu. Doba mezi autorizací a stržením je důležitá pro KPI „Doba od autorizace platby do stržení“. Kde data získat Webhook Adyen Notification: eventCode 'CAPTURE' se success='true'. Zachycení Zaznamená se při úspěšném webhooku CAPTURE Typ události explicit
	Platba vypořádána	Prostředky byly úspěšně zúčtovány a připsány na účet obchodníka v Adyen. Tato událost je uvedena v Settlement Detail Report.
Proč je to důležité Finanční zakončení úspěšného procesu. Je důležité pro KPI „Celková doba zpracování platby“ a „Analýza zpoždění při párování plateb“. Kde data získat Adyen Settlement Detail Report (SDR), typ záznamu 'Settled'. Zachycení Zaznamená se, když se transakce objeví v Settlement Report Typ události explicit
	Platba zamítnuta	Vydavatel karty nebo pravidla řízení rizik Adyen transakci zamítly. Událost se zaznamenává prostřednictvím webhooku autorizace se stavem neúspěchu.
Proč je to důležité Přímo ovlivňuje KPI „Míra neúspěšných platebních transakcí“. Analýza důvodů zamítnutí pomáhá zvýšit míru autorizace. Kde data získat Webhook Adyen Notification: eventCode 'AUTHORISATION' se success='false'. Zachycení Zaznamená se při neúspěšném webhooku AUTHORISATION Typ události explicit
	Přijata žádost o platbu	Platební platforma Adyen poprvé přijme požadavek na transakci. Tuto událost lze zaznamenat podle časové značky prvního požadavku API nebo vytvoření pspReference.
Proč je to důležité Označuje přesný začátek instance procesu. Je nezbytná pro výpočet celkové doby zpracování od začátku do konce. Kde data získat Záznamy Adyen Payment API nebo časová značka spojená s vytvořením pspReference. Zachycení Zaznamená se při vytvoření pspReference prostřednictvím API Typ události explicit
	Platba odeslána k vypořádání	Adyen předala transakci zúčtovací bance nebo síti k finančnímu zpracování. Stav se změní na SentForSettlement.
Proč je to důležité Označuje přechod od provozního zpracování k finančnímu zúčtování. Zpoždění v této fázi ovlivňuje peněžní tok. Kde data získat Adyen Transaction Status API nebo událost odvozená ze záznamů historie změn stavu. Zachycení Porovnejte změnu pole stavu na SentForSettlement Typ události inferred
	Platba zrušena	Autorizace byla zrušena před stržením prostředků. Rezervované prostředky se tím uvolní na kartě zákazníka.
Proč je to důležité Jde o smyčku v procesu, kdy se platná objednávka ukončí před dokončením, často na žádost zákazníka nebo po vypršení časového limitu dostupnosti zboží. Kde data získat Webhook Adyen Notification: eventCode 'CANCELLATION'. Zachycení Zaznamená se při webhooku CANCELLATION Typ události explicit
	Přijato oznámení o reklamaci platby	Adyen obdržela od karetní asociace oznámení o sporu. Tím se spustí workflow pro řešení sporu.
Proč je to důležité Důležitý ukazatel dodržování pravidel a rizika. Ovlivňuje „Míru incidentů v oblasti dodržování pravidel“ a vyžaduje okamžitý ruční zásah. Kde data získat Webhook Adyen Notification: eventCode 'CHARGEBACK' nebo 'NOTIFICATION_OF_CHARGEBACK'. Zachycení Zaznamená se při webhooku CHARGEBACK Typ události explicit
	Provedena kontrola rizik	Nástroj RevenueProtect od Adyen analyzuje transakci a hledá známky podvodu. Událost lze odvodit z přítomnosti skóre podvodu nebo výsledku kontroly rizik v odpovědi na autorizaci.
Proč je to důležité Vysoké skóre rizika může vést k ruční kontrole nebo automatickému zamítnutí, a tím vytvořit úzké místo nebo ukončit proces. Kde data získat Odpověď Adyen Payment (pole fraudResult) nebo záznamy Case Management. Zachycení Odvozeno z přítomnosti objektu fraudResult Typ události inferred
	Reklamace platby obhájena	Adyen byly předloženy důkazy na podporu námitky proti reklamaci platby. Jde o opakovaný nebo ruční úkon v procesu řešení sporu.
Proč je to důležité Sleduje úsilí věnované ochraně výnosů. Je důležitý pro ukazatel „Míra opakovaného zpracování plateb“. Kde data získat Adyen Disputes API nebo záznamy Case Management potvrzující odeslání důkazů. Zachycení Odvozeno ze změny stavu na 'Defense Supplied' Typ události inferred
	Reklamace platby zrušena	Spor byl vyřešen ve prospěch obchodníka a prostředky mu byly vráceny. Jde o úspěšné vyřešení výjimky.
Proč je to důležité Příznivý výsledek pro řízení rizik. Vyrovnává finanční dopad původní reklamace platby. Kde data získat Webhook Adyen Notification: eventCode 'CHARGEBACK_REVERSED'. Zachycení Zaznamená se při webhooku CHARGEBACK_REVERSED Typ události explicit
	Stržení platby se nezdařilo	Pokus o stržení autorizovaných prostředků se nezdařil. Příčinou bývá technický časový limit nebo změna stavu karty mezi autorizací a stržením.
Proč je to důležité Závažná chyba, která vyžaduje opakování úkonu nebo nový pokus. Přispívá k hodnotě „Míra výjimek u plateb“. Kde data získat Webhook Adyen Notification: eventCode 'CAPTURE_FAILED'. Zachycení Zaznamená se při webhooku CAPTURE_FAILED Typ události explicit
	Vrácení platby vypořádáno	Vrácení platby bylo finančně zpracováno a částka byla odečtena z účtu obchodníka. Potvrzuje se v Settlement Detail Report.
Proč je to důležité Uzavírá proces vrácení platby. Pokud byla platba vrácena kvůli chybě, je tato událost důležitá pro ukazatel „Průměrná doba řešení chyby“. Kde data získat Adyen Settlement Detail Report, typ záznamu 'Refunded' nebo 'RefundedReversed'. Zachycení Zaznamená se, když se vrácení platby objeví v Settlement Report Typ události explicit
	Výplata potvrzena	Prostředky za dávku vypořádaných transakcí byly odeslány na bankovní účet obchodníka.
Proč je to důležité Představuje skutečný převod peněz obchodníkovi a souvisí s ukazatelem „Doba párování plateb“. Kde data získat Webhook Adyen Notification: eventCode 'PAYOUT_THIRD_PARTY' nebo událost odvozená z Payout Report. Zachycení Propojte ID dávky z Payout Report s ID transakce Typ události inferred
	Zahájeno vrácení platby	Byl zadán požadavek na vrácení prostředků zákazníkovi. Tím začíná opačný průběh procesu.
Proč je to důležité Označuje výjimku po vypořádání. Vysoký podíl vrácených plateb může ukazovat na problémy s kvalitou v předchozích fázích. Kde data získat Webhook Adyen Notification: eventCode 'REFUND'. Zachycení Zaznamená se při spuštění webhooku REFUND Typ události explicit
	Zaznamenána technická chyba	Při zpracování došlo k systémové chybě, například selhal webhook nebo vypršel časový limit API. Chybu lze rozpoznat podle konkrétních chybových kódů v rozhraní.
Proč je to důležité Přímo podporuje analýzu „Míry neúspěšných platebních transakcí“ tím, že rozlišuje technické a finanční chyby. Kde data získat Záznamy Adyen Interface nebo konkrétní chybové odpovědi volání API. Zachycení Zaznamená se při vrácení chybové odpovědi s kódem 5xx nebo 4xx Typ události explicit

Doporučené Volitelné

Návody k extrakci dat

Jak získat data z Adyen

Kroky

Přihlaste se do Adyen Customer Area pomocí uživatelského účtu s rolí Merchant Report.
Přejděte do části Reports a v nabídce vyberte Settlement details.
Vyhledejte nastavení Automatic generation, nebo pro jednorázový export zvolte Generate report.
V panelu nastavení zkontrolujte, že je u položky Format vybráno CSV (hodnoty oddělené čárkami).
V části Include columns vyberte All, případně zaškrtněte konkrétně: 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 a Interchange.
DŮLEŽITÉ: Zkontrolujte, že přehled zahrnuje všechny Journal Types (Settled, Refunded, Chargeback, PaidOut atd.), aby zachytil celý finanční cyklus.
Vygenerujte přehled za požadované období, například za posledních 90 dní. Přehledy vypořádání se generují podle data dávky vypořádání, nikoli podle data transakce.
Stáhněte vygenerovaný soubor CSV do místního prostředí pro extrakci dat.
Spusťte transformační skript uvedený níže. Převede širokou tabulku CSV do formátu záznamu událostí, který ProcessMind vyžaduje.
Skript provede důležité transformace: z pole Creation Date vytvoří události „Přijata žádost o platbu“ a hodnoty ve sloupci Type namapuje na konkrétní finanční aktivity.
Zkontrolujte, že výstupní soubor CSV obsahuje záhlaví: PspReference, EventCode, EventDate, SourceSystem.
Nahrajte výsledný transformovaný soubor CSV do ProcessMind.

Konfigurace

Typ přehledu: Settlement Detail Report (finanční kniha)
Formát souboru: CSV (standardní oddělení čárkami)
Podrobnost: Úroveň transakce (jeden řádek na každou finanční účetní položku)
Časové pásmo: UTC (důrazně doporučeno, aby se extrakce dala sladit s ostatními systémy)
Časové období: Řídí se dávkami vypořádání (datem uzavření dávky), nikoli datem vytvoření transakce. Při postupném načítání počítejte s překryvem období.
Povinné sloupce: Psp Reference (klíč), Type (aktivita), Creation Date, Booking Date (časová razítka událostí), Merchant Account.
Nastavení filtrů: Zkontrolujte, že žádné filtry nevylučují typy 'Chargeback' ani 'Refund', aby byl proces zachycen celý.

Ukázkový dotaz python

import pandas as pd
from datetime import datetime

class=class="hl-string">"hl-comment"># CONFIGURATION
INPUT_FILE = class="hl-string">'settlement_detail_report.csv'
OUTPUT_FILE = class="hl-string">'adyen_event_log.csv'
SOURCE_SYSTEM = class="hl-string">'Adyen'

class=class="hl-string">"hl-comment"># Load the Adyen Settlement Detail Report
class=class="hl-string">"hl-comment"># 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)

class=class="hl-string">"hl-comment"># Define the output list
event_log = []

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

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

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

    class=class="hl-string">"hl-comment"># --- 2. MAPPED FINANCIAL ACTIVITIES ---
    class=class="hl-string">"hl-comment"># Map Adyen Ledger Types to Process Activities using Booking Date
    
    if journal_type == class="hl-string">'Settled':
        add_event(psp_ref, class="hl-string">'Payment Settled', booking_date, row_attrs)
        
        class=class="hl-string">"hl-comment"># Activity: Payment Sent for Settlement
        class=class="hl-string">"hl-comment"># Inferred: Occurs shortly before settlement. 
        class=class="hl-string">"hl-comment"># 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, class="hl-string">'Payment Sent for Settlement', sent_date, row_attrs)

    elif journal_type == class="hl-string">'Refunded':
        add_event(psp_ref, class="hl-string">'Refund Initiated', creation_date, row_attrs)
        add_event(psp_ref, class="hl-string">'Refund Settled', booking_date, row_attrs)

    elif journal_type == class="hl-string">'Chargeback':
        add_event(psp_ref, class="hl-string">'Chargeback Notification Received', booking_date, row_attrs)

    elif journal_type == class="hl-string">'ChargebackRetried':
        add_event(psp_ref, class="hl-string">'Chargeback Defended', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

    elif journal_type == class="hl-string">'ChargebackReversed':
        add_event(psp_ref, class="hl-string">'Chargeback Reversed', booking_date, row_attrs)

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

    elif journal_type == class="hl-string">'CaptureFailed':
        add_event(psp_ref, class="hl-string">'Capture Failed', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

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

    elif journal_type == class="hl-string">'Error':
        add_event(psp_ref, class="hl-string">'Technical Error Logged', booking_date, {class="hl-string">'IsRework': class="hl-string">'True'})

class=class="hl-string">"hl-comment"># Convert to DataFrame
events_df = pd.DataFrame(event_log)

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

class=class="hl-string">"hl-comment"># Output
events_df.to_csv(OUTPUT_FILE, index=False)
print(fclass="hl-string">'Successfully extracted {len(events_df)} events to {OUTPUT_FILE}')

Kroky

Předběžné nastavení: Zkontrolujte, že máte uživatele Adyen Report s povolenou rolí Merchant Report. Získejte svůj API Key v Adyen Customer Area v části Developers > API Credentials.
Určení potřebných přehledů: Extrakce využívá dva důležité přehledy CSV generované službou Adyen: Settlement Detail Report (finanční události, například vypořádání, chargebacky a refundace) a Received Payment Detail Report (provozní události, například žádosti, zamítnutí a autorizace).
Nastavení prostředí Pythonu: Pomocí pip nainstalujte potřebné knihovny: pandas, requests a numpy. Využijete je pro komunikaci s API a transformaci dat.
Navázání spojení s API: V níže uvedeném skriptu Python nastavte ověřování vůči koncovému bodu https://management-test.adyen.com nebo https://management-live.adyen.com. Pomocí Report API vypíšete dostupné přehledy pro zvolené období a stáhnete jejich adresy URL.
Načtení dat: Skript načte surová data CSV do datových rámců pandas. Přehledy Adyen obvykle mají široký formát, tedy jeden řádek na transakci a několik sloupců se stavem, proto je nutná transformace.
Mapování aktivit, provozní data: Zpracujte Received Payment Detail Report. Namapujte CreationDate na Přijata žádost o platbu. Podle hodnot ve sloupci Status (například Authorised, Refused, Error) vytvořte události Platba autorizována, Platba zamítnuta nebo Zaznamenána technická chyba.
Mapování aktivit, finanční data: Zpracujte Settlement Detail Report. Tento přehled obsahuje sloupec JournalType. Hodnoty jako Settled namapujte na Platba vypořádána, Refunded na Zahájena refundace a Chargeback na Přijato oznámení o chargebacku.
Odvození složitějších aktivit:
- Provedena kontrola rizik: Zkontrolujte, zda je sloupec FraudScore vyplněný a jeho hodnota je vyšší než -1.
- Potvrzena výplata: Propojte transakce pomocí BatchNumber se záznamem výplaty v přehledu vypořádání.
- Chargeback obhájen: Vyhledejte typy účetních položek SecondChargeback nebo Defense.
Transformace dat: Pomocí operace 'melt' nebo 'stack' v pandas převeďte širokou datovou sadu na dlouhý záznam událostí, kde každá aktivita tvoří samostatný řádek.
Sjednocení atributů: Přejmenujte sloupce podle cílového schématu: PspReference, EventCode, EventDate, SourceSystem (nastavte pevně na 'Adyen') a PaymentAmount. Zkontrolujte, že jsou data převedena do formátu ISO 8601.
Filtrování: Pomocí filtru Type odstraňte interní řádky pro párování, které nepředstavují kroky procesu, například řádky záhlaví nebo převody zůstatků.
Závěrečný export: Skript exportuje zpracovaný DataFrame do souboru CSV adyen_event_log.csv, který je připravený k nahrání do ProcessMind.

Konfigurace

Prostředí API: Podle fáze nasazení přepínejte mezi testovacím prostředím Adyen (management-test.adyen.com) a produkčním prostředím (management-live.adyen.com).
Ověřování: V hlavičce použijte x-api-key. Pro Management API nepoužívejte Basic Auth.
Typy přehledů:
- settlement_detail_report: Důležitý pro události finančního cyklu.
- received_payment_detail_report: Důležitý pro počáteční žádost a logiku autorizace.
Časové období: Přehledy Adyen se generují podle uzavření dávky. Požadujte přehledy za období zahrnující požadované CreationDate a dalších 7 dní, abyste zachytili i pozdější vypořádání.
Rozsah účtů obchodníka: Pokud máte více účtů obchodníka, projděte je všechny, případně použijte přehled na úrovni Company Account, pokud je k dispozici.
Nastavení pandas: Pokud objem transakcí přesahuje 100 000 řádků, při čtení souborů CSV nastavte low_memory=False, abyste předešli chybám při určování datových typů.

Ukázkový dotaz 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.')

Chcete začít?

Pomocí této šablony si usnadníte sběr dat a můžete začít optimalizovat zpracování plateb v Adyen. Odhalte možnosti, jak zefektivnit provoz, a získejte podrobnější přehled o finančních operacích.

Zpět na průvodce zlepšováním

Stáhnout šablonu

Zefektivněte zpracování plateb v Adyen ještě dnes.

Dosáhněte 98% podílu automatického zpracování bez zásahu a odstraňte výjimky při platbách.

Začněte používat zkušební verzi

Platební kartu nepotřebujete. S optimalizací můžete začít hned.

Šablona dat pro zpracování plateb

Šablona dat pro zpracování plateb

Atributy zpracování plateb

Aktivity při zpracování plateb

Návody k extrakci dat

Export přehledu podrobností o vypořádání v Adyen

Kroky

Konfigurace

Ukázkový dotaz python

Extrakce v Pythonu přes Reporting API

Kroky

Konfigurace

Ukázkový dotaz python

Chcete začít?

Zefektivněte zpracování plateb v Adyen ještě dnes.