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
Administrace systému GP webpay Autor dokumentu
Dimitrij Holovka
Správce dokumentu Schválil Verze
1.1
Stupeň utajení
Důvěrné
Historie dokumentu: Verze 1.0 1.1
Datum 14.08.2015 14.12.2015
Provedl D. Holovka D. Holovka
Komentář Nová šablona, verzování 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
Stavy objednávky............................................................................................................ 23
6.2
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
Administrace systému GP webpay
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
Administrace systému GP webpay
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
Administrace systému GP webpay 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
Administrace systému GP webpay 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;
▪
Odhlášení – odhlášení ze systému a ukončení práce s GUI
4.1 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
Administrace systému GP webpay 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
Obr. 3: Změna hesla
4.1.2 Zdroje ke stažení 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
Administrace systému GP webpay
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
Administrace systému GP webpay
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
Administrace systému GP webpay
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 kontejneru1. 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
Administrace systému GP webpay 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
Administrace systému GP webpay 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
Administrace systému GP webpay 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
Administrace systému GP webpay
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
Administrace systému GP webpay
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
Administrace systému GP webpay
Obr. 14: Výsledek zpracování objednávek
Detail vymazané objednávky 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
Administrace systému GP webpay
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
Administrace systému GP webpay
Obr. 16: Filtr a vyhledané dávky
Možnosti nastavení filtru: ▪
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
Administrace systému GP webpay
Obr. 17: Detail dávky
4.3.2 Uzavření dávek 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
Administrace systému GP webpay
Obr. 18: Dávky k uzavření
4.4 Odhláš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
Administrace systému GP webpay
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
Administrace systému GP webpay
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
Administrace systému GP webpay
6. Přílohy 6.1 Stavy objednávky Stav
Popis stavu
Neukončena REQUESTED
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.
Zrušena CANCELED Autorizována APPROVED
Držitel karty zrušil platbu (na platební bráne zvolil možnost "Zpět do e-shopu")
Automaticky zrušena AUTO CANCELED
Reverzována REVERSED
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ů.
Možné následující stavy
Uhrazena DEPOSITED Reverzována REVERSED Vymazána DELETED
Vymazána DELETED
Neautorizována UNAPPROVED
Výsledek autorizace objednávky je neúspěšný, objednávku není možné uhradit. Není možné pokračovat.
Vymazána DELETED
Uhrazena DEPOSITED
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í.
Zpracována PROCCESED
Zpracována PROCESSED
Uzavřena CLOSED Automaticky uzavřena AUTO CLOSED
Vymazána DELETED Kreditována CREDITED
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ž
Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 – Strašnice, Česká republika
Autorizována APPROVED Kreditována CREDITED Uzavřena CLOSED Vymazána DELETED Vymazána DELETED
Uzavřena CLOSED
23 / 30
Administrace systému GP webpay 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.
Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 – Strašnice, Česká republika
Vymazána DELETED
24 / 30
Administrace systému GP webpay
6.2 Podporované požadavky/transakce Předchozí možné stavy
Výsledné možné stavy
Požadavek
Význam
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
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
Uhrazena DEPOSITED
Dávka s kreditem musí být otevřená
(v případě, že další platné kredity neexistují)
creditReversal
Zneplatnění návratu objednávky
Popis
Kreditována CREDITED
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
Administrace systému GP webpay 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
Administrace systému GP webpay
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
0 1 2 3 4 5 11 14 15 17 18 20 25 26 27 28 30 31 35 50 1000
Význam CS
Význam EN
OK Pole příliš dlouhé Pole příliš krátké Chybný obsah pole Pole je prázdné Chybí povinné pole Neznámý obchodník Duplikátní číslo objednávky Objekt nenalezen Částka k úhradě překročila autorizovanou částku Součet kreditovaných částek překročil uhrazenou částku Objekt není ve stavu odpovídajícím této operaci
OK Field too long Field too short Incorrect content of field Field is null Missing required field Unknown merchant Duplicate order number Object not found Amount to deposit exceeds approved amount
Uživatel není oprávněn k provedení operace Technický problém při spojení s autorizačním centrem Chybný typ objednávky Zamítnuto v 3D. Důvod zamítnutí udává SRCODE Zamítnuto v autorizačním centru. Důvod zamítnutí udává SRCODE Chybný podpis Vypršel čas pro zadání čísla karty. Objednávku nelze dokončit Držitel karty zrušil platbu Technický problém
Operation not allowed for user Technical problem in connection to authorization center Incorrect order type Declined in 3D
Total sum of credited amounts exceeded deposited amount Object not in valid state for operation
Declined in AC Wrong digest Session expired. Order is not valid The cardholder canceled the payment Technical problem
Global Payments Europe, s.r.o., V Olšinách 80/626, 100 00 Praha 10 – Strašnice, Česká republika
27 / 30
Administrace systému GP webpay
6.3.2 SRCODE – SecondaryReturnCode Význam CS
Hodnota
0
Význam EN
Bez významu
V případě PRCODE 1 až 5, 15 a 20 se mohou vrátit následující SRCODE 1 2 5 6 7 8 10 11 12 18 22 24 25 26 34
ORDERNUMBER MERCHANTNUMBER CVC/CVV AMOUNT CURRENCY DEPOSITFLAG MERORDERNUM CREDITNUMBER OPERATION BATCH ORDER URL MD DESC DIGEST
ORDERNUMBER MERCHANTNUMBER CVC/CVV AMOUNT CURRENCY DEPOSITFLAG MERORDERNUM CREDITNUMBER OPERATION BATCH ORDER URL MD DESC 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.
Declined in 3D. Cardholder not authenticated in 3D.
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…).
Note: Cardholder authentication failed (wrong password, transaction canceled, authentication window was closed…). Transaction Declined.
V transakci se nesmí pokračovat. 3001
3002
Držitel karty ověřen.
Authenticated
Info: Ověření držitele karty v 3D systémech proběhlo úspěšně. Pokračuje se autorizací objednávky.
Note: Cardholder was successfully authenticated – transaction continue with authorization.
Neověřeno v 3D. Vydavatel karty nebo karta není zapojena do 3D.
Not Authenticated in 3D. Issuer or Cardholder not participating in 3D.
Info: V 3D systémech nebylo možné ověřit držitele karty – karta, nebo její vydavatel, není zapojen do 3D.
Note: Cardholder wasn’t authenticated – Issuer or Cardholder not participating in 3D. Transaction can continue.
V transakci se pokračuje. 3004
3005
Neověřeno v 3D. Vydavatel karty není zapojen do 3D nebo karta nebyla aktivována.
Not Authenticated in 3D. Issuer not participating or Cardholder not enrolled.
Info: V 3D systémech nebylo možné ověřit držitele karty – karta není aktivována, nebo její vydavatel, není zapojen do 3D.
Note: Cardholder wasn’t authenticated – Cardholder not enrolled or Issuer or not participating in 3D.
V transakci je možné pokračovat.
Transaction can continue.
Zamítnuto v 3D.Technický problém při ověření držitele karty.
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
Administrace systému GP webpay 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.
Note: Cardholder authentication unavailable – issuer not supporting 3D or technical problem in communication between associations and Issuer 3D systems. Transaction cannot continue.
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
3007
Zamítnuto v 3D. Technický problém při ověření držitele karty.
Declined in 3D. Technical problem during Cardholder authentication.
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.
Note: Technical problem during cardholder authentication – merchant authentication failed or technical problem in communication between association and acquirer.
V transakci není možné pokračovat. 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.
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.
V transakci není možné pokračovat. 3008
Zamítnuto v 3D. Použit nepodporovaný karetní produkt.
Declined in 3D. Unsupported card product. Note: Card not supported in 3D.
Info: Byla použita karta, která není v 3D systémech podporována.
Transaction cannot continue.
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 2 blokovana Zahrnuje důvody, které naznačují zneužití platební karty – kradená karta, podezření na podvod, ztracená karta a pod.
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.
Většinou pokus o podvodnou transakci. 1002
Zamitnuto v autorizacnim centru, autorizace zamitnuta
Declined in AC, Declined Reason:
Z autorizace se vrátil důvod zamítnutí “Do not honor“.
Card issuer or financial association rejected authorization (“Don Not Honor”)
Vydavatel, nebo finanční asociace zamítla autorizaci BEZ udání důvodu. 1003
Zamitnuto v autorizacnim centru, problem karty
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
Administrace systému GP webpay 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
1005
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.
Zamitnuto v autorizacnim centru, technicky problem
Declined in AC, Technical problem in authorization process
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ů.
Authorization rejected – technical problem.
Zamitnuto v autorizacnim centru, Problem uctu
Declined in AC, Account problem
Důvody: nedostatek prostředků na účtu, překročeny limity, překročen max. povolený počet použití…
Technical problem in card issuer systems or financial associations systems (Card issuer unavailable)
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