Přeskočit na hlavní obsah

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.

StavFinální stavPopis
PENDINGNePlatba byla založena, ale její výsledek zatím není znám – transakce je ve stavu zpracování a stále probíhá.
AUTHORIZEDNePlátce úspěšně provedl předautorizaci platby kartou – pro dokončení transakce je nutné vyžádat stržení předautorizované částky.
PAIDAnoPlátce úspěšně dokončil platbu – je možné vydat zboží nebo zpřístupnit objednanou službu.
CANCELLEDAnoPlatba 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í.

Sekvenční diagram stavů platebSekvenční diagram stavů plateb

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.

ER diagramER diagram

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.

StavKonečný stav platbyPopis
Platbareprezentuje celkový výsledek zpracování
PENDINGNe
  • platba je otevřena a čeká na provedení
  • lze provádět další pokusy o platbu
PAIDAno
  • platba byla úspěšně uhrazena
  • lze zobrazit "victory screen"
  • nelze provádět další pokusy o platbu
AUTHORIZEDAno 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
CANCELLEDAno
  • platba byla zrušena (vypršela nebo ručně ukončena)
  • nelze provádět další pokusy o platbu
Pokus o platbustav jednotlivého pokusu v rámci jedné platby
PENDINGNe
  • pokus o platbu stále probíhá
  • lze provádět další pokusy o platbu – i souběžně
PAIDAno
  • 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
AUTHORIZEDAno
  • 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
CANCELLEDNe
  • pokus byl zrušen nebo selhal
  • platba zůstává aktivní ve stavu PENDING
  • lze provádět další pokusy o platbu