Skip to Content
Version 7.2 by Jiří Šilha on 2026/06/08 13:56
Hide last authors
Jan Šimeček 2.1 1 {{toc/}}
Jan Šimeček 1.1 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 = Platební brána GoPay =
46
47 == Podmínky GoPay ==
48
49 Společnost GoPay již bohužel nemá pro knihovny společné smluvní podmínky.
50
51 Smluvní podmínky se nově řeší individuálně s každou knihovnou, na základě dosaženého obratu se lze domluvit na výhodnějších podmínkách.
52
53 == Registrace na GoPay ==
54
55 nejprve je potřeba se registrovat u společnosti GoPay  pomocí následujícího odkazu:
56
57 **[[https:~~/~~/registration.gopay.com/cs/signup-supplier/tritius>>url:https://registration.gopay.com/cs/signup-supplier/tritius]]**
58
59
60 Následuje formulář kde vyplníte kromě jiného i následujicí údaje:
61
62 [[image:1722590771235-512.png||height="211" width="507"]]
63
64
65 Zde uvedete adresu vlastního webového katalogu (nejčastěji: <jméno knihovny>.tritius.cz).
66
67 Nebudete zaškrtávat políčko neboť webová stránka je veřejně dostupná.
68
69 Prodávat budete:  registrace a placení dluhů čtenáři
70
71 == Nastavení brány v Tritiu ==
72
73 Použití platební brány v katalogu je třeba povolit a nastavit.
74
Petr Benda 3.1 75 (% class="table-bordered" %)
Jan Šimeček 1.1 76 |=(((
77 Klíč
78 )))|=(((
79 Typ
80 )))|=(% colspan="1" %)(((
81 Popis
82 )))
83 |(% colspan="1" %)CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení zobrazení stránky s platebními podmínkami
84 |(% colspan="1" %)CATALOG_SHOW_PRICE_LIST_PAGE|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení zobrazení stránky s ceníkem
85 |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Povolení plateb kartou v katalogu
86 |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení registrace
Petr Benda 5.1 87 |(% 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í.
Petr Benda 4.1 88 |(% colspan="1" %)IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení prošlé registrace v katalogu.
Jan Šimeček 1.1 89 |(% colspan="1" %)GOPAY_URL|(% colspan="1" %)String|(% colspan="1" %)(((
90 URL adresa GoPay brány.
91
Petr Benda 5.1 92 {{{https://gate.gopay.cz/api/}}}
Jan Šimeček 1.1 93 )))
Petr Benda 5.1 94 |(% colspan="1" %)GOPAY_ID|(% colspan="1" %)String|(% colspan="1" %)(((
95 GoPay ID zákazníka.
96
Jan Šimeček 1.1 97 //Obdržíte po podepsání smlouvy s GoPay.//
Petr Benda 5.1 98 )))
99 |(% colspan="1" %)GOPAY_CLIENT_ID|(% colspan="1" %)String|(% colspan="1" %)(((
100 GoPay klientké číslo pro API.
101
Jan Šimeček 1.1 102 //Obdržíte po podepsání smlouvy s GoPay.//
Petr Benda 5.1 103 )))
104 |(% colspan="1" %)GOPAY_SECRET_KEY|(% colspan="1" %)String|(% colspan="1" %)(((
105 GoPay heslo pro API.
106
Jan Šimeček 1.1 107 //Obdržíte po podepsání smlouvy s GoPay.//
Petr Benda 5.1 108 )))
Jan Šimeček 1.1 109 |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT |(% colspan="1" %)Int|(% colspan="1" %)Minimální částka, kterou je možné zaplatit bránou. Defaultně 10 Kč.
110 |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)(((
111 Povolení plateb v katalogu. Ve výchozím stavu povolené. Jde nastavit až na samotného uživatele.
112
113 Vhodné například pro povolení jediného uživatele pro test platební brány.
114 )))
115
116 Platební brána GoPay 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:~~/~~/klatovy.tritius.cz/page/terms-and-conditions>>url:https://klatovy.tritius.cz/page/terms-and-conditions]]
117
118 Při úpravě Html šablony je potřeba **zachovat defaultní strukturu tagů** a vlastní text zapsat mezi tyto tagy.
119
120 Jako inspirace můžou posloužit knihovny, které již obchodní podmínky sepsaly:
121
122 * [[http:~~/~~/knih-kt.cz/VOP_GoPay_Tritius.php>>url:http://knih-kt.cz/VOP_GoPay_Tritius.php]]
123
124 = Platební brána Comgate =
125
126 Web: [[https:~~/~~/www.comgate.cz/cz>>url:https://www.comgate.cz/cz]]
127
128 [[Aktuální ceník: >>url:https://www.comgate.cz/cz]][[https:~~/~~/www.comgate.cz/cz/cena>>url:https://www.comgate.cz/cz/cena]]
129 [[Klientský portál: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/site/index>>url:https://portal.comgate.cz/cs/site/index]]
130 [[Dokumentace: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/dokumentace>>url:https://portal.comgate.cz/cs/dokumentace]]
131
132 **Uzavření smlouvy: [[https:~~/~~/help.comgate.cz/docs/smlouva-online>>url:https://help.comgate.cz/docs/smlouva-online]]**
133
134
135 Články:
136
137 * Srovnání platebních bran: [[https:~~/~~/www.comgate.cz/cz/blog/srovnani-platebnich-bran>>url:https://www.comgate.cz/cz/blog/srovnani-platebnich-bran]]
138 * Starší: [[https:~~/~~/www.kutac.cz/weby-a-vse-okolo/platebni-brana-comgate>>url:https://www.kutac.cz/weby-a-vse-okolo/platebni-brana-comgate]] (obsahuje neaktuální informace)
139
140 == Platební podmínky ==
141
142 === **Jednorázové poplatky** ===
143
Petr Benda 3.1 144 (% class="table-bordered" %)
Jan Šimeček 1.1 145 |Zřízení platební brány|0,-
146 |(% colspan="1" %)Převod peněz na bankovní účet klienta denně|(% colspan="1" %)0,-
147 |(% colspan="1" %)EET v platební bráně|(% colspan="1" %)0,-
148 |(% colspan="1" %)Zrušení platební brány|(% colspan="1" %)0,-
149 |Refundace (vrácení peněžních prostředků Plátci na žádost Klienta)|2 Kč
150 |Chargeback (vynucené vrácení peněžních prostředků Plátci na základě stížnosti Plátce)|990 Kč
151
Jiří Šilha 7.2 152 === **Měsíční poplatky za správu a procentní poplatky z transakcí (** ===
Jan Šimeček 1.1 153
Petr Benda 3.1 154 (% class="table-bordered" %)
Jan Šimeček 1.1 155 |=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
156 |=Měsíční poplatek|149 Kč|(% colspan="1" %)99 Kč|(% colspan="1" %)0 Kč
157 |=(% colspan="1" %)Poplatek z transakce|(% colspan="1" %)0,99% + 0,- Kč|(% colspan="1" %)0,89% + 0,- Kč|(% colspan="1" %)0,79% + 0,- Kč
158
159 === **Fixní poplatky z transakcí** ===
160
Petr Benda 3.1 161 (% class="table-bordered" %)
Jan Šimeček 1.1 162 |Platby kartou|0 Kč
163 |(% colspan="1" %)Platební tlačítka v České republic|(% colspan="1" %)0 Kč
164 |(% colspan="1" %)Platební tlačítka na Slovensku|(% colspan="1" %)0,2 EUR
165
166 == Nastavení brány v Tritiu ==
167
168 Použití platební brány v katalogu je třeba povolit a nastavit.
169
Petr Benda 3.1 170 (% class="table-bordered" %)
Jan Šimeček 1.1 171 |=(((
172 Klíč
173 )))|=(((
174 Typ
175 )))|=(% colspan="1" %)(((
176 Popis
177 )))
178 |CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|Boolean|Povolení zobrazení stránky s platebními podmínkami
179 |CATALOG_SHOW_PRICE_LIST_PAGE|Boolean|Povolení zobrazení stránky s ceníkem
180 |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Povolení plateb kartou v katalogu
181 |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení registrace
Petr Benda 5.1 182 |(% 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í.
Petr Benda 4.1 183 |(% colspan="1" %)(((
184 IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS
185 )))|(% colspan="1" %)Boolean|(% colspan="1" %)(((
Petr Benda 5.1 186 Povolení prodloužení prošlé registrace v katalogu
Petr Benda 4.1 187 )))
Jan Šimeček 1.1 188 |(% colspan="1" %)COMGATE_MERCHANT|(% colspan="1" %)String|(% colspan="1" %)(((
Petr Benda 5.1 189 Comgate identifikátor zákazníka
Jan Šimeček 1.1 190
191 //Obdržíte po podepsání smlouvy s Comgate.//
192 )))
193 |(% colspan="1" %)COMGATE_SECRET|(% colspan="1" %)String|(% colspan="1" %)(((
Petr Benda 5.1 194 Heslo
Jan Šimeček 1.1 195
196 //Obdržíte po podepsání smlouvy s Comgate.//
197 )))
198 |(% colspan="1" %)COMGATE_TEST|(% colspan="1" %)Boolean|(% colspan="1" %)(((
199 Příznak testovacího provozu. Je nutné mít přístup do testovacího režimu Comgate.
200 )))
201 |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT|(% colspan="1" %)Int|(% colspan="1" %)Minimální částka, kterou je možné zaplatit bránou. Defaultně 10 Kč.
202 |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)(((
203 Povolení plateb v katalogu. Ve výchozím stavu povolené. Jde nastavit až na samotného uživatele.
204
205 Vhodné například pro povolení jediného uživatele pro test platební brány.
206 )))
207
208 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]]
209
210 Při úpravě Html šablony je potřeba **zachovat defaultní strukturu tagů** a vlastní text zapsat mezi tyto tagy.
211
212 == Nastavení brány v Comgate ==
213
214 V nastavení platební brány Comgate je nutné nastavit UR adresy tak, aby směrovaly na Tritius. **Hlavní menu → Integrace → Nastavení obchodů.**
215
216 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]]
217
218
Petr Benda 3.1 219 (% class="table-bordered" %)
Jan Šimeček 1.1 220 |=Parametr|=Hodnota
221 |(% colspan="1" %)URL zaplacený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/paid?id=${id}&refId=${refId}
222 |(% colspan="1" %)URL zrušený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/canceled?id=${id}&refId=${refId}
223 |(% colspan="1" %)URL nevyřízený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/pending?id=${id}&refId=${refId}
Petr Benda 7.1 224 |(% colspan="1" %)URL pro předání výsledku platby|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/status
Jan Šimeček 1.1 225 |(% colspan="1" %)Povolené IP adresy|(% colspan="1" %)IP adresa VM nebo proxy.
226
227 == Reference ==
228
229 * 07/2020 - Severočeská vědecká knihovna Ústí nad Labem (Comgate)
230 * 08/2020 - Knihovna Města Ostravy (Comgate)
231 * 09/2020 - Městská knihovna Třinec (Comgate)
232 * 10/2020 - Městská knihovna Klatovy (GoPay)
233 * 03/2021 - Městská knihovna Hodonín (Comgate)
234 * 04/2021 - Městská knihovna Jindřichův Hradec (Comgate)
235 * 05/2021 - Městská knihovna Jihlava (Comgate)