Administrace systému GP webpay Role: Merchant Verze: 1.1 Global Payments Europe, s.r.o. Vytvořeno 14.8.2015 Poslední změna 14.12.2015
Autor dokumentu Dimitrij Holovka Správce dokumentu Schválil Verze 1.1 Stupeň utajení Důvěrné Historie dokumentu: Verze Datum Provedl Komentář 1.0 14.08.2015 D. Holovka Nová šablona, verzování 1.1 14.12.2015 D. Holovka Drobné opravy Obsah 1. Právní doložka... 3 2. Úvod... 4 3. Přihlášení do aplikace... 4 4. Základní nabídka pro roli Merchant... 5 4.1 Administrace... 6 4.1.1 Změna hesla... 6 4.1.2 Zdroje ke stažení... 7 4.1.3 Uživatelé... 8 4.2 Zpracování objednávek... 8 4.2.1 Objednávky... 8 4.2.2 Úhrada objednávek... 13 4.2.3 Vymazání neukončených objednávek... 14 4.3 Práce s dávkami... 17 4.3.1 Vyhledání dávek... 17 4.3.2 Uzavření dávek... 19 4.4 Odhlášení... 20 5. Chybové stavy... 20 6. Přílohy... 23 6.1 6.2 Stavy objednávky... 23 Podporované požadavky/transakce... 25 6.3 Návratové kódy... 27 6.3.1 PRCODE - PrimaryReturnCode... 27 6.3.2 SRCODE SecondaryReturnCode... 28 Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 2 / 30
1. Právní doložka Tento dokument včetně všech případných příloh a odkazů je určen výhradně pro potřeby poskytovatele služeb e-shopu (dále jen Zákazník ). Informace v tomto dokumentu obsažené (dále jen Informace ) jsou předmětem duševního vlastnictví a ochrany autorských práv společnosti Global Payments Europe, s.r.o. (dále jen GPE ) a mají povahu obchodního tajemství v souladu s ust. 504 zák. č. 89/2012 Sb., Občanský zákoník. Zákazník si je vědom právních povinností ve vztahu k nakládání s Informacemi. Informace nebo kterákoliv její část nesmí být bez předchozího výslovného písemného souhlasu GPE poskytnuty nebo jakýmkoliv způsobem zpřístupněny třetí straně. Informace nesmí být zároveň využity Zákazníkem pro jiné účely, než pro účely ke kterému slouží. Pro vyloučení všech pochybností nesmí být Informace nebo kterákoliv část bez předchozího výslovného písemného souhlasu GPE poskytnuty nebo jakýmkoliv způsobem zpřístupněny ani společnostem poskytujícím služby zpracování plateb v prostředí internetu. GPE si v rozsahu dovoleném platným právem, vyhrazuje veškerá práva k této dokumentaci a k Informacím v ní obsažených. Jakékoliv rozmnožování, použití, vystavení či jiné zveřejnění nebo šíření Informací nebo její části metodami známými i dosud neobjevenými je bez předchozího písemného souhlasu společnosti GPE přísně zakázáno. GPE není jakkoliv odpovědná za jakékoliv chyby nebo opomenutí v Informacích. GPE si vyhrazuje právo, a to i bez uvedení důvodu, jakoukoliv Informaci změnit nebo zrušit. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 3 / 30
2. Úvod Dokument je určen pro obchodníky, kteří budou ve svém elektronickém obchodu přijímat platby, uskutečněné platebními kartami asociací MasterCard, VISA, Diners Club a AMEX, a to prostřednictvím internetové platební brány GP webpay. Aplikace GP webpay plně podporuje standard 3-D Secure a poskytuje možnost integrovat funkčnost standardního webového rozhraní formou Web Services. K aplikaci lze přistoupit přes URL adresu: https://3dsecure.gpwebpay.com/gui Pozn.: Všechny obrazovky uvedené v textu byly převzaty z testovacího prostředí Global Payments Europe, s.r.o., a proto jejich obsah nemusí naprosto přesně odpovídat obsahu obrazovek v reálném provozu aplikace. 3. Přihlášení do aplikace Po zadání URL adresy se automaticky zobrazí stránka pro přihlášení do aplikace. Povolen je pouze přístup zadáním uživatelského jména a hesla. Obr. 1: Přihlašovací obrazovka Na základě zadaných údajů aplikace zpřístupní konkrétní uživatelské prostředí. Heslo pro první přihlášení obdrží obchodník od administrátora aplikace GP webpay v Global Payments Europe (GPE) při převzetí smlouvy. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 4 / 30
Po přihlášení s tímto heslem GP webpay automaticky nabídne obrazovku pro změnu hesla. Zde obchodník formuluje svoje vlastní heslo, pod kterým se bude nadále přihlašovat. Je v jeho zájmu, aby toto heslo bylo co možná nejkomplikovanější, aby nebylo snadné heslo odvodit. V žádném případě by heslo nemělo být pouhým opakováním uživatelského jména, nevhodná jsou rovněž celá slova nebo řetězce po sobě následujících kláves na klávesnici, případně posloupnost za sebou jdoucích číslic, apod. Tato příručka popisuje všechny možnosti, které aplikace nabízí pro roli definovanou na straně uživatele aplikace, a to pro roli Merchant. Hlavním úkolem uživatele v roli Merchant (administrátor u obchodníka) je zpracování objednávek, tj. vyhledávání objednávek podle zadaných podmínek, úhrada objednávek, vyhledávání dávek, uzavření dávek, příp. vymazávání neukončených objednávek. 4. Základní nabídka pro roli Merchant Po úspěšném přihlášení uživatele se zobrazí úvodní stránka aplikace GP webpay. V záhlaví této, i všech dalších stránek, je kromě loga aplikace uvedeno ještě uživatelské jméno přihlášeného uživatele. Obsah panelu nabídek (tj. konkrétní uživatelské prostředí aplikace) odpovídá roli, přidělené přihlášenému uživateli. Kliknutím na odpovídající vlajku v pravém rohu záhlaví stránky lze pro GP webpay zvolit jazyk, ve kterém bude probíhat další komunikace. Obr. 2: Úspěšné přihlášení Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 5 / 30
Menu, určené pro uživatele s rolí Merchant: Administrace: Nastavení účtu změna hesla; Zdroje ke stažení možnost stažení dokumentace, podpůrných aplikací, certifikátů, log a příkladů; Uživatelé možnost upravit nastavení uživatelů přiřazených k vaší společnosti; Zpracování objednávek: Objednávky možnost vyhledávat objednávky na základě identifikace obchodníka nebo objednávky, podle stavu objednávky, data platby, případně měny a částky objednávky. Zobrazení přehledu nalezených objednávek, možnost zobrazit detail vybrané objednávky, včetně nabídky možných (povolených) transakcí; Úhrada objednávek zobrazení všech doposud neuhrazených objednávek (úspěšně autorizovaných), možnost zobrazit detail vybrané objednávky, včetně nabídky možných transakcí. Úhrada vybrané objednávky, anebo skupiny objednávek, Vymazání neukončených objednávek zobrazení přehledu neukončených objednávek, možnost zobrazit detailní data vybrané objednávky. Vymazání vybraných objednávek (jednotlivých, anebo všech); Vyhledání dávek možnost vyhledávat dávky obchodníka na základě identifikace dávky, podle stavu dávky, data otevření nebo zavření dávky. Zobrazení přehledu vyhledaných dávek s možností zobrazit detail vybrané dávky. Zobrazení přehledu objednávek zařazených do dávky, možnost zobrazit detail objednávky s nabídkou dalších možných transakcí. Možnost uzavřít otevřenou dávku; Uzavření dávek možnost uzavřít aktuálně otevřenou dávku a tím umožnit další operace s objednávkou; 4.1 Odhlášení odhlášení ze systému a ukončení práce s GUI Administrace Základní úkony pro nastavení přístupových práv, stažení dokumentace. 4.1.1 Změna hesla Výběrem volby Změna hesla z nabídky se vyvolá stránka Změna hesla. Zadává se původní a nové heslo, které se ještě jednou potvrzuje. Po odeslání údajů bude, v případě úspěšné změny hesla, zobrazena informace o provedené změně. Ke změně hesla bude uživatel automaticky vyzván při prvním přihlášení. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 6 / 30
Volba Změna hesla je součástí menu, určeného pro uživatele přihlášeného do aplikace jménem a heslem. Dobu platnosti hesla nastavuje administrátor systému v Global Payments Europe 4.1.2 Zdroje ke stažení Obr. 3: Změna hesla V této sekci jsou umístěny veškeré potřebné zdroje pro úspěšnou implementaci a provozování platební brány GP webpay. Dokumentace v češtině a angličtině Loga GP webpay a karetních asociací Příklady v PHP, Javě a.net Aplikace pro generování soukromého klíče, převodník formátů keystore Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 7 / 30
Obr. 4: Přehled zdrojů ke stažení 4.1.3 Uživatelé Tato volba zobrazí přehled uživatelů vaší společnosti. Umožňuje změnu přidělených rolí, hesla, zadání nového uživatele. Novému uživateli lze přidělit pouze roli, kterou má aktuálně přihlášený uživatel. 4.2 Zpracování objednávek 4.2.1 Objednávky Volba umožňující vyhledání a správu objednávek. Zobrazí se filtr pro vyhledávání. Je důležité správně zvolit vyhledávací filtr. Pokud budou zadaná omezení příliš obecná, může dojít k vypršení času pro vyhledávání (objeví se hlášení timeout ) a aplikace zobrazí chybu. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 8 / 30
Obr. 5: vyhledávací filtr Možnosti nastavení filtru: Obchodník: název obchodníka se vybírá z místní nabídky; Banka: pokud máte více obchodníků u různých bank, lze zadat omezení banky; Číslo objednávky: číslo objednávky v aplikaci GP webpay vstupní pole ORDERNUMBER; Objednávka obchodníka: číslo objednávky v systému obchodníka vstupní pole MERORDERNUM; Čas vytvoření od do: datum vytvoření objednávky, max. 35 dní; Částka od do: rozmezí částky; Měna: nabídka povolených měn; Asociace: výběr objednávek podle použité platební karty; Stav: v zaškrtávacím poli se označí požadovaný stav objednávky, viz Příloha: Stav objednávky Doplněná výběrová kritéria se potvrzují stiskem tlačítkem Odeslat. Po případném odeslání prázdného formuláře budou vyhledány všechny objednávky vybraného obchodníka, kromě objednávek ve stavu DELETE (vymazána). Vyhledané objednávky V přehledu objednávek, vyhledaných dle podmínek specifikovaných v předchozím kroku, jsou zobrazeny základní informace o nalezených objednávkách. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 9 / 30
Obr. 6: Výpis vyhledaných objednávek Ve výsledku vyhledávání je zobrazen stručný přehled nalezených objednávek. Ve spodní části výpisu je uveden počet nalezených objednávek. GP webpay zobrazí na 1 dotaz maximálně 100 položek na stránce, při větším počtu vybraných objednávek nejsou tedy zobrazeny všechny. Při větším počtu jsou zobrazeny šipky pro listování. Pro vyhledání konkrétní objednávky se proto doporučuje zadávat dotaz, co možná nejpřesněji. V přehledu autorizovaných objednávek se vybírají jednotlivé objednávky pro další zpracování. Pro označení všech objednávek najednou lze použít tlačítko Vyber vše. Po stisku tlačítka Inverzní výběr budou označeny všechny původně nezaškrtnuté objednávky. Tlačítko Zrušit výběr zruší dosavadní výběr, označení všech zaškrtnutých políček bude odstraněno najednou. Zpracování objednávek: Předpokladem pro zpracování označených objednávek je nastavení odpovídajícího Keystore (kontejneru s klíči) a zadání Hesla pro přístup do tohoto kontejneru 1. Tímto způsobem se v GP webpay standardně potvrzují všechny požadavky na zpracování. 1 Heslo a Keystore si obchodník generuje při uzavření smlouvy s GPE, s.r.o. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 10 / 30
Odeslání požadavku se ještě jednou potvrzuje. U hromadných příkazů to může být např. tlačítkem Úhrada vybraných, případně tlačítkem Vymazání vybraných. Pokud jsou zobrazena detailní data vybrané objednávky, je k dispozici tlačítko Zpracovat (transakci, vybranou z Transakcí). Obr. 7,8: Zadání Keystore a hesla Detail objednávky Po kliknutí na položku v přehledu vyhledaných objednávek budou zobrazena detailní data vybrané objednávky: Obr. 9: Detail objednávky Kromě základních informací o dané objednávce, nabízí GP webpay i výběr Transakce. Další možné zpracování závisí na aktuálním stavu objednávky. Na příklad autorizovaná objednávka může být uhrazena (DEPOSIT), anebo může být autorizace objednávky zneplatněna (APROVE_REVERSAL). Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 11 / 30
Pokud je požadováno zadání částky, je částku nutné zadat ve stejném formátu, tak jak je to zobrazeno v přehledu tj. s desetinnou tečkou/čárkou. Např.: částka 10 Kč a 30 halířů se zadává jako 10,3 (popř. 10,30). Toto je zásadní rozdíl od ostatního zpracování objednávek (založení, manipulace přes web services), kde je částka uváděna bez desetinné tečky/čárky tj. 1030. Podrobný popis stavu objednávky, viz Příloha: Stav objednávky. Popis podporovaných požadavků (Možné transakce), viz Příloha: Podporované požadavky. Pokud uživatel označí jednu z povolených transakcí, může v některých případech GP webpay nabídnout další pole pro doplnění potřebných údajů. Příkladně pro požadavek CREDIT nebo DEPOSIT musí být ještě specifikována Částka kreditu (depositu), pokud je požadován CREDIT_REVERSAL, musí být doplněno Číslo kreditu. Požadavek Zpracovat jednotlivou objednávku se potvrzuje obvyklým způsobem (zadání cesty ke Keystore a hesla). O výsledku zpracování bude uživatel informován. Informace o výsledku zpracování objednávky: Obr. 10: Informace o úspěšném zpracování objednávky Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 12 / 30
Ve zprávě o úspěšném zpracování požadavku jsou primární (PRC) a sekundární (SRC) návratový kód nastaveny na hodnotu 0 ; text, určený pro popis chyby, obsahuje hodnotu OK, sloupec OK obsahuje zelený bod. Ve zprávě o neúspěšném zpracování požadavku návratový kód PRC obsahuje typ chyby a SRC upřesnění této chyby. Text popisuje typ chyby a sloupec OK obsahuje červený bod. Obr. 11: Informace o neúspěšném zpracování objednávky Popis návratových kódů, viz Příloha: Návratové kódy. 4.2.2 Úhrada objednávek Po výběru volby Úhrada objednávek se zobrazí přehled úspěšně autorizovaných objednávek. Tyto objednávky jsou ve stavu autorizována - APPROVED a jsou připraveny k úhradě. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 13 / 30
Obr. 12: Seznam objednávek k úhradě Po kliknutí na položku v přehledu objednávek budou zobrazeny detailní informace o vybrané objednávce; před povolením transakce tedy mohou být některé údaje ještě ověřeny. Objednávky pro zpracování je možné vybírat jednotlivě (zatrhnutím) nebo lze označit všechny najednou (tlačítko Vyber vše), anebo může být použito tlačítko pro Inverzní výběr. Po potvrzení požadavku budou označené objednávky zpracovány. Výsledkem úspěšně zpracované objednávky je požadavek na zaúčtování objednávky. Ten se předává vydavateli karty. Provedená úhrada může být zneplatněna. Požadavek na zneplatnění úhrady platí pouze pro uhrazené objednávky, které ještě nebyly zpracovány, tzn., nebyla uzavřena dávka, ve které se objednávka nachází. 4.2.3 Vymazání neukončených objednávek Po výběru volby Vymazání neukončených se zobrazí seznam všech objednávek ve stavu neukončena - REQUESTED. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 14 / 30
Obr. 13: Seznam opuštěných objednávek Objednávky pro zpracování (výmaz) je možné vybírat jednotlivě (zatrhnutím), anebo lze označit všechny najednou (tlačítkem Vyber vše), případně lze provést Inverzní výběr. Po standardním potvrzení požadavku budou označené neukončené objednávky vymazány. Zobrazí se informace o výsledku zpracování, např.: Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 15 / 30
Detail vymazané objednávky Obr. 14: Výsledek zpracování objednávek Pokud bude stránka Výsledek transakce obsahovat přehled vymazaných objednávek, pak po kliknutí na vybranou položku budou zobrazeny tyto základní informace: Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 16 / 30
Obr. 15: Detail vymazané objednávky 4.3 Práce s dávkami 4.3.1 Vyhledání dávek Po výběru volby Vyhledání dávek se zobrazí stránka Vyhledávání dávek s příslušným formulářem - filtrem. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 17 / 30
Možnosti nastavení filtru: Obr. 16: Filtr a vyhledané dávky Obchodník: název obchodníka se vybírá z místní nabídky; Číslo dávky: konkrétní číslo dávky; Datum otevření od do; Datum uzavření od do; Stav: výběr podle stavu dávky; Vyhledané dávky Informace o výsledku vyhledávání obsahuje počty nalezených a zobrazených položek. V přehledu vyhledaných dávek je uvedeno číslo a stav dávky, čas otevření a uzavření dávky. Detail dávky Po kliknutí na vybranou položku se zobrazí základní informace o této dávce a přehledy všech plateb (záložka Platby) a kreditů (záložka Kredity) obsažených v dávce. Otevřená dávka může být uzavřena. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 18 / 30
4.3.2 Uzavření dávek Obr. 17: Detail dávky Volba automaticky vyhledá otevřené dávky a nabídne jejich uzavření. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 19 / 30
4.4 Odhlášení Obr. 18: Dávky k uzavření Pro odhlášení z aplikace je určena nabídka Odhlášení. Po kliknutí na tuto nabídku se zobrazí informace Byl jste odhlášen z aplikace GP Webpay. 5. Chybové stavy Aplikace rozlišuje dva typy zpráv informace a chybové zprávy. Oba typy zpráv se zobrazují nad formulářem, ke kterému se vztahují. Zpráva Informace (modrý formulář) obvykle informuje o výsledku právě ukončené akce. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 20 / 30
Obr. 19: Informační hlášení Zpráva Chyba (červený formulář) upozorní na závažné chyby, které musí být opraveny, aby zpracování mohlo dále pokračovat. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 21 / 30
Obr. 20: Chybové hlášení Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 22 / 30
6. Přílohy 6.1 Stavy objednávky Stav Popis stavu Možné následující stavy Neukončena REQUESTED Zrušena CANCELED Autorizována APPROVED Automaticky zrušena AUTO CANCELED Reverzována REVERSED Neautorizována UNAPPROVED Uhrazena DEPOSITED Zpracována PROCESSED Uzavřena CLOSED Automaticky uzavřena AUTO CLOSED Vymazána DELETED Kreditována CREDITED Objednávka byla úspěšně přijata do GP webpay čeká se na výsledek doplnění citlivých informací držitele karty. Pokud držitel karty doplnil citlivé informace, je zaslán dotaz do 3D systému, zda je požadována autentikace držitele karty. Čeká se na výsledek z 3D systému. Když držitel karty přerušil zadávání údajů karty, je toto finální stav objednávky. Držitel karty zrušil platbu (na platební bráne zvolil možnost "Zpět do e-shopu") Výsledek autentikace držitele karty v 3D systému byl úspěšný, byl poslán požadavek na autorizaci do autorizačního centra. Výsledek autorizace objednávky je úspěšný. Pokud je objednávky ve stavu Autorizována (APPROVED) více jak 30 dní, dojde k automatickému zrušení autorizace a není možné s touto objednávkou dále pracovat. Plní se tím nařízení karetních asociací o vázání peněžních prostředků na účtu držitele karty. Autorizace objednávky byla zneplatněna. Na straně držitele karty došlo k odblokování původně autorizovaných finančních prostředků. Výsledek autorizace objednávky je neúspěšný, objednávku není možné uhradit. Není možné pokračovat. Objednávka byla označena pro uhrazení během následného dávkového zpracování. Je možné zneplatnit úhradu objednávky do okamžiku, než proběhne uzavření dávky, ve které se daná úhrada nachází. Proběhl automatický proces uzavírání dávek a přenos dat do finančních systémů. Objednávka byla uzavřena. Jediná přípustná operace je vymazání. Objednávka byla automaticky uzavřena. Tato situace automaticky nastává po bankou definované době. Plní tímto nařízení karetních asociací a technická omezení bankovních systémů. Objednávka byla odstraněna. Objednávka byla označena pro návrat během následného dávkového zpracování. Je možné zneplatnit návrat objednávky do okamžiku, než Uhrazena DEPOSITED Reverzována REVERSED Vymazána DELETED Vymazána DELETED Vymazána DELETED Zpracována PROCCESED Autorizována APPROVED Kreditována CREDITED Uzavřena CLOSED Vymazána DELETED Vymazána DELETED Uzavřena CLOSED Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 23 / 30
proběhne uzavření dávky, ve které se daná objednávka nachází. Po uzavření dávky zůstává objednávka v tomto stavu. Pro objednávku je možné vytvořit více kreditů. Odmítnuta DECLINED Výsledek autentikace držitele karty v 3D systému byl neúspěšný. Držitel karty není autentikován není možné pokračovat. Objednávku je možné odstranit. Vymazána DELETED Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 24 / 30
6.2 Podporované požadavky/transakce Požadavek Význam Popis Předchozí možné stavy Výsledné možné stavy approvereversal Zneplatnění autorizace objednávky Požadavek na zneplatnění autorizace objednávky. Platí pouze pro úspěšně autorizované objednávky. Autorizována APPROVED Reverzován a REVERSED deposit Úhrada objednávky Požadavek na úhradu (zaúčtování) objednávky. Označí objednávku pro následné zpracování, po kterém bude zaslán požadavek na zaúčtování finanční transakce zúčtovací bance. Vlastní zaúčtování je v kompetenci zúčtující banky. Platí pouze pro úspěšně autorizované objednávky. Autorizována APPROVED Uhrazena DEPOSITED depositreversal Zneplatnění úhrady objednávky Požadavek na zneplatnění úhrady objednávky. Platí pouze pro uhrazené objednávky, které ještě nebyly zpracovány nedojde k převodu finančních prostředků od držitele karty k obchodníkovi. Uhrazena DEPOSITED Autorizován a APPROVED Credit Návrat objednávky Požadavek na návrat úhrady objednávek, které již byly zpracovány. Označí objednávku pro následné zpracování, po kterém budou finanční prostředky převedeny od obchodníka zpět k držiteli karty. Zpracována PROCESSED Kreditována CREDITED Kreditována CREDITED creditreversal Zneplatnění návratu objednávky Požadavek na zrušení -zneplatnění úhrady objednávky. Platí pouze pro zneplatněné objednávky, které ještě nebyly zpracovány nedojde k zpětnému převodu finančních prostředků od obchodníka k držiteli karty. Kreditována CREDITED Dávka s kreditem musí být otevřená Uhrazena DEPOSITED (v případě, že další platné kredity neexistují) Kreditována CREDITED closeorder Uzavření objednávky Požadavek na uzavření objednávky. Uhrazena DEPOSITED Uzavřena CLOSED Zpracována PROCESSED Kreditována CREDITED delete Odstranění objednávky Požadavek na odstranění objednávky. Odmítnuta DECLINED Vymazána DELETED Neautorizována UNAPPROVED Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 25 / 30
Reverzována REVERSED Uzavřena CLOSED batchclose Uzavření dávky objednávek Požadavek na uzavření dávky obsahující objednávky označené pro další zpracování. Není nezbytně nutné zasílat tento požadavek. Uzavírání dávek probíhá automaticky před každým zpracování dávek. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 26 / 30
6.3 Návratové kódy Systém poskytuje obchodníkům zpětnou vazbu formou návratových kódů. Vždy jsou vráceny 2 návratové kódy: 1. PRCODE (PrimaryReturnCode) hlavní informace o chybovém stavu 2. SRCODE (SecondaryReturnCode) doplňující informace o chybovém stavu 6.3.1 PRCODE - PrimaryReturnCode Hodnota Význam CS Význam EN 0 OK OK 1 Pole příliš dlouhé Field too long 2 Pole příliš krátké Field too short 3 Chybný obsah pole Incorrect content of field 4 Pole je prázdné Field is null 5 Chybí povinné pole Missing required field 11 Neznámý obchodník Unknown merchant 14 Duplikátní číslo objednávky Duplicate order number 15 Objekt nenalezen Object not found 17 Částka k úhradě překročila autorizovanou Amount to deposit exceeds approved amount částku 18 Součet kreditovaných částek překročil uhrazenou částku Total sum of credited amounts exceeded deposited amount 20 Objekt není ve stavu odpovídajícím této operaci Object not in valid state for operation 25 Uživatel není oprávněn k provedení operace Operation not allowed for user 26 Technický problém při spojení s autorizačním centrem Technical problem in connection to authorization center 27 Chybný typ objednávky Incorrect order type 28 Zamítnuto v 3D. Declined in 3D Důvod zamítnutí udává SRCODE 30 Zamítnuto v autorizačním centru. Declined in AC Důvod zamítnutí udává SRCODE 31 Chybný podpis Wrong digest 35 Vypršel čas pro zadání čísla karty. Objednávku Session expired. Order is not valid nelze dokončit 50 Držitel karty zrušil platbu The cardholder canceled the payment 1000 Technický problém Technical problem Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 27 / 30
6.3.2 SRCODE SecondaryReturnCode Hodnota Význam CS Význam EN 0 Bez významu V případě PRCODE 1 až 5, 15 a 20 se mohou vrátit následující SRCODE 1 ORDERNUMBER ORDERNUMBER 2 MERCHANTNUMBER MERCHANTNUMBER 5 CVC/CVV CVC/CVV 6 AMOUNT AMOUNT 7 CURRENCY CURRENCY 8 DEPOSITFLAG DEPOSITFLAG 10 MERORDERNUM MERORDERNUM 11 CREDITNUMBER CREDITNUMBER 12 OPERATION OPERATION 18 BATCH BATCH 22 ORDER ORDER 24 URL URL 25 MD MD 26 DESC DESC 34 DIGEST DIGEST V případě PRCODE 28 se mohou vrátit následující SRCODE 3000 Zamítnuto v 3D. Neúspěšné ověření držitele karty. Info: Ověření držitele karty bylo neúspěšné (neplatně zadané údaje, stornování autentikace, uzavření okna pro autentikaci držitele karty se zpětnou vazbou ). V transakci se nesmí pokračovat. 3001 Držitel karty ověřen. Info: Ověření držitele karty v 3D systémech proběhlo úspěšně. Pokračuje se autorizací objednávky. 3002 Neověřeno v 3D. Vydavatel karty nebo karta není zapojena do 3D. Info: V 3D systémech nebylo možné ověřit držitele karty karta, nebo její vydavatel, není zapojen do 3D. V transakci se pokračuje. 3004 Neověřeno v 3D. Vydavatel karty není zapojen do 3D nebo karta nebyla aktivována. Info: V 3D systémech nebylo možné ověřit držitele karty karta není aktivována, nebo její vydavatel, není zapojen do 3D. V transakci je možné pokračovat. 3005 Zamítnuto v 3D.Technický problém při ověření držitele karty. Declined in 3D. Cardholder not authenticated in 3D. Note: Cardholder authentication failed (wrong password, transaction canceled, authentication window was closed ). Transaction Declined. Authenticated Note: Cardholder was successfully authenticated transaction continue with authorization. Not Authenticated in 3D. Issuer or Cardholder not participating in 3D. Note: Cardholder wasn t authenticated Issuer or Cardholder not participating in 3D. Transaction can continue. Not Authenticated in 3D. Issuer not participating or Cardholder not enrolled. Note: Cardholder wasn t authenticated Cardholder not enrolled or Issuer or not participating in 3D. Transaction can continue. Declined in 3D. Technical problem during Cardholder authentication. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 28 / 30
Info: V 3D systémech nebylo možné ověřit držitele karty vydavatel karty nepodporuje 3D, nebo technický problém v komunikaci s 3D systémy finančních asociací, či vydavatele karty. V transakci není možné pokračovat, povoleno z důvodu zabezpečení obchodníka před případnou reklamací transakce držitelem karty. 3006 Zamítnuto v 3D. Technický problém při ověření držitele karty. Info: V 3D systémech nebylo možné ověřit držitele karty technický problém ověření obchodníka v 3D systémech, anebo v komunikaci s 3D systémy finančních asociací, či vydavatele karty. V transakci není možné pokračovat. 3007 Zamítnuto v 3D. Technický problém v systému zúčtující banky. Kontaktujte obchodníka. Info: V 3D systémech nebylo možné ověřit držitele karty technický problém v 3D systémech. V transakci není možné pokračovat. 3008 Zamítnuto v 3D. Použit nepodporovaný karetní produkt. Info: Byla použita karta, která není v 3D systémech podporována. V transakci není možné pokračovat. V případě PRCODE 30 se mohou vrátit následující SRCODE 1001 Zamitnuto v autorizacnim centru, karta blokovana 2 Zahrnuje důvody, které naznačují zneužití platební karty kradená karta, podezření na podvod, ztracená karta a pod. Většinou pokus o podvodnou transakci. 1002 Zamitnuto v autorizacnim centru, autorizace zamitnuta Z autorizace se vrátil důvod zamítnutí Do not honor. Vydavatel, nebo finanční asociace zamítla autorizaci BEZ udání důvodu. 1003 Zamitnuto v autorizacnim centru, problem karty Note: Cardholder authentication unavailable issuer not supporting 3D or technical problem in communication between associations and Issuer 3D systems. Transaction cannot continue. Declined in 3D. Technical problem during Cardholder authentication. Note: Technical problem during cardholder authentication merchant authentication failed or technical problem in communication between association and acquirer. Transaction cannot continue. Declined in 3D. Acquirer technical problem. Contact the merchant. Note: Technical problem during cardholder authentication 3D systems technical problem. Transaction cannot continue. Declined in 3D. Unsupported card product. Note: Card not supported in 3D. Transaction cannot continue. Declined in AC, Card blocked Includes the reasons implying that the card has been misused a stolen card, suspected card fraud, a lost card, etc. Declined in AC, Declined Reason: Card issuer or financial association rejected authorization ( Don Not Honor ) Declined in AC, Card problem Possible reasons: 2 Pouze tučně vytištěné části v této a níže uvedených buňkách tohoto sloupce budou obsaženy v poli RESULTTEXT (nepovinné pole) v odpovědi zaslané obchodníkovi. Zbývající text je pouze vysvětlení pro obchodníky. Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 29 / 30
Zahrnuje důvody: expirovaná karta, chybné číslo karty, nastavení karty - pro kartu není povoleno použití na internetu, nepovolená karta, expirovaná karta, neplatná karta, neplatné číslo karty, částka přesahuje maximální limit karty, neplatné CVC/CVV, neplatná délka čísla karty, neplatná expirační doba, pro kartu je požadována kontrola PIN. 1004 Zamitnuto v autorizacnim centru, technicky problem Autorizaci není možné provést z technických důvodů technické problémy v systému vydavatele karty, nebo finančních asociací a finančních procesorů. 1005 Zamitnuto v autorizacnim centru, Problem uctu Důvody: nedostatek prostředků na účtu, překročeny limity, překročen max. povolený počet použití Expired card, wrong card number, Internet transaction not permitted to Cardholder, invalid card, invalid card number, amount over card maximum limit, wrong CVC/CVV, invalid card number length, invalid expiry date, PIN control is required for used card. Declined in AC, Technical problem in authorization process Authorization rejected technical problem. Technical problem in card issuer systems or financial associations systems (Card issuer unavailable) Declined in AC, Account problem Possible reasons: finance absence, over account limit, over daily limit Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 Strašnice, Česká republika 30 / 30