Administrace systému GP webpay

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