Zdrojový kód wiki Platební brány (Comgate, GoPay)
Version 7.3 by Jiří Šilha on 2026/06/08 13:57
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{toc/}} | ||
| 2 | |||
| 3 | = Úvod = | ||
| 4 | |||
| 5 | Knihovní systém Tritius modul webový katalog umožňuje čtenářům provádět platby kartou za určité operace: | ||
| 6 | |||
| 7 | * Zaplacení poplatků (upomínky, pokuty apod.) | ||
| 8 | * Prodloužení registrace | ||
| 9 | |||
| 10 | Pro platby kartou využívá Tritius služeb platební brány [[Comgate>>url:https://www.comgate.cz/cz]] nebo [[GoPay>>url:https://gopay.com/cs/]]. | ||
| 11 | |||
| 12 | Knihovna uzavírá smlouvu přímo s poskytovatelem vybrané brány smlouvu, | ||
| 13 | |||
| 14 | Modul platební brána v katalogu systému Tritius se platí dle ceníku včetně následného update. | ||
| 15 | |||
| 16 | Knihovna má přístup do webového rozhraní, kde může nahlížet do vyučtování a zobrazit si detaily plateb. | ||
| 17 | |||
| 18 | = Platba za prodloužení registraci = | ||
| 19 | |||
| 20 | * Prodloužení registrace přes katalog musí být povoleno položkou nastavení: CATALOG_REGISTRATION_PROLONGATION_ENABLED | ||
| 21 | * Čtenáři se před koncem registrace v katalogu zobrazí upozornění na končící registraci. | ||
| 22 | ** Kdy se upozornění zobrazí lze korigovat nastavením: CATALOG_REGISTRATION_PROLONGATION_PERIOD | ||
| 23 | * Po kliknutí na notifikaci o končící registraci se zobrazí stránka s výpisem končících registrací | ||
| 24 | ** Registrací může být více na různých odděleních | ||
| 25 | ** Čtenář si kliknutím na tlačítko "Prodloužit registraci" může prodloužit jednotlivé registrace. | ||
| 26 | ** Po kliknutí na tlačítko "Prodloužit registraci" se čtenáři zobrazí stránka se souhrnem informací: | ||
| 27 | *** Od kdy nová registrace bude platit. | ||
| 28 | *** Do kdy bude nová registrace platit. | ||
| 29 | *** Na jakých odděleních registrace bude platit (včetně propojených odděleních). | ||
| 30 | *** Zaškrtávací políčko, že čtenář souhlasí s knihovním řádem (případně odkaz na knihovní řád). | ||
| 31 | *** Na konci stránky budou na výběr dvě možnosti: | ||
| 32 | **** Potvrdit a zaplatit - dojde k zobrazení platby kartou, čtenář zaplatí a registrace bude plně platná. | ||
| 33 | **** Potvrdit a vytvořit dluh - dojde k vytvoření dluhu a prodloužení registrace. Čtenář může používat nadále služby knihovny, ale některé mohou být omezené. | ||
| 34 | * Po prvním příchodu do knihovny po prodloužení přes kartu se knihovnici zobrazí info (aby si mohla překontrolovat údaje). | ||
| 35 | * Seznam aktivních registrací si čtenář může také zobrazit z uživatelského menu pod odkazem "Moje registrace". | ||
| 36 | |||
| 37 | = Platba za dlužné poplatky = | ||
| 38 | |||
| 39 | * Ve čtenářském menu se zobrazuje celkový dluh čtenáře. | ||
| 40 | * Ve čtenářském menu se také u odkazu "Moje poplatky" zobrazuje počet aktuálně dlužných poplatků. | ||
| 41 | * Po kliknutí na celkovou částku se zobrazí seznam dlužných poplatků. | ||
| 42 | * Pokud jsou povolené platby kartou, pak se pod výpisem zobrazí tlačítko "Zaplatit", které čtenáře přesměruje do platební brány GoPay a umožní mu zaplatit své dlužné poplatky. | ||
| 43 | * Catalog obsahuje nastavení **PAYMENT_GATE_MINIMAL_AMOUNT **udávající minimální částku možnou platit pomocí platební brány. | ||
| 44 | |||
| 45 | = = | ||
| 46 | |||
| 47 | = Platební brána Comgate = | ||
| 48 | |||
| 49 | Web: [[https:~~/~~/www.comgate.cz/cz>>url:https://www.comgate.cz/cz]] | ||
| 50 | |||
| 51 | [[Aktuální ceník: >>url:https://www.comgate.cz/cz]][[https:~~/~~/www.comgate.cz/cz/cena>>url:https://www.comgate.cz/cz/cena]] | ||
| 52 | [[Klientský portál: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/site/index>>url:https://portal.comgate.cz/cs/site/index]] | ||
| 53 | [[Dokumentace: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/dokumentace>>url:https://portal.comgate.cz/cs/dokumentace]] | ||
| 54 | |||
| 55 | **Uzavření smlouvy: [[https:~~/~~/help.comgate.cz/docs/smlouva-online>>url:https://help.comgate.cz/docs/smlouva-online]]** | ||
| 56 | |||
| 57 | |||
| 58 | Články: | ||
| 59 | |||
| 60 | * Srovnání platebních bran: [[https:~~/~~/www.comgate.cz/cz/blog/srovnani-platebnich-bran>>url:https://www.comgate.cz/cz/blog/srovnani-platebnich-bran]] | ||
| 61 | |||
| 62 | == Platební podmínky == | ||
| 63 | |||
| 64 | === **Jednorázové poplatky** === | ||
| 65 | |||
| 66 | (% class="table-bordered" %) | ||
| 67 | |Zřízení platební brány|0,- | ||
| 68 | |(% colspan="1" %)Převod peněz na bankovní účet klienta denně|(% colspan="1" %)0,- | ||
| 69 | |(% colspan="1" %)EET v platební bráně|(% colspan="1" %)0,- | ||
| 70 | |(% colspan="1" %)Zrušení platební brány|(% colspan="1" %)0,- | ||
| 71 | |Refundace (vrácení peněžních prostředků Plátci na žádost Klienta)|2 Kč | ||
| 72 | |Chargeback (vynucené vrácení peněžních prostředků Plátci na základě stížnosti Plátce)|990 Kč | ||
| 73 | |||
| 74 | === **Měsíční poplatky za správu a procentní poplatky z transakcí (informujte se o aktuálních cenách)** === | ||
| 75 | |||
| 76 | (% class="table-bordered" %) | ||
| 77 | |=Měsíční objem transakcí|do 100.000 kč/měsíc|(% colspan="1" %)100.000-500.000 kč/měsíc|(% colspan="1" %)500.000kč-3 mil Kč/měsíc | ||
| 78 | |=Měsíční poplatek|149 Kč|(% colspan="1" %)99 Kč|(% colspan="1" %)0 Kč | ||
| 79 | |=(% colspan="1" %)Poplatek z transakce|(% colspan="1" %)0,99% + 0,- Kč|(% colspan="1" %)0,89% + 0,- Kč|(% colspan="1" %)0,79% + 0,- Kč | ||
| 80 | |||
| 81 | === === | ||
| 82 | |||
| 83 | == Nastavení brány v Tritiu == | ||
| 84 | |||
| 85 | Použití platební brány v katalogu je třeba povolit a nastavit. | ||
| 86 | |||
| 87 | (% class="table-bordered" %) | ||
| 88 | |=((( | ||
| 89 | Klíč | ||
| 90 | )))|=((( | ||
| 91 | Typ | ||
| 92 | )))|=(% colspan="1" %)((( | ||
| 93 | Popis | ||
| 94 | ))) | ||
| 95 | |CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|Boolean|Povolení zobrazení stránky s platebními podmínkami | ||
| 96 | |CATALOG_SHOW_PRICE_LIST_PAGE|Boolean|Povolení zobrazení stránky s ceníkem | ||
| 97 | |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Povolení plateb kartou v katalogu | ||
| 98 | |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení registrace | ||
| 99 | |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_PERIOD|(% colspan="1" %)Int|(% colspan="1" %)Počet dní do konce registrace, od kdy lze registraci prodloužit. Defaultně je 31 dní. | ||
| 100 | |(% colspan="1" %)((( | ||
| 101 | IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS | ||
| 102 | )))|(% colspan="1" %)Boolean|(% colspan="1" %)((( | ||
| 103 | Povolení prodloužení prošlé registrace v katalogu | ||
| 104 | ))) | ||
| 105 | |(% colspan="1" %)COMGATE_MERCHANT|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 106 | Comgate identifikátor zákazníka | ||
| 107 | |||
| 108 | //Obdržíte po podepsání smlouvy s Comgate.// | ||
| 109 | ))) | ||
| 110 | |(% colspan="1" %)COMGATE_SECRET|(% colspan="1" %)String|(% colspan="1" %)((( | ||
| 111 | Heslo | ||
| 112 | |||
| 113 | //Obdržíte po podepsání smlouvy s Comgate.// | ||
| 114 | ))) | ||
| 115 | |(% colspan="1" %)COMGATE_TEST|(% colspan="1" %)Boolean|(% colspan="1" %)((( | ||
| 116 | Příznak testovacího provozu. Je nutné mít přístup do testovacího režimu Comgate. | ||
| 117 | ))) | ||
| 118 | |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT|(% colspan="1" %)Int|(% colspan="1" %)Minimální částka, kterou je možné zaplatit bránou. Defaultně 10 Kč. | ||
| 119 | |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)((( | ||
| 120 | Povolení plateb v katalogu. Ve výchozím stavu povolené. Jde nastavit až na samotného uživatele. | ||
| 121 | |||
| 122 | Vhodné například pro povolení jediného uživatele pro test platební brány. | ||
| 123 | ))) | ||
| 124 | |||
| 125 | Platební brána Comgate vyžaduje přítomnost obchodních podmínek na stránkách instituce. Tritius pro tyto účely disponuje samostatnou stránkou, na níž vede odkaz z patičky katalogu a která je definována v nastavení **Html šablony katalogu**. Viz například: [[https:~~/~~/katalog.svkul.cz/page/terms-and-conditions>>url:https://katalog.svkul.cz/page/terms-and-conditions]] | ||
| 126 | |||
| 127 | Při úpravě Html šablony je potřeba **zachovat defaultní strukturu tagů** a vlastní text zapsat mezi tyto tagy. | ||
| 128 | |||
| 129 | == Nastavení brány v Comgate == | ||
| 130 | |||
| 131 | V nastavení platební brány Comgate je nutné nastavit UR adresy tak, aby směrovaly na Tritius. **Hlavní menu → Integrace → Nastavení obchodů.** | ||
| 132 | |||
| 133 | Dokumentace Comgate: [[https:~~/~~/help.comgate.cz/docs/navod-k-pouziti#propojen%C3%AD-obchodu>>url:https://help.comgate.cz/docs/navod-k-pouziti#propojen%C3%AD-obchodu]] | ||
| 134 | |||
| 135 | |||
| 136 | (% class="table-bordered" %) | ||
| 137 | |=Parametr|=Hodnota | ||
| 138 | |(% colspan="1" %)URL zaplacený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/paid?id=${id}&refId=${refId} | ||
| 139 | |(% colspan="1" %)URL zrušený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/canceled?id=${id}&refId=${refId} | ||
| 140 | |(% colspan="1" %)URL nevyřízený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/pending?id=${id}&refId=${refId} | ||
| 141 | |(% colspan="1" %)URL pro předání výsledku platby|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/status | ||
| 142 | |(% colspan="1" %)Povolené IP adresy|(% colspan="1" %)IP adresa VM nebo proxy. | ||
| 143 | |||
| 144 | == Reference == | ||
| 145 | |||
| 146 | * 07/2020 - Severočeská vědecká knihovna Ústí nad Labem (Comgate) | ||
| 147 | * 08/2020 - Knihovna Města Ostravy (Comgate) | ||
| 148 | * 09/2020 - Městská knihovna Třinec (Comgate) | ||
| 149 | * 10/2020 - Městská knihovna Klatovy (GoPay) | ||
| 150 | * 03/2021 - Městská knihovna Hodonín (Comgate) | ||
| 151 | * 04/2021 - Městská knihovna Jindřichův Hradec (Comgate) | ||
| 152 | * 05/2021 - Městská knihovna Jihlava (Comgate) |