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. |
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.
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:
-
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.
-
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 stavuPAID
(platí také proAUTHORIZED
). Všechny ostatní neukončené pokusy (PENDING
) jsou v tomto okamžiku zrušeny (CANCELLED
). -
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
). -
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. -
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.
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 |
|
PAID | Ano |
|
AUTHORIZED | Ano i Ne |
|
CANCELLED | Ano |
|
Pokus o platbu – stav jednotlivého pokusu v rámci jedné platby | ||
PENDING | Ne |
|
PAID | Ano |
|
AUTHORIZED | Ano |
|
CANCELLED | Ne |
|