Version 7.4 by Jiří Šilha on 2026/06/08 13:59

Hide last authors
Jiří Šilha 7.4 1
2
Jan Šimeček 2.1 3 {{toc/}}
Jan Šimeček 1.1 4
5 = Úvod =
6
7 Knihovní systém Tritius modul webový katalog umožňuje čtenářům provádět platby kartou za určité operace:
8
9 * Zaplacení poplatků (upomínky, pokuty apod.)
10 * Prodloužení registrace
11
12 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/]].
13
14 Knihovna uzavírá smlouvu přímo s poskytovatelem vybrané brány smlouvu,
15
16 Modul platební brána v katalogu systému Tritius se platí dle ceníku včetně následného update.
17
18 Knihovna má přístup do webového rozhraní, kde může nahlížet do vyučtování a zobrazit si detaily plateb.
19
20 = Platba za prodloužení registraci =
21
22 * Prodloužení registrace přes katalog musí být povoleno položkou nastavení: CATALOG_REGISTRATION_PROLONGATION_ENABLED
23 * Čtenáři se před koncem registrace v katalogu zobrazí upozornění na končící registraci.
24 ** Kdy se upozornění zobrazí lze korigovat nastavením: CATALOG_REGISTRATION_PROLONGATION_PERIOD
25 * Po kliknutí na notifikaci o končící registraci se zobrazí stránka s výpisem končících registrací
26 ** Registrací může být více na různých odděleních
27 ** Čtenář si kliknutím na tlačítko "Prodloužit registraci" může prodloužit jednotlivé registrace.
28 ** Po kliknutí na tlačítko "Prodloužit registraci" se čtenáři zobrazí stránka se souhrnem informací:
29 *** Od kdy nová registrace bude platit.
30 *** Do kdy bude nová registrace platit.
31 *** Na jakých odděleních registrace bude platit (včetně propojených odděleních).
32 *** Zaškrtávací políčko, že čtenář souhlasí s knihovním řádem (případně odkaz na knihovní řád).
33 *** Na konci stránky budou na výběr dvě možnosti:
34 **** Potvrdit a zaplatit - dojde k zobrazení platby kartou, čtenář zaplatí a registrace bude plně platná.
35 **** 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é.
36 * Po prvním příchodu do knihovny po prodloužení přes kartu se knihovnici zobrazí info (aby si mohla překontrolovat údaje).
37 * Seznam aktivních registrací si čtenář může také zobrazit z uživatelského menu pod odkazem "Moje registrace".
38
39 = Platba za dlužné poplatky =
40
41 * Ve čtenářském menu se zobrazuje celkový dluh čtenáře.
42 * Ve čtenářském menu se také u odkazu "Moje poplatky" zobrazuje počet aktuálně dlužných poplatků.
43 * Po kliknutí na celkovou částku se zobrazí seznam dlužných poplatků.
44 * 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.
45 * Catalog obsahuje nastavení **PAYMENT_GATE_MINIMAL_AMOUNT **udávající minimální částku možnou platit pomocí platební brány.
46
Jiří Šilha 7.3 47 = =
Jan Šimeček 1.1 48
49 = Platební brána Comgate =
50
51 Web: [[https:~~/~~/www.comgate.cz/cz>>url:https://www.comgate.cz/cz]]
52
53 [[Aktuální ceník: >>url:https://www.comgate.cz/cz]][[https:~~/~~/www.comgate.cz/cz/cena>>url:https://www.comgate.cz/cz/cena]]
54 [[Klientský portál: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/site/index>>url:https://portal.comgate.cz/cs/site/index]]
55 [[Dokumentace: >>url:https://www.comgate.cz/cz]][[https:~~/~~/portal.comgate.cz/cs/dokumentace>>url:https://portal.comgate.cz/cs/dokumentace]]
56
57 **Uzavření smlouvy: [[https:~~/~~/help.comgate.cz/docs/smlouva-online>>url:https://help.comgate.cz/docs/smlouva-online]]**
58
59
60 Články:
61
62 * Srovnání platebních bran: [[https:~~/~~/www.comgate.cz/cz/blog/srovnani-platebnich-bran>>url:https://www.comgate.cz/cz/blog/srovnani-platebnich-bran]]
63
64 == Platební podmínky ==
65
66 === **Jednorázové poplatky** ===
67
Petr Benda 3.1 68 (% class="table-bordered" %)
Jan Šimeček 1.1 69 |Zřízení platební brány|0,-
70 |(% colspan="1" %)Převod peněz na bankovní účet klienta denně|(% colspan="1" %)0,-
71 |(% colspan="1" %)EET v platební bráně|(% colspan="1" %)0,-
72 |(% colspan="1" %)Zrušení platební brány|(% colspan="1" %)0,-
73 |Refundace (vrácení peněžních prostředků Plátci na žádost Klienta)|2 Kč
74 |Chargeback (vynucené vrácení peněžních prostředků Plátci na základě stížnosti Plátce)|990 Kč
75
Jiří Šilha 7.3 76 === **Měsíční poplatky za správu a procentní poplatky z transakcí (informujte se o aktuálních cenách)** ===
Jan Šimeček 1.1 77
Petr Benda 3.1 78 (% class="table-bordered" %)
Jan Šimeček 1.1 79 |=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
80 |=Měsíční poplatek|149 Kč|(% colspan="1" %)99 Kč|(% colspan="1" %)0 Kč
81 |=(% colspan="1" %)Poplatek z transakce|(% colspan="1" %)0,99% + 0,- Kč|(% colspan="1" %)0,89% + 0,- Kč|(% colspan="1" %)0,79% + 0,- Kč
82
Jiří Šilha 7.3 83 === ===
Jan Šimeček 1.1 84
85 == Nastavení brány v Tritiu ==
86
87 Použití platební brány v katalogu je třeba povolit a nastavit.
88
Petr Benda 3.1 89 (% class="table-bordered" %)
Jan Šimeček 1.1 90 |=(((
91 Klíč
92 )))|=(((
93 Typ
94 )))|=(% colspan="1" %)(((
95 Popis
96 )))
97 |CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|Boolean|Povolení zobrazení stránky s platebními podmínkami
98 |CATALOG_SHOW_PRICE_LIST_PAGE|Boolean|Povolení zobrazení stránky s ceníkem
99 |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Povolení plateb kartou v katalogu
100 |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení registrace
Petr Benda 5.1 101 |(% 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 102 |(% colspan="1" %)(((
103 IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS
104 )))|(% colspan="1" %)Boolean|(% colspan="1" %)(((
Petr Benda 5.1 105 Povolení prodloužení prošlé registrace v katalogu
Petr Benda 4.1 106 )))
Jan Šimeček 1.1 107 |(% colspan="1" %)COMGATE_MERCHANT|(% colspan="1" %)String|(% colspan="1" %)(((
Petr Benda 5.1 108 Comgate identifikátor zákazníka
Jan Šimeček 1.1 109
110 //Obdržíte po podepsání smlouvy s Comgate.//
111 )))
112 |(% colspan="1" %)COMGATE_SECRET|(% colspan="1" %)String|(% colspan="1" %)(((
Petr Benda 5.1 113 Heslo
Jan Šimeček 1.1 114
115 //Obdržíte po podepsání smlouvy s Comgate.//
116 )))
117 |(% colspan="1" %)COMGATE_TEST|(% colspan="1" %)Boolean|(% colspan="1" %)(((
118 Příznak testovacího provozu. Je nutné mít přístup do testovacího režimu Comgate.
119 )))
120 |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT|(% colspan="1" %)Int|(% colspan="1" %)Minimální částka, kterou je možné zaplatit bránou. Defaultně 10 Kč.
121 |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)(((
122 Povolení plateb v katalogu. Ve výchozím stavu povolené. Jde nastavit až na samotného uživatele.
123
124 Vhodné například pro povolení jediného uživatele pro test platební brány.
125 )))
126
127 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]]
128
129 Při úpravě Html šablony je potřeba **zachovat defaultní strukturu tagů** a vlastní text zapsat mezi tyto tagy.
130
131 == Nastavení brány v Comgate ==
132
133 V nastavení platební brány Comgate je nutné nastavit UR adresy tak, aby směrovaly na Tritius. **Hlavní menu → Integrace → Nastavení obchodů.**
134
135 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]]
136
137
Petr Benda 3.1 138 (% class="table-bordered" %)
Jan Šimeček 1.1 139 |=Parametr|=Hodnota
140 |(% colspan="1" %)URL zaplacený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/paid?id=${id}&refId=${refId}
141 |(% colspan="1" %)URL zrušený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/canceled?id=${id}&refId=${refId}
142 |(% colspan="1" %)URL nevyřízený|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/pending?id=${id}&refId=${refId}
Petr Benda 7.1 143 |(% colspan="1" %)URL pro předání výsledku platby|(% colspan="1" %)https:~/~/x.tritius.cz/comgate/status
Jan Šimeček 1.1 144 |(% colspan="1" %)Povolené IP adresy|(% colspan="1" %)IP adresa VM nebo proxy.
145
Jiří Šilha 7.4 146 =
147 Platební brána GoPay =
148
149 == Podmínky GoPay ==
150
151 Společnost GoPay již bohužel nemá pro knihovny společné smluvní podmínky.
152
153 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.
154
155 == Registrace na GoPay ==
156
157 nejprve je potřeba se registrovat u společnosti GoPay  pomocí následujícího odkazu:
158
159 **[[https:~~/~~/registration.gopay.com/cs/signup-supplier/tritius>>url:https://registration.gopay.com/cs/signup-supplier/tritius]]**
160
161
162 Následuje formulář kde vyplníte kromě jiného i následujicí údaje:
163
164 [[image:1722590771235-512.png||height="211" width="507"]]
165
166
167 Zde uvedete adresu vlastního webového katalogu (nejčastěji: <jméno knihovny>.tritius.cz).
168
169 Nebudete zaškrtávat políčko neboť webová stránka je veřejně dostupná.
170
171 Prodávat budete:  registrace a placení dluhů čtenáři
172
173 == Nastavení brány v Tritiu ==
174
175 Použití platební brány v katalogu je třeba povolit a nastavit.
176
177 (% class="table-bordered" %)
178 |=(((
179 Klíč
180 )))|=(((
181 Typ
182 )))|=(% colspan="1" %)(((
183 Popis
184 )))
185 |(% colspan="1" %)CATALOG_SHOW_TERMS_AND_CONDITIONS_PAGE|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení zobrazení stránky s platebními podmínkami
186 |(% colspan="1" %)CATALOG_SHOW_PRICE_LIST_PAGE|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení zobrazení stránky s ceníkem
187 |CATALOG_CARD_PAYMENT_ENABLED|Boolean|(% colspan="1" %)Povolení plateb kartou v katalogu
188 |(% colspan="1" %)CATALOG_REGISTRATION_PROLONGATION_ENABLED|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení registrace
189 |(% 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í.
190 |(% colspan="1" %)IS_ENABLED_TO_PROLONG_EXPIRED_REGISTRATIONS|(% colspan="1" %)Boolean|(% colspan="1" %)Povolení prodloužení prošlé registrace v katalogu.
191 |(% colspan="1" %)GOPAY_URL|(% colspan="1" %)String|(% colspan="1" %)(((
192 URL adresa GoPay brány.
193
194 {{{https://gate.gopay.cz/api/}}}
195 )))
196 |(% colspan="1" %)GOPAY_ID|(% colspan="1" %)String|(% colspan="1" %)(((
197 GoPay ID zákazníka.
198
199 //Obdržíte po podepsání smlouvy s GoPay.//
200 )))
201 |(% colspan="1" %)GOPAY_CLIENT_ID|(% colspan="1" %)String|(% colspan="1" %)(((
202 GoPay klientké číslo pro API.
203
204 //Obdržíte po podepsání smlouvy s GoPay.//
205 )))
206 |(% colspan="1" %)GOPAY_SECRET_KEY|(% colspan="1" %)String|(% colspan="1" %)(((
207 GoPay heslo pro API.
208
209 //Obdržíte po podepsání smlouvy s GoPay.//
210 )))
211 |(% colspan="1" %)PAYMENT_GATE_MINIMAL_AMOUNT |(% colspan="1" %)Int|(% colspan="1" %)Minimální částka, kterou je možné zaplatit bránou. Defaultně 10 Kč.
212 |(% colspan="1" %)CATALOG_ENABLE_PAYMENTS|(% colspan="1" %)Boolean|(% colspan="1" %)(((
213 Povolení plateb v katalogu. Ve výchozím stavu povolené. Jde nastavit až na samotného uživatele.
214
215 Vhodné například pro povolení jediného uživatele pro test platební brány.
216 )))
217
218 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]]
219
220 Při úpravě Html šablony je potřeba **zachovat defaultní strukturu tagů** a vlastní text zapsat mezi tyto tagy.
221
222 Jako inspirace můžou posloužit knihovny, které již obchodní podmínky sepsaly:
223
224 * [[http:~~/~~/knih-kt.cz/VOP_GoPay_Tritius.php>>url:http://knih-kt.cz/VOP_GoPay_Tritius.php]]
225
226 == ==
227
Jan Šimeček 1.1 228 == Reference ==
229
230 * 07/2020 - Severočeská vědecká knihovna Ústí nad Labem (Comgate)
231 * 08/2020 - Knihovna Města Ostravy (Comgate)
232 * 09/2020 - Městská knihovna Třinec (Comgate)
233 * 10/2020 - Městská knihovna Klatovy (GoPay)
234 * 03/2021 - Městská knihovna Hodonín (Comgate)
235 * 04/2021 - Městská knihovna Jindřichův Hradec (Comgate)
236 * 05/2021 - Městská knihovna Jihlava (Comgate)