Stavy platieb

Stav platby odráža aktuálny výsledok alebo fázu spracovania danej transakcie. Každý stav je dôležitý pre správne riadenie ďalšieho postupu - napríklad kedy možno sprístupniť službu, kedy je nutné vyčkať na autorizáciu, alebo kedy platbu ukončiť bez ďalšej akcie.

Nižšie uvedené stavy vám pomôžu porozumieť tomu, v akej fáze sa daná platba nachádza a ako na základe toho správne reagovať vo vašom systéme.

Stav	Finálny stav	Popis
PENDING	Nie	Platba bola založená, ale jej výsledok zatiaľ nie je známy - transakcia je v stave spracovania a stále prebieha.
AUTHORIZED	Nie	Platiteľ úspešne vykonal predautorizáciu platby kartou - pre dokončenie transakcie je nutné vyžiadať stiahnutie predautorizovanej sumy.
PAID	Áno	Platiteľ úspešne dokončil platbu - je možné vydať tovar alebo sprístupniť objednanú službu.
CANCELLED	Áno	Platba nebola úspešne dokončená - tovar nebude vydaný, resp. služba nebude poskytnutá.

Upozornenie

Platbu možno považovať za úspešne zaplatenú iba v stave PAID. Stavy ako PENDING a AUTHORIZED nie sú koncové a môžu byť nasledované stavom CANCELLED.

Koncové stavy

Stavy PAID a CANCELLED sú koncové. Akonáhle platba prejde do niektorého z týchto stavov, zostáva v ňom trvale a už sa ďalej nemení.

Sekvenčný diagram

Nasledujúci sekvenčný diagram znázorňuje priebeh stavov platby počas jej spracovania. Diagram popisuje jednotlivé kroky a zmeny stavov, ku ktorým dochádza od založenia platby až po jej úspešné dokončenie alebo zrušenie.

Pokus o platbu

Comgate okrem samotnej platby rozlišuje aj tzv. pokusy o platbu. V bežných integráciách sa s týmto pojmom spravidla nestretnete a nie je nutné sa ním podrobne zaoberať.

Upozornenie

Pokračujte v čítaní iba v prípade, že implementujete natívne tlačidlá Apple Pay alebo Google Pay v mobilnej aplikácii.

Stavy pokusov o platbu

Vyššie uvedený diagram znázorňuje priebeh stavov celej platby. Pokusy o platbu prechádzajú rovnakými stavmi, avšak majú svoje špecifiká, ktoré je vhodné pri implementácii natívnych tlačidiel Apple Pay a Google Pay poznať.

Každý pokus o platbu má vlastný životný cyklus a je plne nezávislý na ostatných pokusoch. Predstavuje tak samostatnú inštanciu v životnom cykle jednej platby.

Pre prácu s pokusmi o platbu platia nasledujúce pravidlá:

1. Každý pokus o platbu má svoj vlastný stav - jednotlivé pokusy o platbu môžu mať rôzne stavy, ktoré sa líšia od stavu celej platby.

2. Jeden úspešný pokus stačí - ak je aspoň jeden pokus o platbu v stave PAID, je celá platba považovaná za úspešne dokončenú a prechádza tiež do stavu PAID (platí aj pre AUTHORIZED). Všetky ostatné neukončené pokusy (PENDING) sú v tomto okamihu zrušené (CANCELLED).

3. Neúspešný pokus neukončuje platbu - ak je niektorý z pokusov neúspešný (CANCELLED), môže platba naďalej pokračovať ďalšími pokusmi. Stav celej platby zostáva otvorený (PENDING).

4. Zrušenie platby ruší aj prebiehajúce pokusy - akonáhle celá platba prejde do stavu CANCELLED, všetky jej prebiehajúce pokusy (PENDING) sú okamžite zrušené.

5. Platba je zrušená ako celok - k tomu dochádza napríklad vypršaním časového limitu alebo ručným zrušením zo strany platiteľa či e-shopu.

Tip

Je dôležité si uvedomiť, že niektoré stavy pokusu o platbu majú priamy vplyv na výsledok celej platby, zatiaľ čo iné ju neovplyvňujú a umožňujú pokračovanie ďalším pokusom.

Ako sa správať v jednotlivých stavoch

Nasledujúca tabuľka je rozdelená na dve časti - prvá sa týka samotnej platby, druhá sa zameriava na pokusy o platbu. Pri každom stave je uvedené jeho významové vysvetlenie a odporúčaný spôsob, ako v danom okamihu ďalej postupovať v rámci logiky aplikácie.

Stav	Konečný stav platby	Popis
Platba - reprezentuje celkový výsledok spracovania
PENDING	Nie	platba je otvorená a čaká na vykonanie možno vykonávať ďalšie pokusy o platbu
PAID	Áno	platba bola úspešne uhradená možno zobraziť "victory screen" nemožno vykonávať ďalšie pokusy o platbu
AUTHORIZED	Áno aj Nie	platba bola úspešne predautorizovaná možno zobraziť "victory screen" financie nebudú automaticky stiahnuté nemožno vykonávať ďalšie pokusy o platbu
CANCELLED	Áno	platba bola zrušená (vypršala alebo bola ručne ukončená) nemožno vykonávať ďalšie pokusy o platbu
Pokus o platbu - stav jednotlivého pokusu v rámci jednej platby
PENDING	Nie	pokus o platbu stále prebieha možno vykonávať ďalšie pokusy o platbu - aj súbežne
PAID	Áno	pokus bol úspešne uhradený celá platba je označená ako PAID ostatné aktívne pokusy sú zrušené nemožno vykonávať ďalšie pokusy o platbu
AUTHORIZED	Áno	pokus bol úspešne predautorizovaný celá platba je označená ako AUTHORIZED ostatné otvorené pokusy sú zrušené nemožno vykonávať ďalšie pokusy o platbu
CANCELLED	Nie	pokus bol zrušený alebo zlyhal platba zostáva aktívna v stave PENDING možno vykonávať ďalšie pokusy o platbu