Stavy plateb

Stav platby odráží aktuální výsledek nebo fázi zpracování dané transakce. Každý stav je důležitý pro správné řízení dalšího postupu – například kdy lze zpřístupnit službu, kdy je nutné vyčkat na autorizaci, nebo kdy platbu ukončit bez další akce.

Níže uvedené stavy vám pomohou porozumět tomu, v jaké fázi se daná platba nachází a jak na základě toho správně reagovat ve vašem systému.

Stav	Finální stav	Popis
PENDING	Ne	Platba byla založena, ale její výsledek zatím není znám – transakce je ve stavu zpracování a stále probíhá.
AUTHORIZED	Ne	Plátce úspěšně provedl předautorizaci platby kartou – pro dokončení transakce je nutné vyžádat stržení předautorizované částky.
PAID	Ano	Plátce úspěšně dokončil platbu – je možné vydat zboží nebo zpřístupnit objednanou službu.
CANCELLED	Ano	Platba nebyla úspěšně dokončena – zboží nebude vydáno, resp. služba nebude poskytnuta.

Upozornění

Platbu lze považovat za úspěšně zaplacenou pouze ve stavu PAID. Stavy jako PENDING a AUTHORIZED nejsou koncové a mohou být následovány stavem CANCELLED.

Koncové stavy

Stavy PAID a CANCELLED jsou koncové. Jakmile platba přejde do některého z těchto stavů, zůstává v něm trvale a již se dále nemění.

Sekvenční diagram

Následující sekvenční diagram znázorňuje průběh stavů platby během jejího zpracování. Diagram popisuje jednotlivé kroky a změny stavů, ke kterým dochází od založení platby až po její úspěšné dokončení nebo zrušení.

Pokus o platbu

Comgate kromě samotné platby rozlišuje také tzv. pokusy o platbu. V běžných integracích se s tímto pojmem zpravidla nesetkáte a není nutné se jím podrobně zabývat.

Upozornění

Pokračujte ve čtení pouze v případě, že implementujete nativní tlačítka Apple Pay nebo Google Pay v mobilní aplikaci.

Stavy pokusů o platbu

Výše uvedený diagram znázorňuje průběh stavů celé platby. Pokusy o platbu procházejí stejnými stavy, avšak mají svá specifika, která je vhodné při implementaci nativních tlačítek Apple Pay a Google Pay znát.

Každý pokus o platbu má vlastní životní cyklus a je plně nezávislý na ostatních pokusech. Představuje tak samostatnou instanci v životním cyklu jedné platby.

Pro práci s pokusy o platbu platí následující pravidla:

1. Každý pokus o platbu má svůj vlastní stav – jednotlivé pokusy o platbu mohou mít různé stavy, které se liší od stavu celé platby.

2. Jeden úspěšný pokus stačí – pokud je alespoň jeden pokus o platbu ve stavu PAID, je celá platba považována za úspěšně dokončenou a přechází také do stavu PAID (platí také pro AUTHORIZED). Všechny ostatní neukončené pokusy (PENDING) jsou v tomto okamžiku zrušeny (CANCELLED).

3. Neúspěšný pokus neukončuje platbu – pokud je některý z pokusů neúspěšný (CANCELLED), může platba nadále pokračovat dalšími pokusy. Stav celé platby zůstává otevřený (PENDING).

4. Zrušení platby ruší i probíhající pokusy – jakmile celá platba přejde do stavu CANCELLED, všechny její probíhající pokusy (PENDING) jsou okamžitě zrušeny.

5. Platba je zrušena jako celek – k tomu dochází například vypršením časového limitu nebo ručním zrušením ze strany plátce či e-shopu.

Tip

Je důležité si uvědomit, že některé stavy pokusu o platbu mají přímý vliv na výsledek celé platby, zatímco jiné ji neovlivňují a umožňují pokračování dalším pokusem.

Jak se chovat v jednotlivých stavech

Následující tabulka je rozdělena na dvě části – první se týká samotné platby, druhá se zaměřuje na pokusy o platbu. U každého stavu je uvedeno jeho významové vysvětlení a doporučený způsob, jak v daném okamžiku dále postupovat v rámci logiky aplikace.

Stav	Konečný stav platby	Popis
Platba – reprezentuje celkový výsledek zpracování
PENDING	Ne	platba je otevřena a čeká na provedení lze provádět další pokusy o platbu
PAID	Ano	platba byla úspěšně uhrazena lze zobrazit "victory screen" nelze provádět další pokusy o platbu
AUTHORIZED	Ano i Ne	platba byla úspěšně předautorizována lze zobrazit "victory screen" finance nebudou automaticky strženy nelze provádět další pokusy o platbu
CANCELLED	Ano	platba byla zrušena (vypršela nebo ručně ukončena) nelze provádět další pokusy o platbu
Pokus o platbu – stav jednotlivého pokusu v rámci jedné platby
PENDING	Ne	pokus o platbu stále probíhá lze provádět další pokusy o platbu – i souběžně
PAID	Ano	pokus byl úspěšně uhrazen celá platba je označena jako PAID ostatní aktivní pokusy jsou zrušeny nelze provádět další pokusy o platbu
AUTHORIZED	Ano	pokus byl úspěšně předautorizován celá platba je označena jako AUTHORIZED ostatní otevřené pokusy jsou zrušeny nelze provádět další pokusy o platbu
CANCELLED	Ne	pokus byl zrušen nebo selhal platba zůstává aktivní ve stavu PENDING lze provádět další pokusy o platbu