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